Rilevamento automatico dei problemi

Panoramica

La funzionalità Automated Issue Surface (AIS) fornisce informazioni rapide sui problemi in corso rilevati all'interno di per il tuo cluster ibrido. Queste informazioni comprendono i link alla documentazione per la risoluzione dei problemi e risoluzione del problema. La visualizzazione automatica dei problemi cerca solo problemi noti e comuni rilevabili dal sistema e non può rilevare tutti i problemi all'interno di un cluster.

A partire dalla versione 1.10 di Apigee Hybrid, il componente di monitoraggio del runtime di Apigee esegue automaticamente la scansione del piano di controllo e dello stato del server API Kubernetes per determinare se sono presenti problemi di configurazione. Per impostazione predefinita, l'analisi viene eseguita ogni 60 secondi. Puoi modificare l'intervallo o disattivare scansione, se preferisci.

Quando AIS rileva un problema, crea una nuova istanza di ApigeeIssue all'interno il server API di Kubernetes. Queste istanze contengono informazioni sui problemi e link alla documentazione relativa ai problemi specifici.

Una volta risolti, i problemi verranno eliminati automaticamente dal server API Kubernetes la scansione determina che non si verificano più.

Utilizzo della generazione automatica dei problemi.

Verifica la presenza di eventuali problemi con il comando kubectl get apigeeissues:

kubectl -n apigee get apigeeissues

Ad esempio:

kubectl -n apigee get apigeeissues

NAME                                 SEVERITY    AGE URL
vhost-missing-eg-nonprod             Error       1hr https://cloud.google.com/apigee/docs/hybrid/MISSING_ENV_GROUP
control-plane-connectivity-failure   Error       1d  https://cloud.google.com/apigee/docs/hybrid/OLD_TLS_VERSION

Per informazioni più dettagliate su un problema specifico, utilizza kubectl describe con il nome del problema. Il nome deve essere preceduto da apigeeissues/, ad esempio: apigeeissues/vhost-missing-eg-nonprod.

kubectl -n apigee describe apigeeissues/vhost-missing-eg-nonprod

Name:         vhost-missing-eg-nonprod
Namespace:    apigee
Labels:       
Annotations:  
API Version:  apigee.cloud.google.com/v1alpha1
Kind:         ApigeeIssue
Metadata:
  Creation Timestamp:  2022-08-25T20:41:56Z
  Managed Fields:
    API Version:  apigee.cloud.google.com/v3
  Resource Version:  12345678
  UID:               aaaaaaaa-bbbb-cccc-dddd-eeeeffffgggg
Spec:
  Severity: Error
  Reason: MISSING_ENV_GROUP
  Details: Expected envgroup "nonprod" for ApigeeRouteConfig "my-org-nonprod"
  Documentation: https://cloud.google.com/apigee/docs/hybrid/MISSING_ENV_GROUP
  Ignore: false
  IgnoreReason:
Events: 

Modificare l'intervallo di analisi

Per impostazione predefinita, Watcher esegue la scansione del piano di controllo per rilevare eventuali problemi ogni 60 secondi. Per modificare l'intervallo di scansione, specifica il nuovo intervallo in secondi con la proprietà watcher.args.issueScanInterval nel file delle sostituzioni. Ad esempio:

watcher:
  args:
    issueScanInterval: 120

Applica la configurazione con apigeectl apply -f overrides --all-envs.

Disattivazione della visualizzazione automatica dei problemi

Puoi disattivare la generazione automatica dei problemi impostando il watcher.args.enableIssueScanning a false nel file degli override. Ad esempio:

watcher:
  args:
    enableIssueScanning: false

Applica la configurazione con apigeectl apply -f overrides --all-envs.

La visualizzazione automatica dei problemi può fornire link direttamente alle guide per la risoluzione dei problemi, tra cui: Consulta la Introduzione alle guide pratiche di Apigee X e Apigee hybrid per una panoramica e un elenco delle guide alla risoluzione dei problemi di Apigee.