Segnalazione automatica dei problemi

Panoramica

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

A partire da Apigee v1.10, il componente Watcher runtime Apigee esegue automaticamente la scansione dello stato del piano di controllo e del server API Kubernetes per determinare se sono presenti problemi di configurazione. Per impostazione predefinita, la scansione viene eseguita ogni 60 secondi. Se preferisci, puoi modificare l'intervallo o disabilitare la scansione.

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

Una volta risolti, i problemi verranno eliminati automaticamente dal server API Kubernetes quando l'analisi determina che non sono più in corso.

Utilizzare la segnalazione 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 il comando 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:

Modifica dell'intervallo di scansione

Per impostazione predefinita, Watcher analizza il piano di controllo una volta ogni 60 secondi per individuare eventuali problemi. Per modificare l'intervallo di scansione, specifica il nuovo intervallo in secondi con la proprietà watcher.args.issueScanInterval nel file di override. Ad esempio:

watcher:
  args:
    issueScanInterval: 120

Applica la configurazione.

Helm

Esegui l'upgrade del grafico apigee-env per ogni ambiente Apigee.

helm upgrade ENV_NAME apigee-env/ \
  --install \
  --namespace NAMESPACE \
  --set env=ENV_NAME \
  --atomic \
  -f overrides.yaml

apigeectl

Applica la modifica a tutti gli ambienti.

apigeectl apply -f overrides --all-envs

Disattivazione della visualizzazione automatica dei problemi

Puoi disattivare la visualizzazione automatica dei problemi impostando la proprietà watcher.args.enableIssueScanning su false nel file di override. Ad esempio:

watcher:
  args:
    enableIssueScanning: false

Applica la configurazione.

Helm

Esegui l'upgrade del grafico apigee-env per ogni ambiente Apigee.

helm upgrade ENV_NAME apigee-env/ \
  --install \
  --namespace NAMESPACE \
  --set env=ENV_NAME \
  --atomic \
  -f overrides.yaml

apigeectl

Applica la modifica a tutti gli ambienti.

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 l'introduzione ai playbook ibridi Apigee X e Apigee per una panoramica e un elenco di guide per la risoluzione dei problemi di Apigee.