Generazione automatica dei problemi

Panoramica

La funzionalità di rilevamento automatico dei problemi (AIS) fornisce informazioni rapide sui problemi in corso rilevati nel tuo cluster Hybrid. Queste informazioni includono link alla documentazione per la risoluzione dei problemi. La visualizzazione automatica dei problemi cerca solo i problemi noti, comuni e rilevabili dal sistema. non riesce a rilevare tutti i problemi all'interno di un cluster.

A partire da Apigee hybrid v1.10, il componente watcher runtime Apigee analizza automaticamente del piano di controllo e dello stato del server API Kubernetes per determinare se ci sono 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.

Quando risolvi i problemi, questi vengono eliminati automaticamente dal server dell'API Kubernetes quando 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 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 rilevare eventuali problemi. Per modificare intervallo di scansione, specifica il nuovo intervallo in secondi 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 dell'individuazione 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.

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 Introduzione ad Apigee X e i playbook ibridi di Apigee per una panoramica e un elenco di guide alla risoluzione dei problemi di Apigee.