[TOC] > [更多詳情](https://prometheus.io/docs/prometheus/latest/querying/api/) ## HTTP API 通過第三方(如:Grafana)調用 prometheus api 獲取prometheus信息 ### 格式概述 API響應格式為JSON ``` 2xx 請求成功 400 Bad Request 參數丟失或不正確時。 422 Unprocessable Entity無法執行表達式時（RFC4918）。 503 Service Unavailable 查詢超時或中止時。 ``` json 格式 ``` { "status": "success" | "error", "data": <data>, // Only set if status is "error". The data field may still hold // additional data. "errorType": "<string>", "error": "<string>", // Only if there were warnings while executing the request. // There will still be data in the data field. "warnings": ["<string>"] } ``` ### 表達式查詢 #### 時間點 ``` GET /api/v1/query POST /api/v1/query ``` * `query=<string>`：Prometheus表達式查詢字符串。 * `time=<rfc3339 | unix_timestamp>`：評估時間戳記。可選的,省略表示當前時間。 * `timeout=<duration>`：評估超時。可選的。默認為，并以該`-query.timeout`標志的值為上限 如: ``` curl http://localhost:9090/api/v1/query?query=node_disk_io_now ``` #### 時間段 ``` GET /api/v1/query_range POST /api/v1/query_range ``` * `query=<string>`：Prometheus表達式查詢字符串。 * `start=<rfc3339 | unix_timestamp>`：開始時間戳。 * `end=<rfc3339 | unix_timestamp>`：結束時間戳記。 * `step=<duration | float>`：以`duration`格式或浮點秒數查詢分辨率步長。 * `timeout=<duration>`：評估超時。可選的。默認為，并以該`-query.timeout`標志的值為上限 如: ``` curl 'http://localhost:9090/api/v1/query_range?query=up&start=2015-07-01T20:10:30.781Z&end=2015-07-01T20:11:00.781Z&step=15s' ```