API di avviso - Grafana gestito da Amazon

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_datapaused, 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

evalMatchesi 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. pausedpuò 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" }