文档

OpenTelemetry指标上报地址使用说明

更新时间:

可观测监控 Prometheus 版提供了OpenTelemetry地址,以便于您将应用的OpenTelemetry指标接入阿里云Prometheus,并通过Grafana获取监控数据,从而更好地监控和管理应用程序的性能和健康状态。

使用说明

  • 目前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. 登录ARMS控制台

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

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

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

    image.png

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

以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。

说明

以上参数配置的具体操作,请参考示例Demo

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

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

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

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

    重要

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