OpenTelemetry指標(biāo)上報(bào)地址使用說明
可觀測(cè)監(jiān)控 Prometheus 版提供了OpenTelemetry地址,以便于您將應(yīng)用的OpenTelemetry指標(biāo)接入阿里云Prometheus,并通過Grafana獲取監(jiān)控?cái)?shù)據(jù),從而更好地監(jiān)控和管理應(yīng)用程序的性能和健康狀態(tài)。
使用說明
目前OpenTelemetry指標(biāo)僅支持通過HTTP上報(bào),暫不支持使用gRPC。
使用HTTP進(jìn)行數(shù)據(jù)上報(bào)時(shí),Content-Encoding頭字段支持默認(rèn)的application/protobuf序列化方式,暫時(shí)不支持使用application/json序列化方式。
OpenTelemetry指標(biāo)模型與Prometheus指標(biāo)模型轉(zhuǎn)化的映射關(guān)系如下:
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
支持地域:
地區(qū)
地域名稱
地域ID
中國(guó)地區(qū)
華東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
中國(guó)香港
cn-hongkong
其他國(guó)家和地區(qū)
新加坡(新加坡)
ap-southeast-1
前提條件
已創(chuàng)建Prometheus實(shí)例,具體操作,請(qǐng)參見:
步驟一:獲取OpenTelemetry地址
登錄ARMS控制臺(tái)。
在左側(cè)導(dǎo)航欄單擊實(shí)例列表,進(jìn)入可觀測(cè)監(jiān)控 Prometheus 版的實(shí)例列表頁(yè)面。
在頁(yè)面頂部選擇Prometheus實(shí)例所在的地域,并在目標(biāo)Prometheus實(shí)例右側(cè)的操作列單擊設(shè)置。
在設(shè)置頁(yè)簽上,根據(jù)需求復(fù)制公網(wǎng)或內(nèi)網(wǎng)的OpenTelemetry地址。
步驟二:修改應(yīng)用程序的上報(bào)地址
以Java為例,需要在OtlpHttpMetricExporterBuilder中修改Endpoint參數(shù),將其替換為上文步驟一獲取的OpenTelemetry地址,即可將應(yīng)用的OpenTelemetry指標(biāo)接入阿里云Prometheus。具體操作請(qǐng)參考示例Demo。
其他參數(shù)配置說明如下:
OpenTelemetry相關(guān)客戶端默認(rèn)沒有開啟壓縮,建議設(shè)置
Compression
參數(shù)為gzip
,減少網(wǎng)絡(luò)傳輸消耗。OpenTelemetry指標(biāo)上報(bào)阿里云Prometheus,若需要針對(duì)所有的指標(biāo)加上前綴,可以添加一組Header,設(shè)置
metricNamespace
。OpenTelemetry指標(biāo)上報(bào)到阿里云Prometheus后,所有的指標(biāo)默認(rèn)會(huì)帶上OpenTelemetry Scope Label,可以添加一組
Header
,設(shè)置skipGlobalLabel=true
,以便阿里云Prometheus在處理接收到的指標(biāo)時(shí)不添加默認(rèn)的Scope Label。
以上參數(shù)配置的具體操作,請(qǐng)參考示例Demo。
步驟三:Grafana中查看監(jiān)控?cái)?shù)據(jù)
在工作區(qū)管理頁(yè)面,單擊Grafana 共享版,然后選擇對(duì)應(yīng)的公網(wǎng)地址單擊登錄。
在左側(cè)導(dǎo)航欄單擊圖標(biāo),然后在Explore右側(cè)選擇對(duì)應(yīng)的Datasource。
重要這里Datasource需選擇當(dāng)前接入了OpenTelemetry指標(biāo)的Prometheus實(shí)例名稱。