OpenTelemetry指标上报地址使用说明

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

使用说明

  • 目前仅支持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

前提条件

已创建Prometheus实例,具体操作,请参见:

步骤一:获取OpenTelemetry地址

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

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

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

    image.png

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

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。

说明

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

步骤三:查看监控数据

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

  2. 单击目标实例名称。

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