[TOC] ## 數據模型 用于把當前需要輸出的數據以 Prometheus 的格式輸出 ### 數據樣本 數據樣本構成實際的時間序列數據。每個數據樣本包括： - 64 位浮點型數值 - 毫秒精度的時間戳 ### 表示方式 格式 ``` <metric name>{<label name>=<label value>, ...} ``` 示例 ``` api_http_requests_total{method="POST", handler="/messages"} //or upantbiz_server_cpu{server="UpOrgServer"} 0.000479 ``` ### 基礎單位 | Family | Base unit | Remark | | --- | --- | --- | | 時間 | seconds | | | 熱度| celsius | 出于實際原因，優選攝氏度而不是開爾文。在特殊情況下，例如色溫或溫度必須是絕對的情況下，開爾文可以作為基本單位。| | 長度 | meters | | | 字節(Bytes)| bytes | | | 比特(Bits) | bytes | 為了避免混淆不同的度量，總是使用字節，即使比特看起來更常見。 | | 百分比| ratio | 值為0-1（而不是0-100）。ratio僅用作disk_use_ratio等名稱的后綴。通常的度量名稱遵循模式A_per_B。| | 電壓| volts | | | 電流 | amperes | | | 能量| joules | | | 力| | 優先導出焦耳計數器，然后rate(joules[5m])以瓦特為單位給出功率。 | | 重量 | grams(克) | 為避免千克前綴出現問題，應優先使用克而不是千克。 | ## 最佳實踐 ### 指標名稱 #### 應該有一個與指標所屬域相關的（單詞）應用程序前綴 ``` prometheus_notifications_total （特定于 Prometheus 服務器） process_cpu_seconds_total （許多客戶端庫都導出） http_request_duration_seconds （針對所有 HTTP 請求） ``` #### 應使用基本單位（例如秒、字節、米 - 而不是毫秒、兆字節、公里） #### 應有一個描述單位的后綴，以復數形式表示。 `total`如果適用，累積計數除了單位外，還具有后綴。 ``` http_request_duration_seconds node_memory_usage_bytes http_requests_total （用于無單位累計計數） process_cpu_seconds_total （用于有單位的累計計數） foobar_build_info（用于提供有關正在運行的二進制文件的元數據 的偽指標） data_pipeline_last_record_processed_timestamp_seconds （用于跟蹤數據處理管道中處理的最新記錄的時間的時間戳） ``` ### 標簽 #### 使用標簽來區分被測量事物的特征： ``` api_http_requests_total- 區分請求類型：operation="create|update|delete" api_request_duration_seconds- 區分請求階段：stage="extract|transform|load" ``` >[warning] 注意：請記住，每個唯一的鍵值標簽對組合都代表一個新的時間序列，這會大大增加存儲的數據量。請勿使用標簽來存儲基數較高的維度（許多不同的標簽值），例如用戶 ID、電子郵件地址或其他無界值集。