您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info
使用 /metrics/events API 取得機構在指定時間間隔內的所有事件。事件清單包含 Edge 偵測到的所有警示。
根據預設，API 會傳回前一小時的所有事件。使用 from 和 to 查詢參數指定不同的時間長度。from 和 to 查詢參數值支援下列格式：
now(目前的當地時間)-<value><unit>可指定過去的時間 (請注意開頭的連字號)：<value>：整數<unit>– 時間單位：s, sec, second, m, min, minute, h, hr, hour, d, day
- 日期採用 ISO 格式，格式如下：
yyyy-mm-ddThh:mm:ssZyyyy-mm-ddThh:mm:ss+00:00
例如：
now- -
1h -10min2019-05-13T14:04:00+00:00
只有 org 查詢參數是必要參數。下列 API 呼叫會傳回機構 myorg 在過去 12 小時內的所有事件：
curl -H "Authorization: Bearer $ACCESS_TOKEN" \ "https://apimonitoring.enterprise.apigee.com/metrics/events?org=myorg&from=-12h&to=now"
依照「取得 OAuth 2.0 存取權杖」一節所述，將 $ACCESS_TOKEN 設為 OAuth 2.0 存取權杖。如要瞭解本範例中使用的 curl 選項，請參閱「使用 curl」。
這個 API 支援下列選用查詢參數：
| 名稱 | 說明 | 預設 |
|---|---|---|
from
|
快訊擷取作業的開始時間間隔。預設值是目前時間減去一小時。請參閱上述說明，瞭解如何設定這個參數。 | -1 小時 |
to
|
快訊應擷取的時間間隔結束時間。預設值為目前時間。請參閱上述說明，瞭解如何設定這個參數。 | 目前 |
alertId
|
依指定的警報定義 ID 篩選警報記錄結果。 | 所有快訊 ID |
env
|
依指定環境篩選事件。 | 所有環境 |
name
|
依指定的警示名稱篩選事件。 | 所有快訊名稱 |
region
|
依指定區域篩選事件。 | 所有區域 |
type
|
依指定類型篩選事件：alert。 |
所有類型 |