菜单
文档breadcrumb arrow Grafana Mimirbreadcrumb arrow 管理breadcrumb arrow 使用 Exemplarbreadcrumb arrow 开始之前
开源

在开始使用 Grafana Mimir 中的 Exemplar 之前

遵循清单以确保您的应用程序正在生成指标、追踪和 Exemplar。

  • 验证您的应用程序是否使用了官方 Prometheus 客户端库。
  • 请参考您选择的客户端库文档，确保它以 OpenMetrics 格式发出指标。例如，对于 Prometheus Go 客户端库，这需要您设置 EnableOpenMetrics 为 true。对于 Java 库，请遵循 其说明 设置正确的头格式。
  • 获取当前请求的追踪 ID，并在发出指标的调用中包含该追踪 ID。
    • 对于直方图，使用 ObserveWithExemplar 方法发出追踪 ID 以及直方图的值。这些函数来自 Go 库，但在其他库中可以找到类似的函数。
    • 对于计数器，使用 AddWithExemplar 方法发出追踪 ID 以及计数器增量。
  • 通过在 shell 中运行以下命令验证是否正在生成带有 Exemplar 的指标：curl -H "Accept: application/openmetrics-text" http://<your application>/metrics | grep -i "traceid"。
  • 配置您的 Prometheus 服务器或 Grafana Agent 来存储和发送 Exemplar。
    • 配置 Grafana Agent 发送 Exemplar
      1. 通过验证 prometheus_remote_storage_exemplars_total 指标值不为零，确认 Agent 正在抓取 Exemplar。
      2. 在 Grafana Agent 配置文件的 remote_write 配置块下添加选项 send_exemplars: true。
    • 配置 Prometheus 服务器发送 Exemplar
      1. 使用 --enable-feature=exemplar-storage 标志运行 Prometheus。
      2. 通过验证 prometheus_remote_storage_exemplars_total 指标值不为零，确认 Prometheus 正在抓取 Exemplar。
      3. 在 Prometheus 配置文件的 remote_write 配置块下添加选项 send_exemplars: true。

另请参阅