Cloud Service Mesh-Logs erfassen

In den folgenden Abschnitten wird erläutert, wie Sie die verschiedenen Cloud Service Mesh-Logs erfassen, um Probleme zu beheben oder den Google-Support zu kontaktieren.

Logs mit dem Tool für Fehlerberichte erfassen

Cloud Service Mesh bietet ein automatisiertes Tool für Fehlerberichte, das die relevanten Diagnoseprotokolle erfasst und mit dem Sie die Protokolle an ein Google-Support-Ticket anhängen können.

Bevor Sie beginnen, prüfen Sie, ob Ihr kubeconfig-Kontext auf den Zielcluster gesetzt ist.

Prüfen Sie den Kontext mit dem folgenden Befehl:

kubectl config current-context

Mit dem Erfassen von Logs beginnen

Führen Sie zum Starten der Logerfassung das Tool für Fehlerberichte mit dem folgenden Befehl aus:

istioctl bug-report

Debug-Archiv hochladen

Das Tool erstellt im Arbeitsverzeichnis ein Archiv der Logs und der Konfiguration Ihres Mesh-Netzwerks. Sie können das Archiv entpacken und die Anleitungen zur Fehlerbehebung verwenden, um selbst eine Fehlerbehebung durchzuführen. Wenn Sie jedoch ein Supportpaket haben, können Sie sich an den Google Cloud-Support wenden, der Ihnen weitere Schritte zum sicheren Hochladen Ihres Logarchivs teilt.

Wichtig: Archivlogs können personenidentifizierbare Informationen oder private Informationen zu Ihren Sicherheitszertifikaten enthalten. Informieren Sie sich über die örtlichen Gesetze sowie über die Richtlinien und Verfahren in Ihrer Organisation bezüglich der Handhabung und der externen Übermittlung solcher vertraulicher Informationen.

Cloud Service Mesh-Logs manuell erfassen

Anstatt das Cloud Service Mesh-Tool für Fehlerberichte zu verwenden, wird in diesem Abschnitt erläutert, wie Sie alle relevanten Logs manuell erfassen.

Envoy-Zugriffslogs

Envoy-Proxy-Zugriffslogs enthalten detaillierte Informationen, die für die Fehlerbehebung hilfreich sind. Sie müssen diese jedoch aktivieren und die richtige Detailebene festlegen.

Informationen zum Interpretieren der Loginhalte finden Sie unter Envoy-Logs interpretieren.

Envoy-Logs aktivieren bzw. deaktivieren

Konfigurieren Sie zum Aktivieren der Envoy-Proxy-Zugriffslogs eine Overlay-Datei für Cloud Service Mesh im Cluster oder eine ConfigMap für verwaltetes Cloud Service Mesh.

Detailebene für Logging erhöhen

Verwenden Sie den folgenden Befehl, um die Detailebene der Logs vorübergehend zu erhöhen: Diese Einstellung wird rückgängig gemacht, wenn der Pod neu erstellt wird.

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

Verwenden Sie den folgenden Befehl, um die Detailebene der Logs auf den Standardwert zurückzusetzen:

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

Envoy-Logs in einen Ordner schreiben

Verwenden Sie den folgenden Befehl, um die Envoy-Proxy-Zugriffs-Logs zu erfassen und in einem Ordner zu speichern:

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

Weitere Informationen finden Sie unter Envoy-Zugriffslogs abrufen.

Kubernetes-Logs

Kubernetes generiert mehrere Logs, die Informationen zum Verhalten von Istio-Komponenten wie istiod, dem Ingress-Gateway und zu Proxys enthalten. Sie können diese Logs auf Fehler prüfen, wodurch sich eventuell die Anzahl der möglichen Ursachen eines Problems einschränken lässt.

Erfassen Sie istiod-Logs mit dem folgenden Befehl:

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

Erfassen Sie Istio-Ingress-Gateway-Logs mit dem folgenden Befehl:

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

Erfassen Sie Istio-Proxy-Logs mit dem folgenden Befehl:

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

Dump der Kubernetes-Konfiguration

Mit dieser Information können Nutzer ohne direkten Zugriff auf den Cluster den Status verschiedener Ressourcen aufrufen und mögliche Konfigurationsprobleme identifizieren. Mit dem folgenden Befehl wird die Kubernetes-Konfiguration in eine YAML-Datei geschrieben:

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

Envoy-Core Dump

Envoy-Core Dumps sind für Endnutzer normalerweise nicht hilfreich. Der Google-Support kann Sie jedoch dazu auffordern, diese im Rahmen der Fehlerbehebung zu erfassen. Gehen Sie dazu so vor:

Wichtig: Core Dumps können personenidentifizierbare Informationen oder private Informationen zu Ihren Sicherheitszertifikaten enthalten. Informieren Sie sich über die lokalen Gesetze und die Richtlinien und Verfahren in Ihrer Organisation bezüglich der Handhabung und der externen Übermittlung solcher vertraulicher Informationen.

Warnung: Das Konfigurieren eines Envoy-Core-Dumps ist eine knotenweite Einstellung. Diese Funktion sollte nur für die Fehlerbehebung aktiviert und dann wieder deaktiviert werden, wenn Sie mit der Fehlerbehebung fertig sind. Envoy-Core Dumps sollten nicht langfristig verbleiben.

So konfigurieren Sie den Kernel so, dass Envoy-Core Dumps in ein beschreibbares Verzeichnis geschrieben werden:

1. Fügen Sie einem Pod das Label sidecar.istio.io/enableCoreDump=true hinzu.

2. Starten Sie den Pod neu, um Envoy-Core Dumps zu aktivieren.

3. Kopieren Sie den Core Dump aus dem Pod.

Envoy-Proxy konfigurieren

Die ausführliche Envoy-Proxy-Konfiguration enthält zusätzliche Details, die für die Fehlerbehebung hilfreich sein können. Sie können diese Informationen mit dem folgenden Befehl erfassen. In diesem Beispiel entspricht ENDPOINT einem der folgenden Werte, die in der Reihenfolge ihrer Wichtigkeit angezeigt werden:

• /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