Logo Aurabase
aurabasedocumenti
documenti›Edge Functions›Avvisi

Avvisi

Come sapere quando le tue funzioni si comportano in modo anomalo: i parametri che puoi guardare, come vengono controllate le regole e come gestirle su HTTP.

5 min letto·Livello intermedio·Revisionato il 12 ott 2026
Questo testo inglese è stato generato automaticamente dall'originale francese e non è stato ancora rivisto.
Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.
#
Crea

1. Crea una regola

Le regole di avviso sono gestite su HTTP con una chiave service_role. L'SDK non ha alcun metodo per loro.

terminalbash
curl -X POST "$AURA_URL/v1/functions/alerts" \
  -H "apikey: $AURA_SERVICE_ROLE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "High error rate",
    "metric": "error_rate",
    "condition": "gt",
    "threshold": 5,
    "channel": "email",
    "destination": "oncall@example.com"
  }'
responsejson
{
  "data": {
    "id": "3356d54a-ed32-49df-84bf-94ee64790c78",
    "name": "High error rate",
    "metric": "error_rate",
    "condition": "gt",
    "threshold": 5.0,
    "channel": "email",
    "destination": "oncall@example.com",
    "enabled": true,
    "last_triggered_at": null,
    "created_at": "2026-10-12T15:42:34.721256Z"
  },
  "meta": null
}
#
Riferimento

2. Metriche, condizioni e canali

CampoValori consentiti
metricerror_rate, latency_p95, job_failures, low_disk, ai_quota, anomaly_detection o log_pattern:<service>:<regex>
conditiongt, lt, eq, match, auto
channelemail, webhook, slack
thresholdUn numero
destinationUn indirizzo e-mail o l'URL del webhook o dell'hook Slack

log_pattern controlla i log di un servizio per un'espressione regolare: log_pattern:functions:timeout. Un valore sconosciuto restituisce 400 ed elenca quelli accettati. Risposta reale per metric: "cpu":

errortext
Requête invalide : Métrique inconnue: 'cpu'. Valeurs: error_rate, latency_p95, job_failures, low_disk, ai_quota, anomaly_detection, log_pattern:<service>:<regex>
#
Comportamento

3. Come vengono controllate le regole

  • Il servizio controlla ogni regola abilitata una volta al minuto.
  • Le metriche numeriche vengono lette da Prometeo; Le regole di log_pattern interrogano Loki. Ogni query ha un limite di 5 secondi. Se un progetto fallisce, gli altri vengono comunque controllati.
  • Quando viene attivata una regola, il servizio imposta last_triggered_at, registra un evento e lo pubblica per la consegna sul canale scelto.
  • Una regola disabilitata viene mantenuta ma non controllata.
La consegna dipende dalla distribuzione

Gli avvisi necessitano che Prometheus e Loki siano raggiungibili dal servizio delle funzioni e il canale di posta elettronica necessita di un provider di posta elettronica. Su uno stack di sviluppo senza di essi, una regola viene archiviata ma non può essere attivata.

#
Operare

4. Gestisci regole e cronologia

AzioneRichiesta
Elenco regoleGET /v1/functions/alerts
Abilita o disabilitaPATCH /v1/functions/alerts/{id} con {"enabled": false}
EliminaDELETE /v1/functions/alerts/{id}
Storia di una regolaGET /v1/functions/alerts/{id}/events
Storia di tutte le regoleGET /v1/functions/alerts/events

Un evento ha alert_rule_id, event_type, triggered_value, message e created_at; i percorsi storici accettano limit e offset. Ogni percorso necessita di una chiave service_role.

Ultimo aggiornamento · 12 ott 2026