全部產品
Search
文件中心

Application Real-Time Monitoring Service:OpenTelemetry指標上報地址使用說明

更新時間:Jul 23, 2024

可觀測監控 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執行個體名稱。