Panoramica delle anomalie delle operazioni

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Le anomalie delle operazioni identificano pattern di dati insoliti o imprevisti con le tue API. Anomalie operative monitora e esegue continuamente analisi statistiche per trovare anomalie.

Anomalie delle operazioni rileva automaticamente questi tipi di anomalie:

• Aumento di tutti gli errori HTTP 4xx o 5xx a livello di organizzazione, ambiente e regione
• Aumento della latenza totale della risposta per il 90° percentile (p90) a livello di organizzazione, ambiente e regione

Ad esempio, in questo grafico del tasso di errore dell'API, il tasso aumenta improvvisamente intorno alle 7:00. Rispetto ai dati precedenti, questo aumento è abbastanza insolito da essere classificato come anomalia.

Le anomalie delle operazioni possono anche distinguere le variazioni che hanno meno probabilità di indicare anomalie. Ad esempio, puoi notare alcune piccole variazioni nel tasso di errore che precedono l'anomalia, ma queste non sono abbastanza significative da essere classificate come anomalia.

Anomalie delle operazioni ti consente di:

• Visualizza e analizza le anomalie: i report sulle anomalie delle operazioni mostrano eventi API insoliti (anomalie). Puoi esaminare in dettaglio per scoprire dove e quando si è verificato l'incidente e cosa lo ha causato, in modo da poter risolvere rapidamente la situazione.
• Crea avvisi di anomalie e configura le notifiche per fare in modo che Apigee ti invii un messaggio quando si verifica un incidente.

Prerequisiti per l'utilizzo delle anomalie delle operazioni

Per utilizzare le anomalie delle operazioni:

• Il componente aggiuntivo AAPI Ops deve essere attivato per la tua organizzazione. Vedi Attivare AAPI Ops in un'organizzazione.
• Gli utenti delle anomalie delle operazioni devono disporre dei seguenti ruoli:
  • roles/apigee.readOnlyAdmin
  • roles/logging.viewer
  • roles/monitoring.viewer
• Gli utenti che analizzano le anomalie nella dashboard devono disporre anche del ruolo roles/logging.viewer.

Attivare AAPI Ops in un'organizzazione

Per utilizzare AAPI Ops, devi abilitarlo nella tua organizzazione. Prima di farlo, ottieni un token di accesso OAuth 2.0. Puoi quindi abilitare AAPI Ops utilizzando una chiamata API che trasmette il token di accesso.

Visualizzare la configurazione attuale dei componenti aggiuntivi

Prima di abilitare AAPI Ops, verifica se è già abilitata effettuando la seguente chiamata API:

curl "https://apigee.googleapis.com/v1/organizations/YOUR_ORG" \
  -X GET \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer $TOKEN"

dove YOUR_ORG è il nome della tua organizzazione e $TOKEN è la variabile di ambiente per un token di accesso OAuth. Vengono restituite informazioni di base sulla tua organizzazione, inclusa una sezione per i componenti aggiuntivi Apigee che inizia con la riga:

"addonsConfig": {

Controlla se questa sezione contiene una voce che inizia con "advancedApiOpsConfig", come nel seguente esempio:

"advancedApiOpsConfig": {
          "enabled": "true"
      }

Se questa voce è presente, AAPI Ops è già abilitato nell'organizzazione. In caso contrario, devi attivarlo come descritto di seguito.

Abilita AAPI Ops

Per attivare AAPI Ops nell'organizzazione con la configurazione predefinita, invia una richiesta POST come quella mostrata di seguito.

Attenzione: questa chiamata API sovrascrive la configurazione attuale dei componenti aggiuntivi. Per evitare che vengano sovrascritti, devi includere le configurazioni attuali di tutti i componenti aggiuntivi nella richiesta precedente.

Nota: la chiamata API riportata di seguito avvia un'operazione a lunga esecuzione il cui completamento potrebbe richiedere un po' di tempo.

curl "https://apigee.googleapis.com/v1/organizations/ORG:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "advancedApiOpsConfig": {
          "enabled": "true"
      }
      <Current add-ons configuration>
    }
  }'

