Risolvi i problemi passo passo di Cloud Service Mesh

Questa sezione spiega come risolvere i problemi relativi all'utilizzo di Cloud Service Mesh. Se hai bisogno di ulteriore assistenza, consulta Ricevere assistenza.

Passaggi per la risoluzione dei problemi

Per risolvere i problemi di Cloud Service Mesh, segui questi passaggi generali:

Utilizza gli strumenti di convalida della configurazione automatica.
Controlla se hai un problema comune con una soluzione nota.
Restringi l'ambito del problema.
Esamina i log e le informazioni pertinenti.
Raccogli log diagnostici e chiedi aiuto.

Lo strumento di diagnostica di Cloud Service Mesh può rilevare problemi di configurazione comuni. Installa lo strumento per la risoluzione dei problemi seguendo queste istruzioni.

Prima di iniziare

Assicurati che il contesto kubeconfig per il tuo cluster sia disponibile nel file kubeconfig. In caso contrario, esegui questo comando:
```
gcloud container clusters get-credentials CLUSTER_NAME \
    --location=CLUSTER_LOCATION --project=PROJECT_NAME
```
Sostituisci quanto segue:
- CLUSTER_NAME: il nome del tuo cluster.
- CLUSTER_LOCATION: la zona o la regione del tuo cluster.
- PROJECT_NAME: il nome del progetto.
Verifica che le Credenziali predefinite dell'applicazione vengono create. In caso contrario, esegui uno dei seguenti comandi:
```
gcloud auth application-default login --billing-project=PROJECT_NAME
```
```
gcloud auth application-default set-quota-project PROJECT_NAME
```
Sostituzione di PROJECT_NAME con il nome del progetto.

Visualizza lo stato del piano di controllo

I seguenti comandi possono aiutarti a comprendere lo stato del Piano di controllo Cloud Service Mesh:

Gestito

Visualizza l'elenco dello stato di connessione dei client al control plane di Cloud Service Mesh:

gcloud beta container fleet mesh debug proxy-status \
    --membership=MEMBERSHIP_NAME \
    --location=MEMBERSHIP_LOCATION \
    --project=PROJECT_NAME

Sostituisci quanto segue:

MEMBERSHIP_NAME: il nome del tuo abbonamento.
MEMBERSHIP_LOCATION: la regione per il tuo . Puoi controllare la località del tuo abbonamento con gcloud container fleet memberships list --project FLEET_PROJECT_ID sostituzione di FLEET_PROJECT_ID con il progetto del parco risorse ID.
PROJECT_NAME: il nome del progetto.

Nella tabella seguente sono descritte le possibili risposte.

SCONOSCIUTO	(Predefinito) ⁣ Le informazioni sullo stato non sono disponibili o sono sconosciute.
SINCRONIZZATO	Il piano di controllo ha inviato la configurazione al client e ha ricevuto un messaggio ACK dal client.
ERRORE	⁣ Il piano di controllo ha inviato la configurazione al client e ha ricevuto un NACK dal client.
STALE	Il piano di controllo ha inviato la configurazione al client, ma non ha ricevuto un messaggio ACK o NACK dal client.
NON INVIATO	La configurazione non è stata inviata.
N/D	Non applicabile.
Non supportata	Lo stato della sincronizzazione non è supportato dalla nostra API per la risoluzione dei problemi.

Nel cluster

kubectl get pods -n istio-system
kubectl describe -n istio-system
Per tutti i pod nel sistema istio: kubectl logs -n istio-system -l istio --all-containers
istioctl version
istioctl proxy-status
kubectl get configmap istio -o yaml && kubectl get configmap istio-sidecar-injector -o yaml
kubectl top pods -n istio-system

Usa i seguenti comandi per comprendere la scalabilità del deployment:

kubectl get nodes
kubectl get services --all-namespaces
kubectl get pods --all-namespaces

Visualizza configurazioni proxy

Il seguente comando può aiutarti a comprendere le configurazioni del proxy Cloud Service Mesh:

Gestito

gcloud beta container fleet mesh debug proxy-config POD_NAME.NAMESPACE \ 
    --type=TYPE \
    --membership=MEMBERSHIP_NAME \
    --location=MEMBERSHIP_LOCATION \
    --project=PROJECT_NAME

POD_NAME: il nome del pod.
NAMESPACE: lo spazio dei nomi del pod.
TYPE: uno dei seguenti: cluster, listener, route, endpoint, bootstrap, log, secret, tutto.
MEMBERSHIP_NAME: il nome del tuo abbonamento.
MEMBERSHIP_LOCATION: la regione per il tuo . Puoi controllare la località del tuo abbonamento con gcloud container fleet memberships list --project FLEET_PROJECT_ID sostituzione di FLEET_PROJECT_ID con il progetto del parco risorse ID.
PROJECT_NAME: il nome del progetto.

All'interno del cluster

Utilizza istioctl proxy-config per visualizzare le configurazioni dei proxy per i piani di controllo all'interno del cluster. Per ulteriori informazioni, consulta la sezione Eseguire il debug di Envoy e istiod.

Se il problema persiste, consulta la sezione successiva per verificare se è già noti.

Problemi e soluzioni comuni

Per risparmiare tempo, controlla se i sintomi corrispondono a un problema descritto in queste sezioni relative a problemi e soluzioni comuni, raggruppate per area funzionale di Cloud Service Mesh:

Se il problema persiste, consulta la sezione successiva.

Restringi l'ambito del problema

Cloud Service Mesh è costituito da diverse tecnologie che interagiscono tra loro, il che significa che alcuni tipi di problemi siano associati a particolari aree funzionali o componenti. Ognuno di questi componenti genera log propri. Prima del giorno di analizzare manualmente il volume di informazioni che forniscono, restringere l'ambito della risoluzione dei problemi rispondendo alle seguenti domande:

Il problema si verifica all'interno del piano di controllo o dei dati, ad esempio istiod o proxy Envoy?
In quale area funzionale si verifica il problema, ad esempio Networking, Telemetry, Security e così via?
Si verifica una perdita di traffico a livello di service mesh o in un deployment specifico?
Il problema si verifica o peggiora a causa della mancanza di capacità di scalare il traffico nel mesh di servizi?
Il problema causa latenza o altri problemi di prestazioni?
Puoi riprodurre il problema su richiesta?
Il problema si è verificato dopo una recente modifica della configurazione in Istio, GKE e così via?
Si è verificato un aumento o un picco di traffico all'interno del mesh di servizi?
Questo cluster ha funzionalità note abilitate o deployment non tipici?
Noti un utilizzo elevato di CPU o memoria? Se sì, qual è l'utilizzo previsto su larga scala?
Ci sono limitazioni di quota da prendere in considerazione?

Esamina log e informazioni pertinenti

Dopo aver ristretto l'ambito del problema, puoi concentrarti su determinati log e informazioni in modo più efficace. Per scoprire di più sui log utilizzati da Cloud Service Mesh generati e come interpretare le informazioni che contengono, consulta Interpretazione dei log di Cloud Service Mesh.