Panoramica
La funzionalità Automated Issue Surface (AIS) fornisce informazioni rapide sui problemi in corso rilevati all'interno del tuo cluster ibrido. Queste informazioni includono i link alla documentazione per la risoluzione dei problemi. La visualizzazione automatica dei problemi cerca solo i problemi noti, comuni e rilevabili dal sistema e non può rilevare tutti i problemi all'interno di un cluster.
A partire da Apigee hybrid v1.10, il componente watcher runtime Apigee analizza automaticamente il piano di controllo e lo 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 disabilitare la scansione, se preferisci.
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 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
l'intervallo di scansione, specifica il nuovo intervallo in secondi con la
proprietà watcher.args.issueScanInterval
nel file degli override. Ad esempio:
watcher: args: issueScanInterval: 120
Applica la configurazione.
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
Disattivazione della visualizzazione automatica dei problemi
Puoi disattivare la generazione automatica dei problemi impostando la proprietà watcher.args.enableIssueScanning
su false
nel file degli override. Ad esempio:
watcher: args: enableIssueScanning: false
Applica la configurazione.
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
Guide alla risoluzione dei problemi correlate
La visualizzazione automatica dei problemi può fornire link direttamente alle guide per la risoluzione dei problemi, tra cui:- Nessuna connettività di rete tra il piano di runtime e il piano di controllo
- Host virtuale mancante per il gruppo di ambienti
- Mancata corrispondenza dei certificati in entrata