Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
API di avviso
Nota
Questa sezione si applica solo agli avvisi classici. Per ulteriori informazioni, consulta Avvisi Grafana.
Utilizza l'API Preferences per ottenere informazioni sugli avvisi classici della dashboard e sui relativi stati. Tuttavia, non puoi utilizzare questa API per modificare l'avviso. Per creare nuovi avvisi o modificarli è necessario aggiornare il dashboard JSON che contiene gli avvisi.
Nota
Per utilizzare un'API Grafana con il tuo spazio di lavoro Amazon Managed Grafana, devi disporre di un token API Grafana valido. Lo includi nel Authorization
campo della richiesta API. Per informazioni su come creare un token per autenticare le chiamate API, consultaAutenticazione con token.
Ricevi avvisi
GET /api/alerts
Richiesta di esempio
GET /api/alerts HTTP/1.1 Accept: application/json Content-Type: application/json Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
Parametri Querystring:
Questi parametri vengono utilizzati come parametri di querystring. Ad esempio: /api/alerts?dashboardId=1
-
dashboardID: limita le risposte agli avvisi nel valore di dashboard specificato. È possibile specificare più dashboard. Ad esempio,
dashboardId=23&dashboardId=35
-
PanelID: limita la risposta agli avvisi per un pannello specifico su una dashboard.
-
query: limita la risposta agli avvisi con un nome simile a questo valore.
-
state: restituisce gli avvisi che hanno uno o più dei seguenti stati di avviso:
ALL
,,alerting
,ok
no_data
paused
, o.pending
Per specificare più stati, utilizzate il seguente formato:?state=paused&state=alerting
-
limit: limita la risposta a un numero X di avvisi.
-
FolderID: limita la risposta agli avvisi dei dashboard nelle cartelle specificate. È possibile specificare più cartelle. Ad esempio,
folderId=23&folderId=35
-
DashboardQuery: limita le risposte agli avvisi con un nome di dashboard simile a questo valore.
-
DashboardTag: limita gli avvisi di risposta dei dashboard con tag specificati. Per filtrare «AND» con più tag, specifica il parametro tags più volte. Ad esempio,
dashboardTag=tag1&dashboardTag=tag2
. Nota che questi sono tag Grafana, non AWS tag.
Example response
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" } ]
Ricevi un avviso tramite ID
GET /api/alerts/:id
Richiesta di esempio
GET /api/alerts/1 HTTP/1.1 Accept: application/json Content-Type: application/json Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
Example response
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" }
Importante
evalMatches
i dati vengono memorizzati nella cache del database quando e solo quando lo stato dell'avviso cambia. Se i dati di un server attivano per primi l'avviso e, prima che il server esca dallo stato di avviso, anche un secondo server entra in uno stato tale da attivare l'avviso, il secondo server non è visibile nei dati. evalMatches
Metti in pausa l'avviso per ID
POST /api/alerts/:id/pause
Richiesta di esempio
POST /api/alerts/1/pause HTTP/1.1 Accept: application/json Content-Type: application/json Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk { "paused": true }
Il parametro di :id
interrogazione è l'ID dell'avviso da mettere in pausa o non mettere in pausa. paused
può essere true
quello di sospendere un avviso o di false
riattivare l'avviso.
Example response
HTTP/1.1 200 Content-Type: application/json { "alertId": 1, "state": "Paused", "message": "alert paused" }