上传自定义指标 | 大装置帮助中心
跳到主要内容

上传自定义指标

当内置云产品指标无法覆盖业务需求时，可以创建监控仓库，并使用 OpenTelemetry SDK 上报自定义指标。

前提条件​

  1. 在自定义监控 > 监控仓库中创建监控仓库。
  2. 在目标仓库操作列单击数据推送，复制控制台展示的接入点（Endpoint）和访问令牌。
  3. 准备可以访问接入点的运行环境，并安装适合所用语言的 OpenTelemetry 指标 SDK。

接入点与令牌属于敏感信息。请从控制台的数据推送页面复制，不要在代码仓库或文档中保存真实值。

配置接入信息​

以下示例使用占位符，请替换为控制台数据推送页面提供的实际值：

export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="${METRICS_ENDPOINT}"
export OTEL_EXPORTER_OTLP_METRICS_HEADERS="Authorization=Bearer ${ACCESS_TOKEN}"

上报与验证​

  1. 在应用中初始化 OpenTelemetry Meter Provider 和 OTLP HTTP 指标导出器。
  2. 创建计数器、直方图或其他指标，并为指标添加便于筛选的业务标签。
  3. 启动应用并产生指标数据。
  4. 返回自定义监控 > 监控图表，选择目标监控仓库。
  5. 输入指标查询表达式并单击查询，确认图表中出现数据。

如果查询不到数据，请检查接入点是否与监控仓库匹配，并确认访问令牌、网络连通性、指标名称、标签以及查询时间范围。

监控仓库的创建、数据推送和查询方法请参见自定义监控。