Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
catatan
Bagian ini hanya berlaku untuk peringatan klasik. Untuk informasi selengkapnya, lihat Grafana memperingatkan.
Gunakan Preferences API untuk mendapatkan informasi tentang lansiran dasbor klasik dan statusnya. Namun, Anda tidak dapat menggunakan API ini untuk memodifikasi peringatan. Untuk membuat peringatan baru atau memodifikasinya, Anda perlu memperbarui dasbor JSON yang berisi peringatan.
catatan
Untuk menggunakan Grafana API dengan ruang kerja Grafana Amazon Managed, Anda harus memiliki token Grafana API yang valid. Anda menyertakan ini di Authorization bidang dalam permintaan API. Untuk informasi tentang cara membuat token untuk mengautentikasi panggilan API Anda, lihatOtentikasi dengan token.
Dapatkan peringatan
GET /api/alertsPermintaan contoh
GET /api/alerts HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbkParameter Querystring:
Parameter ini digunakan sebagai parameter querystring. Misalnya: /api/alerts?dashboardId=1
-
DashboardID — Batasi respons terhadap peringatan dalam nilai dasbor yang ditentukan. Anda dapat menentukan beberapa dasbor. Sebagai contoh,
dashboardId=23&dashboardId=35. -
PaneLid - Batasi respons untuk peringatan untuk panel tertentu di dasbor.
-
query — Batasi respons terhadap peringatan yang memiliki nama seperti nilai ini.
-
state — Kembalikan peringatan yang memiliki satu bijih lebih dari status peringatan berikut:
ALL,,alerting,ok,no_datapaused, ataupending. Untuk menentukan beberapa status, gunakan format berikut:?state=paused&state=alerting -
limit — Batasi respons terhadap jumlah peringatan X.
-
FolderId — Batasi respons terhadap peringatan dasbor di folder yang ditentukan. Anda dapat menentukan beberapa folder. Sebagai contoh,
folderId=23&folderId=35. -
DashboardQuery - Batasi respons terhadap peringatan yang memiliki nama dasbor seperti nilai ini.
-
DashboardTag — Batasi peringatan respons dasbor dengan tag tertentu. Untuk melakukan pemfilteran “AND” dengan beberapa tag, tentukan parameter tag beberapa kali. Misalnya,
dashboardTag=tag1&dashboardTag=tag2. Perhatikan bahwa ini adalah tag Grafana, bukan AWS tag.
Contoh respon
HTTP/1.1 200
Content-Type: application/json
[
{
"id": 1,
"dashboardId": 1,
"dashboardUId": "ABcdEFghij"
"dashboardSlug": "sensors",
"panelId": 1,
"name": "fire place sensor",
"state": "alerting",
"newStateDate": "2018-05-14T05:55:20+02:00",
"evalDate": "0001-01-01T00:00:00Z",
"evalData": null,
"executionError": "",
"url": "http://grafana.com/dashboard/db/sensors"
}
]Dapatkan peringatan dengan Id
GET /api/alerts/:idPermintaan contoh
GET /api/alerts/1 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbkContoh respon
HTTP/1.1 200
Content-Type: application/json
{
"id": 1,
"dashboardId": 1,
"dashboardUId": "ABcdEFghij"
"dashboardSlug": "sensors",
"panelId": 1,
"name": "fire place sensor",
"state": "alerting",
"message": "Someone is trying to break in through the fire place",
"newStateDate": "2018-05-14T05:55:20+02:00",
"evalDate": "0001-01-01T00:00:00Z",
"evalData": "evalMatches": [
{
"metric": "movement",
"tags": {
"name": "fireplace_chimney"
},
"value": 98.765
}
],
"executionError": "",
"url": "http://grafana.com/dashboard/db/sensors"
}penting
evalMatchesdata di-cache dalam database ketika dan hanya ketika keadaan peringatan berubah. Jika data dari satu server memicu peringatan terlebih dahulu dan, sebelum server itu terlihat meninggalkan status peringatan, server kedua juga memasuki status yang akan memicu peringatan, server kedua tidak terlihat dalam data. evalMatches
Jeda peringatan oleh Id
POST /api/alerts/:id/pausePermintaan contoh
POST /api/alerts/1/pause HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
"paused": true
}
Parameter :id kueri adalah Id dari peringatan yang akan dijeda atau tidak dijeda. pausedbisa true untuk menjeda peringatan atau false untuk membatalkan jeda peringatan.
Contoh respon
HTTP/1.1 200
Content-Type: application/json
{
"alertId": 1,
"state": "Paused",
"message": "alert paused"
}