dove <Current add-ons configuration> è la configurazione attuale dei componenti aggiuntivi. Puoi trovare la configurazione attuale dei componenti aggiuntivi nella risposta alla chiamata per visualizzare la configurazione attuale dei componenti aggiuntivi. Ad esempio, se la configurazione attuale dei componenti aggiuntivi è

"addonsConfig": {
    "integrationConfig": {
        "enabled":"true"
     },
    "monetizationConfig": {
        "enabled":"true"
     }
  },

il comando per abilitare AAPI Ops sarebbe

curl "https://apigee.googleapis.com/v1/organizations/YOUR_ORG:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "advancedApiOpsConfig": {
          "enabled": "true"
      },
    "integrationConfig": {
          "enabled": "true"
      },
    "monetizationConfig": {
          "enabled": "true"
      }
    }
  }'

Dopo aver inviato la richiesta, vedrai una risposta simile alla seguente:

{
  "name": "organizations/apigee-docs-d/operations/0718a945-76e0-4393-a456-f9929603b32c",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/apigee-docs-d",
    "state": "IN_PROGRESS"
  }
}

Disattivare AAPI Ops nella tua organizzazione

Se per qualche motivo devi disattivare AAPI Ops nella tua organizzazione, puoi farlo inviando una richiesta POST, passando la configurazione dei componenti aggiuntivi nel corpo della richiesta, come mostrato di seguito.

Attenzione: la configurazione dei componenti aggiuntivi che trasmetti nel corpo della richiesta sovrascriverà la configurazione attuale dei componenti aggiuntivi. Visualizza la configurazione attuale dei componenti aggiuntivi nel profilo dell'organizzazione Apigee e assicurati di includerla nel payload della richiesta.

Nota: la chiamata API riportata di seguito avvia un'operazione a lunga esecuzione che potrebbe richiedere un po' di tempo per essere completata.

curl "https://apigee.googleapis.com/v1/organizations/$ORG:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "advancedApiOpsConfig": {
          "enabled": "false"
      }
     <Include current add-ons configuration>
    }
  }'

Di seguito è riportato un esempio di risposta che mostra che l'operazione è in corso:

{
  "name": "organizations/$ORG/operations/06274ffb-8940-41da-836d-781cba190437",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/$ORG",
    "state": "IN_PROGRESS"
  }
}

Per saperne di più, consulta l'API Configura i componenti aggiuntivi dell'organizzazione.

Come funziona il rilevamento delle anomalie

Il rilevamento delle anomalie prevede le seguenti fasi:

• Addestrare i modelli
• Eventi anomali dei log

Addestra i modelli

Le anomalie delle operazioni funzionano addestrando un modello del comportamento dei proxy API a partire da dati storici delle serie temporali. Non è richiesto alcun intervento da parte tua per addestrare il modello. Apigee crea e addestra automaticamente i modelli per te a partire dalle sei ore precedenti di dati API. Pertanto, Apigee richiede un minimo di sei ore di dati su un proxy API per addestrare il modello prima che possa registrare un'anomalia.

L'obiettivo dell'addestramento è migliorare l'accuratezza del modello, che può poi essere testato sui dati storici. Il modo più semplice per testare l'accuratezza di un modello è calcolare il suo tasso di errore, ovvero la somma di falsi positivi e falsi negativi, divisa per il numero totale di eventi previsti.

Registrare eventi di anomalia

In fase di runtime, le anomalie delle operazioni confrontano il comportamento attuale dei proxy API con il comportamento previsto dal modello. Le anomalie operative possono quindi determinare, con un livello di confidenza specifico, quando una metrica operativa supera il valore previsto. Ad esempio, quando il tasso di errori 5xx supera il tasso previsto dal modello.

Quando Apigee rileva un'anomalia, registra automaticamente l'evento nella dashboard delle anomalie operative. L'elenco degli eventi visualizzati nella dashboard include tutte le anomalie rilevate, nonché gli avvisi attivati.