OpenTelemetry指标上报地址使用说明

使用说明

• 目前OpenTelemetry指标仅支持通过HTTP上报，暂不支持使用gRPC。

• 使用HTTP进行数据上报时，Content-Encoding头字段支持默认的application/protobuf序列化方式，暂时不支持使用application/json序列化方式。

• OpenTelemetry指标模型与Prometheus指标模型转化的映射关系如下：

  OpenTelemetry	Prometheus
  Sum(monotonic & cumulative)	Counter
  Sum(monotonic & delta)	Gauge
  Sum(none-monotonic & cumulative)	Gauge
  Gauge	Gauge
  Histogram(cumulative)	Histogram
  Histogram(delta)	不支持
  Exponential Histogram	不支持
  Summary	Summary

• 支持地域：

  地区	地域名称	地域ID
  中国地区	华东1（杭州）	cn-hangzhou
  	华东2（上海）	cn-shanghai
  	华北2（北京）	cn-beijing
  	华南1（深圳）	cn-shenzhen
  	华北1（青岛）	cn-qingdao
  	华北3（张家口）	cn-zhangjiakou
  	中国香港	cn-hongkong
  其他国家和地区	新加坡（新加坡）	ap-southeast-1

步骤一：获取OpenTelemetry地址

1. 登录ARMS控制台。

2. 在左侧导航栏选择Prometheus监控 > 实例列表，进入可观测监控 Prometheus 版的实例列表页面。

3. 在页面顶部选择Prometheus实例所在的地域，并在目标Prometheus实例右侧的操作列单击设置。

4. 在设置页签上，根据需求复制公网或内网的OpenTelemetry地址。

   

步骤二：修改应用程序的上报地址

以Java为例，需要在OtlpHttpMetricExporterBuilder中修改Endpoint参数，将其替换为上文步骤一获取的OpenTelemetry地址，即可将应用的OpenTelemetry指标接入阿里云Prometheus。具体操作请参考示例Demo。

其他参数配置说明如下：

• OpenTelemetry相关客户端默认没有开启压缩，建议设置Compression参数为gzip，减少网络传输消耗。

• OpenTelemetry指标上报阿里云Prometheus，若需要针对所有的指标加上前缀，可以添加一组Header，设置metricNamespace。

• OpenTelemetry指标上报到阿里云Prometheus后，所有的指标默认会带上OpenTelemetry Scope Label，可以添加一组Header，设置skipGlobalLabel=true，以便阿里云Prometheus在处理接收到的指标时不添加默认的Scope Label。

步骤三：Grafana中查看监控数据

1. 登录ARMS控制台，在左侧导航栏选择Grafana服务 > 工作区管理。

2. 在工作区管理页面，单击Grafana 共享版，然后选择对应的公网地址单击登录。

3. 在左侧导航栏单击图标，然后在Explore右侧选择对应的Datasource。

   重要

   这里Datasource需选择当前接入了OpenTelemetry指标的Prometheus实例名称。