OpenTelemetry指标上报地址使用说明

使用说明

• 目前仅支持V1版本的Prometheus实例。

• 目前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
  	华南1（深圳）	cn-shenzhen
  	华南2（河源）	cn-heyuan
  	华南3（广州）	cn-guangzhou
  	华北1（青岛）	cn-qingdao
  	华北2（北京）	cn-beijing
  	华北3（张家口）	cn-zhangjiakou
  	华北5（呼和浩特）	cn-huhehaote
  	华北6（乌兰察布）	cn-wulanchabu
  	西南1（成都）	cn-chengdu
  	中国香港	cn-hongkong
  其他国家和地区	新加坡（新加坡）	ap-southeast-1

步骤一：获取OpenTelemetry地址

1. 登录云监控控制台，在左侧导航栏选择Prometheus 监控 > 实例列表，进入实例列表页面。

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

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

   公网地址格式为 https://cn-hangzhou.arms.aliyuncs.com/opentelemetry/xxx/api/v1/metrics，内网地址格式为 http://cn-hangzhou-intranet.arms.aliyuncs.com/opentelemetry/xxx/api/v1/metrics，其中路径中含鉴权 token 等参数，请直接从控制台复制完整地址。

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

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

其他参数配置说明如下：

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

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

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

步骤三：查看监控数据

1. 登录云监控控制台，在左侧导航栏选择Prometheus 监控 > 实例列表，进入实例列表页面。

2. 单击目标实例名称。

3. 单击指标管理，在指标探索页签中输入包含指标的PromQL，即可查询到上报的数据。