Raccolta dei log di Cloud Service Mesh

Le sezioni seguenti spiegano come raccogliere i vari log di Cloud Service Mesh per risolvere i problemi o contattare l'Assistenza Google.

Raccogli i log utilizzando lo strumento di segnalazione di bug

Cloud Service Mesh fornisce uno strumento automatico per la segnalazione di bug che raccoglie i log di diagnostica pertinenti e ti consente di allegarli a un ticket dell'Assistenza Google.

Prima di iniziare, assicurati che il contesto kubeconfig sia impostato sul cluster di destinazione.

Verifica il contesto utilizzando il comando seguente:

kubectl config current-context

Avvia la raccolta di log

Per avviare la raccolta dei log, esegui lo strumento bug-report utilizzando il seguente comando:

istioctl bug-report

Caricare l'archivio di debug

Lo strumento crea un archivio dei log e della configurazione del mesh nella directory di lavoro. Puoi decomprimere l'archivio e utilizzare le guide alla risoluzione dei problemi per provare a risolvere autonomamente il problema. Tuttavia, se hai un'assistenza puoi contattare l'assistenza Google Cloud, che ti fornirà ulteriori passaggi per caricare in modo sicuro l'archivio dei log.

Importante: i log archiviati potrebbero contenere informazioni che consentono l'identificazione personale (PII) o informazioni private sui tuoi certificati di sicurezza. Controlla le leggi locali nonché i criteri e le procedure della tua organizzazione relativi a come gestire queste informazioni sensibili esternamente.

Raccogliere manualmente i log di Cloud Service Mesh

Anziché utilizzare lo strumento per la segnalazione di bug di Cloud Service Mesh, questa sezione spiega come raccogliere manualmente tutti i log pertinenti.

Log di accesso di Envoy

I log di accesso del proxy Envoy contengono informazioni dettagliate utili per la risoluzione dei problemi. Tuttavia, devi attivarli e impostare il livello di dettaglio corretto.

Per informazioni dettagliate su come interpretare i contenuti dei log, consulta Interpreta i log di Envoy.

Abilita o disabilita i log di Envoy

Per abilitare i log di accesso del proxy Envoy, configura un file overlay per Cloud Service Mesh nel cluster o un ConfigMap per Cloud Service Mesh gestito.

Aumenta dettagli di logging

Per aumentare temporaneamente il livello di dettaglio dei log, utilizza il seguente comando. Questa impostazione viene annullata quando il pod viene ricreato.

kubectl -n NAMESPACE exec POD_NAME -c istio-proxy -- curl -X POST http://localhost:15000/logging?level=debug

Per ripristinare il livello di dettaglio predefinito dei log, utilizza il seguente comando:

kubectl -n NAMESPACE exec POD_NAME -c istio-proxy -- curl -X POST http://localhost:15000/logging?level=info

Scrivere i log di Envoy in una cartella

Per raccogliere i log di accesso del proxy Envoy e archiviarli in una cartella, utilizza il seguente comando:

kubectl logs -l app=APPLICATION_NAME -c istio-proxy > /FILE_PATH

Per ulteriori informazioni, consulta Ottenere i log di accesso di Envoy.

Log di Kubernetes

Kubernetes genera diversi log contenenti informazioni sul comportamento Componenti Istio, come istiod, gateway Ingress e proxy. Puoi rivedere per rilevare eventuali errori, il che potrebbe restringere l'ambito delle possibili cause di un problema.

Acquisisci i log di istiod utilizzando il seguente comando:

kubectl -n istio-system logs $(kubectl -n istio-system get pods -lapp=istiod -oname) > ./LOGS_FOLDER/istiod.log

Acquisisci i log del gateway Istio Ingress utilizzando il seguente comando:

kubectl -n istio-system logs $(kubectl -n istio-system get pods -lapp=istio-ingressgateway -oname) > /FILE_PATH

Acquisisci i log del proxy Istio utilizzando il seguente comando:

kubectl -n WORKLOAD_NAMESPACE logs POD_NAME -c istio-proxy > ./LOGS_FOLDER/proxy.log

Dump della configurazione di Kubernetes

Queste informazioni consentono agli utenti senza accesso diretto al cluster di visualizzare lo stato di varie risorse e identificare possibili problemi di configurazione. Il comando seguente scrive la configurazione di Kubernetes in un file YAML:

for ns in `kubectl get namespaces -o=jsonpath='{.items[*].metadata.name}'` ; do echo "===NAMESPACE===" $ns >> ./LOGS_FOLDER/kubernetes.yaml ;kubectl get -oyaml -n $ns deploy,statefulset,job,ingress,endpoints,configmap,event,secret,service,istio-io >> ./LOGS_FOLDER/kubernetes.yaml; done

Core dump di Envoy

I dump del core di Envoy in genere non sono utili per gli utenti finali, ma l'Assistenza Google potrebbe chiederti di raccoglierli nell'ambito della procedura di risoluzione dei problemi, seguendo i passaggi che seguono.

Importante: i dump del core potrebbero contenere informazioni che consentono l'identificazione personale (PII) o informazioni private sui tuoi certificati di sicurezza. Consulta le leggi locali e le norme e le procedure della tua organizzazione su come gestire o inviare queste informazioni sensibili all'esterno.

Avviso: la configurazione di un dump del core di Envoy è un'impostazione a livello di nodo. Questa funzionalità deve essere attivato solo per il debug e poi disattivato al termine del debug. I core dump di Envoy non devono essere lasciati a lungo termine.

Per configurare il kernel in modo che scriva i core dump di Envoy in una directory scrivibile:

1. Aggiungi l'etichetta sidecar.istio.io/enableCoreDump=true a un pod.

2. Riavvia il pod per abilitare i core dump di Envoy.

3. Copia il dump del core dal pod.

Configura il proxy Envoy

La configurazione dettagliata del proxy Envoy contiene ulteriori dettagli che potrebbero essere utili per la risoluzione dei problemi. Puoi raccogliere queste informazioni utilizzando il seguente comando. In questo esempio, ENDPOINT è uno dei seguenti (mostrati in ordine di importanza):

• /certs
• /clusters
• /listeners
• /config_dump
• /memory
• /server_info
• /stats/prometheus
• /runtime

kubectl exec -i POD_NAME -c istio-proxy -n NAMESPACE curl 127.0.0.1:15000/ENDPOINT > out.log