Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Utilizza un avviso sul traffico per generare una notifica quando il traffico per un ambiente, un proxy o una regione cambia di una determinata percentuale in un intervallo di tempo.
Puoi impostare l'intervallo di tempo su:
- 1 ora
- 1 giorno
- 7 giorni
- 15 giorni (solo API)
- 30 giorni (solo API)
L'avviso confronta il traffico dell'intervallo di tempo attuale con quello dell'intervallo di tempo precedente. Ad esempio, specifichi un intervallo di tempo di un'ora. L'avviso confronta quindi il traffico dell'ora più recente con quello dell'ora precedente per calcolare la variazione percentuale del traffico:
percentChange = ((currentTraffic - previousTraffic) / previousTraffic) * 100
Un valore positivo indica che il traffico è aumentato, mentre un valore negativo indica che il traffico è diminuito.
Puoi quindi impostare la soglia che attiva un avviso sul traffico sotto forma di aumento o diminuzione percentuale del traffico API per il periodo di tempo specificato.
Prima di impostare questa percentuale, assicurati che sia in linea con i normali modelli di traffico. Ad esempio, se il traffico delle API solitamente fluttua durante la giornata con picchi di traffico orari che possono arrivare fino al 100% in determinati momenti di picco, questi picchi sono normali e non dovrebbero attivare un avviso. Tuttavia, se configuri un avviso da attivare per qualsiasi aumento del 50% del traffico orario, riceverai avvisi non necessari per il traffico normale.
Per saperne di più sugli avvisi, vedi Configurare avvisi e notifiche.
Aggiungi avvisi sul traffico e notifiche
Per aggiungere avvisi sul traffico e notifiche:- Fai clic su Analizza > Regole avviso nell'interfaccia utente Edge.
- Fai clic su +Avviso.
- Inserisci le seguenti informazioni generali sull'avviso:
Campo Descrizione Nome dell'avviso Nome dell'avviso. Utilizza un nome che descriva l'attivatore e che sia significativo per te. Il nome non può superare i 128 caratteri. Descrizione Descrizione dell'avviso. Tipo di avviso: Seleziona Traffico totale. Per saperne di più, consulta Informazioni sui tipi di avvisi. Ambiente Seleziona l'ambiente dall'elenco a discesa. Stato Attiva/disattiva per abilitare o disabilitare l'avviso. - Definisci la soglia e la dimensione per la condizione che attiverà l'avviso.
Campo Condizione Descrizione Soglia Specifica di aumentare l'avviso quando il traffico è aumentato o diminuito di una percentuale specifica rispetto a un intervallo di tempo precedente.
Imposta la percentuale di aumentato del su un valore maggiore o uguale a 0%. Imposta la percentuale diminuita del su un valore maggiore o uguale a 0% e minore o uguale al 100%.
Puoi scegliere un intervallo di tempo pari a:
- 1 ora
- 1 giorno
- 1 settimana
Dimensione Fai clic su + Aggiungi dimensione e specifica i dettagli della dimensione per cui restituire i risultati, inclusi il proxy API e la regione.
Imposta una dimensione specifica su:
- Proxy: impostalo su un proxy specifico o su Tutti i proxy. Proxy non supporta il valore "Any". In alternativa, puoi aggiungere un avviso separato per ogni proxy che ti interessa.
- Regione: imposta questa opzione su una regione specifica o su Tutte le regioni. Regione non supporta il valore "Qualsiasi". Puoi invece aggiungere un avviso separato per ogni regione che ti interessa.
- Fai clic su + Notifica per aggiungere una notifica di avviso.
Dettagli notifica Descrizione Canale Seleziona il canale di notifica che vuoi utilizzare e specifica la destinazione: Email, Slack, PagerDuty o webhook. Destinazione Specifica la destinazione in base al tipo di canale selezionato: - Email - Indirizzo email, ad esempio
joe@company.com
- Slack - URL del canale Slack, ad esempio
https://hooks.slack.com/services/T00000000/B00000000/XXXXX
- PagerDuty - Codice PagerDuty, ad esempio
abcd1234efgh56789
- Webhook - URL webhook, ad esempio
https://apigee.com/test-webhook
Nota: puoi specificare una sola destinazione per notifica. Per specificare più destinazioni per lo stesso tipo di canale, aggiungi altre notifiche.
- Email - Indirizzo email, ad esempio
- Per aggiungere altre notifiche, ripeti il passaggio precedente.
- Se hai aggiunto una notifica, imposta i seguenti campi:
Campo Descrizione Playbook (Facoltativo) Campo di testo in formato libero per fornire una breve descrizione delle azioni consigliate per risolvere gli avvisi quando vengono attivati. Puoi anche specificare un link alla tua pagina wiki interna o della tua community in cui fare riferimento alle best practice. Le informazioni in questo campo verranno incluse nella notifica. Il contenuto di questo campo non può superare i 1500 caratteri. Limitazione Frequenza con cui inviare notifiche. Seleziona un valore dall'elenco a discesa. - Fai clic su Salva.
Visualizzare gli avvisi nella dashboard Eventi
Quando Edge rileva una condizione di avviso, la registra automaticamente nella dashboard Eventi nell'interfaccia utente perimetrale. L'elenco degli eventi visualizzati nella dashboard Eventi include tutti gli avvisi, fissi e certificati.
Per visualizzare un avviso:
Fai clic su Analizza > Eventi nell'interfaccia utente Edge. Viene visualizzata la nuova dashboard Eventi:
Filtra la dashboard Eventi per:
- Ambiente
- Regione
- Periodo di tempo
- Seleziona una riga nella dashboard Eventi per visualizzare l'archivio chiavi contenente il certificato in scadenza al fine di esaminare ulteriormente l'avviso. Dalla pagina dell'archivio chiavi puoi caricare un nuovo certificato ed eliminare quello in scadenza.
Utilizzare le API di avviso con gli avvisi sul traffico
La maggior parte delle API che utilizzi per creare e gestire avvisi sul traffico è la stessa che utilizzi con altri tipi di avvisi:
- Ricevi un avviso: ricevi una definizione di avviso corretta o di anomalia.
- Ricevi la cronologia degli avvisi: ricevi le metriche della cronologia degli avvisi.
- Elimina un avviso: elimina una definizione corretta o di anomalia.
- Ricevi istanza di avviso: ricevi informazioni su un avviso attivato.
- Ricevi il numero di avvisi: ricevi il numero totale di avvisi.
Tuttavia, alcune API hanno proprietà aggiuntive utilizzate per supportare gli avvisi di anomalie, tra cui:
- Ricevi avvisi: elenca tutti gli avvisi, inclusi quelli relativi a correzioni e anomalie.
- Crea un avviso: crea un avviso corretto o di anomalia.
- Aggiornare un avviso: aggiorna una definizione di avviso corretta o di anomalia.
Crea o aggiorna un avviso sul traffico
Utilizza le stesse API per creare o aggiornare un avviso sul traffico come fai attualmente per altri tipi di avvisi. Il corpo della chiamata API per creare o aggiornare un avviso sul traffico è lo stesso utilizzato per altri avvisi, con le seguenti modifiche:
Aggiungi le nuove proprietà seguenti per specificare che si tratta di un avviso sul traffico:
"alertType": "runtime" "alertSubType": "trafficfixed"
I valori predefiniti di queste proprietà sono:
"alertType": "runtime" "alertSubType": "fixed"
- Nell'elemento
dimensions
dell'arrayconditions
:- Devi impostare i valori delle proprietà
org
,env
,proxy
eregion
. Sono supportate solo queste proprietà. Puoi impostareproxy
eregion
suALL
. - Devi impostare il valore della proprietà
traffic
sutotal
.
- Devi impostare i valori delle proprietà
Nell'array
conditions
:- La proprietà
metrics
deve avere il valore ditrafficChange
. - La proprietà
comparator
deve essere impostata suincreasedBy
odecreasedBy
. - La proprietà
threshold
contiene un valore positivo che indica un aumento o una diminuzione percentuale del traffico dove un valore di1.0
corrisponde al 100%. PerincreasedBy
il valore deve essere maggiore o uguale a 0,0 (0%). PerdecreasedBy
il valore deve essere maggiore o uguale a 0,0 (0%) e minore o uguale a 1,0 (100%). - La proprietà
durationSeconds
deve essere impostata su uno dei seguenti valori:3600
(1 ora),86400
(1 giorno),604800
(7 giorni),1296000
(15 giorni),2592000
(30 giorni) .
- La proprietà
- La proprietà
reportEnabled
non è supportata per gli avvisi sul traffico.
curl 'https://apimonitoring.enterprise.apigee.com/alerts' \ -X POST \ -H 'Accept: application/json, text/plain, */*' -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -d '{ "organization":"myorg", "name":"My Traffic Alert", "description":"My traffic alert", "environment":"prod", "enabled":true, "alertType":"runtime", "alertSubType":"trafficfixed", "conditions":[ { "description":"", "dimensions": { "org":"nyorg", "env":"prod", "proxy":"ALL", "region":"ALL", "traffic":"total" }, "metric": "trafficChange", "threshold": 0.5, "durationSeconds": 3600, "comparator": "increasedBy" } ], "notifications":[{ "channel":"pagerduty", "destination":"abcd1234efgh56789"}], "playbook":"http://acme.com/myplaybook.html", "throttleIntervalSeconds":3600, "reportEnabled":true }'
Imposta $ACCESS_TOKEN
sul token di accesso OAuth 2.0, come descritto in
Ottenere un token di accesso per OAuth 2.0.
Per informazioni sulle opzioni cURL utilizzate in questo esempio, consulta Utilizzo di cURL.
Consulta Visualizzazione degli eventi per ulteriori informazioni sull'utilizzo di questa API.
Ricevi avvisi sul traffico
Per impostazione predefinita, l'API Get Alerts restituisce informazioni su tutti gli avvisi definiti. Questa API ora utilizza i parametri di query per consentirti di filtrare i risultati:
enabled
- Setrue
specifica di restituire solo avvisi abilitati. Il valore predefinito èfalse
.alertType
: specifica il tipo di avviso da restituire. I valori consentiti sonoruntime
, il valore predefinito ecert
.alertSubType
: specifica il sottotipo di avviso da restituire. Il valore predefinito non è impostato, il che significa che vengono restituiti tutti i sottotipi di avvisi.
Ad esempio, utilizza la seguente chiamata API per restituire l'attivazione solo degli avvisi per l'organizzazione denominata myorg
:
curl -H "Authorization: Bearer $ACCESS_TOKEN" \ 'https://apimonitoring.enterprise.apigee.com/alerts?org=myorg&enabled=true'
La seguente chiamata restituisce solo avvisi sul traffico, sia attivati che disattivati:
curl -H "Authorization: Bearer $ACCESS_TOKEN" \ 'https://apimonitoring.enterprise.apigee.com/alerts?org=myorg&alertType=runtime&alertSubType=trafficfixed'
Imposta $ACCESS_TOKEN
sul tuo token di accesso OAuth 2.0, come descritto in Ottenere un token di accesso per OAuth 2.0. Per informazioni sulle opzioni cURL utilizzate in questo esempio, consulta Utilizzo di cURL.