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 i problemi noti, comuni e rilevabili dal sistema. non riesce a 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 a
documentazione sui 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_NAMESPACE 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:
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
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.
Esegui l'upgrade del grafico apigee-env
per ogni ambiente Apigee.
helm upgrade ENV_NAME apigee-env/ \ --install \ --namespace APIGEE_NAMESPACE \ --set env=ENV_NAME \ --atomic \ -f overrides.yaml
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.
Esegui l'upgrade del grafico apigee-env
per ogni ambiente Apigee.
helm upgrade ENV_NAME apigee-env/ \ --install \ --namespace APIGEE_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 alla risoluzione dei problemi, tra cui:- Nessuna connettività di rete tra il piano di runtime e il piano di controllo
- Gruppo di ambienti mancante per l'hosting virtuale
- In entrata mancata corrispondenza del certificato