> For the complete documentation index, see [llms.txt](https://song-jia-yang.gitbook.io/prometheus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://song-jia-yang.gitbook.io/prometheus/exporter/sample.md).

# Sample Exporter

既然一个 exporter 就是将收集的数据转化为文本格式，并提供 http 请求即可，那很容自己实现一个。

## 一个简单的 exporter

下面我将用 `golang` 实现一个简单的 `sample_exporter`, 其代码大致为：

```go
package main

import (
    "fmt"
    "net/http"
)

func handler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, exportData)
}

func main() {
    http.HandleFunc("/", handler)
    http.ListenAndServe(":8080", nil)
}

var exportData string = `# HELP sample_http_requests_total The total number of HTTP requests.
# TYPE sample_http_requests_total counter
sample_http_requests_total{method="post",code="200"} 1027 1395066363000
sample_http_requests_total{method="post",code="400"}    3 1395066363000

# Escaping in label values:
sample_msdos_file_access_time_seconds{path="C:\\DIR\\FILE.TXT",error="Cannot find file:\n\"FILE.TXT\""} 1.458255915e9

# Minimalistic line:
sample_metric_without_timestamp_and_labels 12.47

# A histogram, which has a pretty complex representation in the text format:
# HELP sample_http_request_duration_seconds A histogram of the request duration.
# TYPE sample_http_request_duration_seconds histogram
sample_http_request_duration_seconds_bucket{le="0.05"} 24054
sample_http_request_duration_seconds_bucket{le="0.1"} 33444
sample_http_request_duration_seconds_bucket{le="0.2"} 100392
sample_http_request_duration_seconds_bucket{le="0.5"} 129389
sample_http_request_duration_seconds_bucket{le="1"} 133988
sample_http_request_duration_seconds_bucket{le="+Inf"} 144320
sample_http_request_duration_seconds_sum 53423
sample_http_request_duration_seconds_count 144320

# Finally a summary, which has a complex representation, too:
# HELP sample_rpc_duration_seconds A summary of the RPC duration in seconds.
# TYPE sample_rpc_duration_seconds summary
sample_rpc_duration_seconds{quantile="0.01"} 3102
sample_rpc_duration_seconds{quantile="0.05"} 3272
sample_rpc_duration_seconds{quantile="0.5"} 4773
sample_rpc_duration_seconds{quantile="0.9"} 9001
sample_rpc_duration_seconds{quantile="0.99"} 76656
sample_rpc_duration_seconds_sum 1.7560473e+07
sample_rpc_duration_seconds_count 2693
`
```

当运行此程序，你访问 `http://localhost:8080/metrics`, 将看到这样的页面：

![simple exporter data](https://962234814-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M8oPJUWJoRcTOnREKHd%2Fsync%2F762b0b736efeb9c6f7abbb219702ffa574718f2f.png?generation=1591091030100811\&alt=media)

## 与 Prometheus 集成

我们可以利用 Prometheus 的 static\_configs 来收集 `sample_exporter` 的数据。

打开 `prometheus.yml` 文件, 在 `scrape_configs` 中添加如下配置：

```
- job_name: "sample"
    static_configs:
      - targets: ["127.0.0.1:8080"]
```

重启加载配置，然后到 Prometheus Console 查询，你会看到 `simple_exporter` 的数据。

![simple exporter](https://962234814-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M8oPJUWJoRcTOnREKHd%2Fsync%2Ff4561d6a1a7222b4cd789997d3c7b89559d18f1b.png?generation=1591091030178647\&alt=media)