In diesem Dokument werden die Quellen von Diagnoseinformationen beschrieben, die Sie verwenden können, um Probleme bei der Installation oder Ausführung des Ops-Agents zu identifizieren.
Agent-Status mit gcpdiag prüfen
Mit „gcpdiag“ können Sie den Status des Ops-Agents für einzelne VMs oder der gesamten VM-Flotte innerhalb Ihres Projekts, um zu bestätigen, dass der Agent installiert ist und aktiv Logs und Messwerte sendet. Mit „gcpdiag“ können Statusberichte in mehreren Formaten erstellt werden, auch als CSV-Datei oder JSON-Format.
Hier sehen Sie einen flottenweiten Agent-Statusbericht im CSV-Format:
🔎 gce/ERR/2024_004: Verify Ops Agent is installed on GCE VMs and is sending logs and metrics.
gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-1,failed,Ops Agent not installed on the VM,https://gcpdiag.dev/rules/gce/ERR/2024_004
gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-2,skipped,VM Manager is needed for the ops agent detection. Please enable it at: https://cloud.google.com/compute/docs/manage-os#automatic and run this check again.,https://gcpdiag.dev/rules/gce/ERR/2024_004
gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-3,skipped,VM Manager is needed for the ops agent detection. Please enable it at: https://cloud.google.com/compute/docs/manage-os#automatic and run this check again.,https://gcpdiag.dev/rules/gce/ERR/2024_004
gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-4,ok,"Ops Agent installed on the VM, and is successfully sending logs and metrics.",https://gcpdiag.dev/rules/gce/ERR/2024_004
gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-5,ok,"Ops Agent installed on the VM, and is successfully sending logs and metrics.",https://gcpdiag.dev/rules/gce/ERR/2024_004
Das Tool „gcpdiag“ wurde vom Google Cloud-Support entwickelt, um Sie bei der häufige Probleme in Ihrem Google Cloud-Projekt selbst zu diagnostizieren, Ops-Agent. „gcpdiag“ ist ein Open-Source-Tool, kein offizielles Google Cloud-Tool. ein Produkt, das jedoch vom Google Cloud-Supportteam aktiv entwickelt und gewartet wird. Auf GitHub können Sie einen Beitrag leisten oder Probleme melden.
Hinweise
„gcpdiag“ ist in Cloud Shell eingebunden, sodass Sie es ohne Installation erforderlich. Zum Ausführen von „gcpdiag“ müssen folgende Voraussetzungen erfüllt sein: Voraussetzungen:
Autorisierung: gcpdiag verwendet Standardanmeldedaten für Anwendungen (ADC) in Cloud Shell authentifizieren.
Achten Sie darauf, dass die mit „gcpdiag“ verwendeten Anmeldedaten mindestens die folgenden Rollen haben im Google Cloud-Projekt in dem der Ops-Agent ausgeführt wird:- Betrachter (
roles/viewer
) - Service Usage-Nutzer (
roles/serviceusage.serviceUsageConsumer
)
- Betrachter (
APIs: Damit Sie „gcpdiag“ in einem Projekt verwenden können, müssen die folgenden APIs aktiviert sein:
- Cloud Resource Manager API:
cloudresourcemanager.googleapis.com
- Identity and Access Management API:
iam.googleapis.com
- Cloud Logging API:
logging.googleapis.com
- Service Usage:
serviceusage.googleapis.com
Führen Sie zum Aktivieren dieser APIs den folgenden Befehl in Cloud Shell aus oder eine andere Befehlszeile:
gcloud --project=PROJECT_ID services enable \ cloudresourcemanager.googleapis.com \ iam.googleapis.com \ logging.googleapis.com \ serviceusage.googleapis.com
- Cloud Resource Manager API:
VM Manager: VM Manager aktivieren der kostenlosen Stufe auf Ihrer Instanz. Wenn Sie den Ops-Agent installiert haben während der VM-Erstellung eine Agent-Richtlinie verwaltet, Installation des Ops-Agents auf Ihren VM-Instanzen, Sie erfüllen die Anforderungen bereits für VM Manager.
„gcpdiag“ ausführen
Der Befehl gcpdiag
zur Verwendung mit dem Ops-Agent
hat die folgende grundlegende Syntax:
gcpdiag lint --project=PROJECT_ID [--name=INSTANCE_NAME] --show-skipped --include=gce/err/2024_004 [--output=[CSV|JSON]]
- PROJECT_ID ist die ID des Google Cloud-Projekts.
- INSTANCE_NAME ist der Name Ihrer Compute Engine-VM.
Verwenden Sie die Option
--name
, um eine bestimmte VM abzufragen. die Option zur Abfrage der gesamten Flotte auslassen. - Verwenden Sie die Option
--output
, um den Bericht in einer Datei im CSV- oder JSON-Format zu speichern. lassen Sie die Option weg, wenn Sie keine Ausgabedatei wünschen.
Der Wert der Option --include
gibt eine oder mehrere gcpdiag-Regeln an.
gce/ERR/2024-004
ist die Regel für den Ops-Agent.
Weitere Informationen zur Syntax des Befehls „gcpdiag“ finden Sie in
Siehe gcpdiag – Diagnose für Google Cloud Platform.
Um beispielsweise einen flottenweiten Bericht für das Projekt „my-project“ zu generieren, führen Sie den folgenden Befehl aus:
gcpdiag lint --project=my-project --show-skipped --include=gce/ERR/2024_004
Die Ausgabe sollte so aussehen:
🔎 gce/ERR/2024_004: Verify Ops Agent is installed on GCE VMs and is sending logs and metrics.
- my-project/instance-1 [FAIL] Ops Agent not installed on the VM
- my-project/instance-2 [FAIL] Ops Agent not installed on the VM
- my-project/instance-3 [SKIP] Unable to confirm Ops Agent installation
VM Manager is needed for the ops agent detection. Please enable it at: https://cloud.google.com/compute/docs/manage-os#automatic and run this check again.
- my-project/instance-4 [FAIL] Ops Agent is installed, but it's failing to send both logs and metrics to Google Cloud.
Is Ops Agent sending logs? (Yes) Is Ops Agent sending metrics? (No)
- my-project/instance-5 [FAIL] Ops Agent is installed, but it's failing to send both logs and metrics to Google Cloud.
Is Ops Agent sending logs? (No) Is Ops Agent sending metrics? (No)
- my-project/instance-6 [ OK ] Ops Agent installed on the VM, and is successfully sending logs and metrics.
- my-project/instance-7 [ OK ] Ops Agent installed on the VM, and is successfully sending logs and metrics.
So erstellen Sie einen Bericht für die Instanz „my-instance“ Projekt „my-project“ führen Sie den folgenden Befehl aus:
gcpdiag lint --project=my-project --name=my-instance --show-skipped --include=gce/err/2024_004
Die Ausgabe sollte so aussehen:
🔎 gce/ERR/2024_004: Verify Ops Agent is installed on GCE VMs and is sending logs and metrics.
- my-project/my-instance [ OK ] Ops Agent installed on the VM, and is successfully sending logs and metrics.
Wenn der Befehl gcpdiag
mit einer Ausgabe wie dieser fehlschlägt,
Prüfen Sie, ob alle Voraussetzungen erfüllt sind.
für die Ausführung des Tools.
WARNING:googleapiclient.http:Encountered 403 Forbidden with reason "PERMISSION_DENIED"
[ERROR]:can't access project my-project: Cloud Resource Manager API has not been used in project my-project before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/cloudresourcemanager.googleapis.com/overview?project=my-project then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry..
[DEBUG]: An Http Error occurred whiles accessing projects.get
HttpError 403 when requesting https://cloudresourcemanager.googleapis.com/v3/projects/my-project?alt=json returned Cloud Resource Manager API has not been used in project my-project before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/cloudresourcemanager.googleapis.com/overview?project=my-project then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry. Details: ...
[ERROR]:exiting program...
error getting project details
gcpdiag-Ausgabe interpretieren
Dieser Abschnitt enthält Informationen zum Verständnis und zur Verwendung der Berichte. von gcpdiag generiert.
Der Befehl „gcpdiag“ generiert Berichte, die Folgendes enthalten: Informationen:
- Ein Indikator der gcpdiag-Regel, mit der der Befehl aufgerufen wurde.
Für den Ops-Agent sehen diese Informationen so aus:
🔎 gce/ERR/2024_004: Verify Ops Agent is installed on GCE VMs and is sending logs and metrics
- Eine Kennzeichnung des Ergebnisses für eine bestimmte VM im Format PROJECT_ID/INSTANCE_ID. Für einen flottenweiten Bericht enthält einen Eintrag für jede VM. Bei einem Bericht für eine einzelne VM enthält einen einzelnen Eintrag.
- Der Status der Diagnose. Der Status hat einen der folgenden Werte: <ph type="x-smartling-placeholder">
- Eine Beschreibung des Statuswerts.
In den folgenden Abschnitten finden Sie weitere Informationen zu den Statuswerten und deren Bedeutung.
Status: OK
Der Status OK
bedeutet, dass der Ops-Agent auf dem
und sowohl Logs als auch Messwerte von der VM senden. Der Bericht enthält die
folgende Statusbeschreibung:
Ops Agent installed on the VM, and is successfully sending logs and metrics.
Status: FAIL
Der Status FAIL
bedeutet, dass der Ops-Agent nicht installiert ist.
oder von der VM
nicht sowohl Logs als auch Messwerte gesendet werden. Statusbeschreibung
zeigt an, welches Problem erkannt wurde:
- Wenn der Ops-Agent nicht installiert ist, wird der folgende Status angezeigt:
Beschreibung:
Ops Agent not installed on the VM
- Wenn der Ops-Agent nicht sowohl Logs als auch Messwerte von der VM sendet,
sehen Sie eine Statusbeschreibung wie diese:
Agent is installed, but it's failing to send both logs and metrics to Google Cloud.
Is Ops Agent sending logs? (Yes) Is Ops Agent sending metrics? (No)
Wenn der Ops-Agent nicht installiert ist, installieren Sie ihn. Wenn die Installation fehlschlägt, kann eines der folgenden sein:
- Der VM ist kein Dienstkonto zugeordnet. So beheben Sie das Problem: <ph type="x-smartling-placeholder"></ph> ein Dienstkonto an die VM anhängen und versuchen dann, Ops-Agent installieren noch einmal.
- Die VM hat einen der Legacy-Agents (den Monitoring-Agent oder den Logging-Agent). <ph type="x-smartling-placeholder"></ph> bereits installiert haben. Deinstallieren Sie die alten Agents, um das Problem zu beheben. und dann versuchen, Ops-Agent installieren noch einmal.
Wenn der Ops-Agent keine Logs oder Messwerte von der VM sendet, Agent-Systemdiagnosen auf Startzeitfehler verwenden um das Problem zu ermitteln und zu beheben.
Status: SKIP
Der Status SKIP
bedeutet, dass gcpdiag nicht ermitteln konnte,
Der Ops-Agent ist auf der VM installiert. Der Bericht enthält Folgendes:
Statusbeschreibung:
Unable to confirm Ops Agent installation
VM Manager is needed for the ops agent detection.
Please enable it at: https://cloud.google.com/compute/docs/manage-os#automatic and run this check again.
Zum Testen des Agent-Status benötigt „gcpdiag“
VM Manager
auf Ihrer VM ausgeführt wird. Um dieses Problem zu beheben, installieren Sie die
VM Manager kostenlos
Stufe Ihrer Instanz. Warten Sie nach der Installation 15 Minuten und versuchen Sie es dann noch einmal
und führen Sie den Befehl gcpdiag
noch einmal aus.
Agent-Systemdiagnosen
Mit Version 2.25.1 wurden Systemdiagnosen beim Start gestartet für den Ops-Agent. Wenn der Ops-Agent gestartet wird, führt er eine Reihe von Prüfungen auf Bedingungen durch die verhindern, dass der Agent richtig ausgeführt wird. Wenn der Kundenservicemitarbeiter erkennt, eine der Bedingungen erfüllt, protokolliert er eine Nachricht mit einer Beschreibung des Problems. Der Ops-Agent prüft Folgendes:
- Verbindungsprobleme
- Verfügbarkeit von Ports, die vom Agent zum Melden von Messwerten zu sich selbst verwendet werden
- Berechtigungsprobleme
- Verfügbarkeit der APIs, die vom Agent zum Schreiben von Logs oder Messwerten verwendet werden
- Ein Problem in der Systemdiagnose selbst.
In Version 2.37.0 werden Laufzeit-Systemdiagnosen für den Ops-Agent eingeführt. Diese Fehler werden an Cloud Logging und Error Reporting gemeldet. Informationen zum Suchen von Laufzeitfehlern finden Sie unter Laufzeitfehler finden.
Mit Version 2.46.0 wurden die
LogPingOpsAgent
-Code. Dieser Code stellt keinen Fehler dar.
Weitere Informationen finden Sie unter
Erfolgreiche Logerfassung prüfen.
In der folgenden Tabelle sind die Codes der Systemdiagnosen in alphabetischer Reihenfolge aufgeführt und eine Beschreibung ihrer Bedeutung. Codes, die mit dem String enden
Err
zeigen Fehler an. andere Codes dienen der Information.
Systemdiagnosecode | Kategorie | Bedeutung | Vorschlag |
---|---|---|---|
DLApiConnErr
|
Verbindung |
Anfrage an die Download-Subdomain dl.google.com fehlgeschlagen.
|
Prüfen Sie Ihre Internetverbindung und Ihre Firewallregeln. Weitere Informationen finden Sie unter <ph type="x-smartling-placeholder"></ph> Probleme mit der Netzwerkverbindung. |
FbMetricsPortErr
|
Portverfügbarkeit | Port 20202, das für die Ops-Agent-Self-Messwerte erforderlich ist, ist nicht verfügbar. | Prüfen Sie, ob Port 20202 geöffnet ist. Weitere Informationen finden Sie unter <ph type="x-smartling-placeholder"></ph> Der erforderliche Port ist nicht verfügbar. |
HcFailureErr
|
Allgemein | Bei der Systemdiagnose des Ops-Agents ist ein interner Fehler aufgetreten. | Stellen Sie eine Supportanfrage über die Google Cloud Console. Weitere Informationen erhalten Sie unter Support. |
LogApiConnErr
|
Verbindung | Anfrage an die Logging API fehlgeschlagen. | Prüfen Sie Ihre Internetverbindung und Ihre Firewallregeln. Weitere Informationen finden Sie unter <ph type="x-smartling-placeholder"></ph> Probleme mit der Netzwerkverbindung. |
LogApiDisabledErr
|
API | Die Logging API ist im aktuellen Google Cloud-Projekt deaktiviert. | Logging API aktivieren |
LogApiPermissionErr
|
Berechtigung |
Dem Dienstkonto fehlt die Rolle „Logautor“
(roles/logging.logWriter ).
|
Gewähren Sie die <ph type="x-smartling-placeholder"></ph> Rolle „Logautor“ mit dem Dienstkonto. Weitere Informationen finden Sie unter Agent fehlen API-Berechtigungen. |
LogApiScopeErr
|
Berechtigung | Auf der VM fehlt die URL https://www.googleapis.com/auth/logging.write. Zugriffsbereich. | Fügen Sie der VM den Bereich https://www.googleapis.com/auth/logging.write hinzu. Weitere Informationen finden Sie unter Zugriffsbereiche überprüfen. |
LogApiUnauthenticatedErr
|
API | Die aktuelle VM konnte nicht bei der Logging API authentifiziert werden. | Überprüfen Sie, ob Ihre Anmeldedatendateien, VM-Zugriffsbereiche und Berechtigungen korrekt eingerichtet sind. Weitere Informationen finden Sie unter Ops-Agent autorisieren. |
LogPingOpsAgent
|
Eine Nutzlastnachricht, die alle 10 Minuten in den
ops-agent-health -Log. Sie können das resultierende Protokoll verwenden,
um zu prüfen, ob der Agent Logs sendet. Diese Nachricht ist nicht
Fehler.
|
Diese Meldung wird voraussichtlich alle 10 Minuten angezeigt. Wenn die Meldung nach 20 Minuten oder länger nicht angezeigt wird, ist ein Problem aufgetreten. Informationen zur Fehlerbehebung finden Sie unter <ph type="x-smartling-placeholder"></ph> Fehler beim Ops-Agent beheben | |
LogParseErr
|
Laufzeit | Der Ops-Agent konnte ein oder mehrere Logs nicht parsen. | Prüfen Sie die Konfiguration aller von Ihnen erstellten Logging-Prozessoren. Weitere Informationen finden Sie unter Log-Parsing-Fehler. |
LogPipeLineErr
|
Laufzeit | Die Logging-Pipeline des Ops-Agents ist fehlgeschlagen. | Prüfen Sie, ob der Agent Zugriff auf die Pufferdateien hat. nach einem vollständige Festplatte und prüfen Sie, ob die Ops-Agent-Konfiguration korrekt ist. Weitere Informationen finden Sie unter <ph type="x-smartling-placeholder"></ph> Pipelinefehler. |
MetaApiConnErr
|
Verbindung | Anfrage an den G C E-Metadatenserver zur Abfrage von VM-Zugriffsbereichen Fehler bei OAuth-Tokens und Ressourcenlabels. | Prüfen Sie Ihre Internetverbindung und Ihre Firewallregeln. Weitere Informationen finden Sie unter <ph type="x-smartling-placeholder"></ph> Probleme mit der Netzwerkverbindung. |
MonApiConnErr
|
Verbindung | Eine Anfrage an die Monitoring API ist fehlgeschlagen. | Prüfen Sie Ihre Internetverbindung und Ihre Firewallregeln. Weitere Informationen finden Sie unter <ph type="x-smartling-placeholder"></ph> Probleme mit der Netzwerkverbindung. |
MonApiDisabledErr
|
API | Die Monitoring API ist im aktuellen Google Cloud-Projekt deaktiviert. | Aktivieren Sie die Monitoring-API. |
MonApiPermissionErr
|
Berechtigung |
Dem Dienstkonto fehlt die Rolle „Monitoring-Messwert-Autor“ (roles/monitoring.metricWriter ).
|
Weisen Sie dem Dienstkonto die Rolle „Monitoring-Messwert-Autor“ zu: Weitere Informationen finden Sie unter Agent fehlen API-Berechtigungen. |
MonApiScopeErr
|
Berechtigung | Auf der VM fehlt der Parameter https://www.googleapis.com/auth/monitoring.write. Zugriffsbereich. | Fügen Sie der VM den Bereich https://www.googleapis.com/auth/monitoring.write hinzu. Weitere Informationen finden Sie unter Zugriffsbereiche überprüfen. |
MonApiUnauthenticatedErr
|
API | Die aktuelle VM konnte keine Authentifizierung bei der Monitoring API durchführen. | Überprüfen Sie, ob Ihre Anmeldedatendateien, VM-Zugriffsbereiche und Berechtigungen korrekt eingerichtet sind. Weitere Informationen finden Sie unter Ops-Agent autorisieren. |
OtelMetricsPortErr
|
Portverfügbarkeit | Port 20201, erforderlich für die Ops-Agent-Self-Messwerte, ist nicht verfügbar. | Prüfen Sie, ob Port 20201 geöffnet ist. Weitere Informationen finden Sie unter <ph type="x-smartling-placeholder"></ph> Ein erforderlicher Port ist nicht verfügbar. |
PacApiConnErr
|
Verbindung | Dieser Systemdiagnosecode ist unzuverlässig. Dieser Code ist in der Ops-Agent-Version 2.46.1 deaktiviert. | Aktualisieren Sie auf Version Ops-Agent Version 2.46.1 oder höher. |
Startzeitfehler finden
Ab Version 2.35.0 werden Systemdiagnoseinformationen von der Cloud Logging API in das Log ops-agent-health
geschrieben (Versionen 2.33.0, 2.34.0 verwenden ops-agent-health-checks
).
Dieselben Informationen werden auch so in eine health-checks.log
-Datei geschrieben:
- Linux:
/var/log/google-cloud-ops-agent/health-checks.log
- Windows:
C:\ProgramData\Google\Cloud Operations\Ops Agent\log\health-checks.log
Um Systemdiagnose-Nachrichten aufzurufen, können Sie auch den Status des Ops-Agent-Dienstes so abfragen:
- Führen Sie unter Linux den folgenden Befehl aus:
sudo systemctl status google-cloud-ops-agent"*"
Suchen Sie nach Nachrichten wie „[Ports Check] Ergebnis: PASS“. Weitere Ergebnisse sind „FEHLER“ und „FEHLGESCHLAGEN“.
- Verwenden Sie unter Windows die Ereignisanzeige in Windows. Suchen Sie nach Nachrichten vom Typ „Informationen“, „Fehler“ oder „Fehlgeschlagen“ im Zusammenhang mit dem Dienst
google-cloud-ops-agent
.
Nachdem Sie alle Probleme behoben haben, Starten Sie den Agent neu. Die Systemdiagnosen werden beim Start des Agents ausgeführt. Um den müssen Sie den Agent neu starten.
Laufzeitfehler finden
Die Systemdiagnosen der Laufzeit werden sowohl an Cloud Logging als auch an Error Reporting gemeldet. Wenn der Agent nicht gestartet werden konnte, aber trotzdem zuvor Fehler melden konnte, werden möglicherweise auch Startzeitfehler gemeldet.
So rufen Sie Laufzeitfehler über den Ops-Agents in Logging auf:
-
Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.
Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
- Geben Sie die folgende Abfrage ein und klicken Sie auf Abfrage ausführen:
log_id("ops-agent-health")
So rufen Sie Laufzeitfehler des Ops-Agents in Error Reporting auf:
-
Rufen Sie in der Google Cloud Console die Seite Error Reporting auf:
Sie können diese Seite auch über die Suchleiste finden.
- Wenn Sie Fehler des Ops-Agents sehen möchten, filtern Sie die Fehler für
Ops Agent
.
Erfolgreiche Logerfassung prüfen
In Version 2.46.0 des Ops-Agents wurde die informative Systemdiagnose LogPingOpsAgent
eingeführt. Bei dieser Prüfung wird alle 10 Minuten eine Informationsnachricht in ops-agent-health
geschrieben.
Mit diesen Nachrichten können Sie prüfen, ob der Ops-Agent Logs schreibt:
- Suchen Sie in Logs einer bestimmten VM mit dem Log-Explorer nach den Ping-Nachrichten.
- Prüfen Sie den Wert des Messwerts
log_entry_count
für eine bestimmte VM mit dem Metrics Explorer. - Erstellen Sie eine Benachrichtigungsrichtlinie, um Sie zu benachrichtigen, wenn eine bestimmte VM den Messwert
log_entry_count
nicht aktualisiert.
Wenn eine dieser Optionen anzeigt, dass die Lognachrichten nicht aufgenommen werden, können Sie so vorgehen:
- Suchen Sie nach Fehlercodes, die auf Startfehler oder Laufzeitfehler hinweisen.
- Prüfen Sie, ob der Ops-Agent einsatzbereit ist.
- Führen Sie das Agent-Diagnoseskript aus.
Sie benötigen die Instanz-ID der VM, um den Status des Ops-Agents auf einer bestimmten VM zu prüfen. So finden Sie die Instanz-ID:
-
Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf:
Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.
- Klicken Sie auf den Namen einer VM-Instanz.
- Suchen Sie auf dem Tab Details den Abschnitt Allgemeine Informationen. Die Instanz-ID wird als numerischer String angezeigt. Verwenden Sie diesen String in den nachfolgenden Abschnitten für den Wert INSTANCE_ID.
Agent-Diagnosetool für VMs
Das Agent-Diagnosetool erfasst wichtige lokale Debugging-Informationen von Ihren VMs für alle folgenden Agents: Ops-Agent, Legacy-Logging-Agent und Legacy-Monitoring-Agent. Die Debugging-Informationen umfassen Informationen wie Projektinformationen, VM-Informationen, Agent-Konfiguration, Agent-Logs, Agent-Dienststatus und Informationen, die normalerweise manuell erfasst werden müssen. Das Tool prüft auch die lokale VM-Umgebung, um sicherzustellen, dass sie bestimmte Anforderungen erfüllt, damit die Agents ordnungsgemäß funktionieren, z. B. Netzwerkverbindung und erforderliche Berechtigungen.
Wenn Sie einen Kundenfall für einen Agent auf einer VM einreichen, führen Sie das Agent-Diagnosetool aus und hängen Sie die erfassten Informationen an den Fall an. Durch die Bereitstellung dieser Informationen reduziert sich der Zeitaufwand für die Fehlerbehebung in Ihrem Supportfall. Bevor Sie die Informationen an den Supportfall anhängen, entfernen Sie alle vertraulichen Informationen wie Passwörter.
Das Agent-Diagnosetool muss innerhalb der VM ausgeführt werden. Daher müssen Sie in der Regel zuerst eine SSH-Verbindung zur VM herstellen. Mit dem folgenden Befehl wird das Agent-Diagnosetool abgerufen und ausgeführt:
Linux
curl -sSO https://dl.google.com/cloudagents/diagnose-agents.sh
sudo bash diagnose-agents.sh
Windows
(New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/diagnose-agents.ps1", "${env:UserProfile}\diagnose-agents.ps1")
Invoke-Expression "${env:UserProfile}\diagnose-agents.ps1"
Folgen Sie der Ausgabe der Skriptausführung, um die Dateien zu finden, die die erfassten Informationen enthalten. In der Regel finden Sie diese im Verzeichnis /var/tmp/google-agents
unter Linux und im Verzeichnis $env:LOCALAPPDATA/Temp
unter Windows, es sei denn, Sie haben das Ausgabeverzeichnis beim Ausführen des Skripts angepasst.
Ausführliche Informationen finden Sie im Skript diagnose-agents.sh
unter Linux oder im Skript diagnose-agents.ps1
unter Windows.
Agent-Diagnosetool für Richtlinien zur automatischen Installation
Wenn der Ops-Agent mithilfe einer Ops-Agent-Betriebssystemrichtlinie fehlschlägt, können Sie das in diesem Abschnitt beschriebene Diagnosescript zum Debugging verwenden. Es kann sich beispielsweise um einen der folgenden Fälle handeln:
- Die Installation des Ops-Agents schlägt fehl, wenn Sie das Kästchen Ops-Agent für Monitoring und Logging installieren verwendet haben, um den Ops-Agent während der VM-Erstellung zu installieren.
Der Agent-Status im Cloud Monitoring-Dashboard VM-Instanzen oder der Tab Beobachtbarkeit auf einer Compute Engine-VM-Detailseite verbleibt mehr als 10 Minuten im Status Ausstehend. Ein längerer Status Ausstehend kann eine der folgenden Ursachen haben:
- Beim Anwenden der Richtlinie ist ein Problem aufgetreten.
- Ein Problem bei der tatsächlichen Installation des Ops-Agents.
- Ein Verbindungsproblem zwischen der VM und Cloud Monitoring.
Bei einigen dieser Probleme können auch das allgemeine Script „agent-diagnostics“ und die Systemdiagnosen hilfreich sein.
Führen Sie die folgenden Befehle aus, um das Script „policy-diagnostics“ auszuführen:
curl -sSO https://dl.google.com/cloudagents/diagnose-ui-policies.sh bash diagnose-ui-policies.sh VM_NAME VM_ZONE
Dieses Script enthält Informationen zu den betroffenen VMs und zugehörigen Richtlinien für die automatische Installation.
Wenn Sie einen Kundenfall für einen Agent auf einer VM einreichen, führen Sie die Agent-Diagnosetools aus und hängen Sie die erfassten Informationen an den Fall an. Durch die Bereitstellung dieser Informationen reduziert sich der Zeitaufwand für die Fehlerbehebung in Ihrem Supportfall. Bevor Sie die Informationen an den Supportfall anhängen, entfernen Sie alle vertraulichen Informationen wie Passwörter.
Agent-Self-Logs
Wenn der Agent keine Logs in Cloud Logging aufnehmen kann, müssen Sie Prüfen Sie die Logs des Agents lokal auf der VM zur Fehlerbehebung. Sie können auch die Logrotation verwenden, um die selbstbezogenen Logs des Agents zu verwalten.
Linux
Führen Sie den folgenden Befehl aus, um in Journald
geschriebene self-Logs zu prüfen:
journalctl -u google-cloud-ops-agent*
Führen Sie den folgenden Befehl aus, um die Self-logs zu prüfen, die vom Logging-Modul auf das Laufwerk geschrieben werden:
vim -M /var/log/google-cloud-ops-agent/subagents/logging-module.log
Windows
Führen Sie den folgenden Befehl aus, um in Windows Event Logs
geschriebene self-Logs zu prüfen:
Get-WinEvent -FilterHashtable @{ Logname='Application'; ProviderName='google-cloud-ops-agent*' } | Format-Table -AutoSize -Wrap
Führen Sie den folgenden Befehl aus, um die Self-logs zu prüfen, die vom Logging-Modul auf das Laufwerk geschrieben werden:
notepad "C:\ProgramData\Google\Cloud Operations\Ops Agent\log\logging-module.log"
Führen Sie den folgenden Befehl aus, um die Logs des Windows Service Control Manager
für Ops-Agent-Dienste zu prüfen:
Get-WinEvent -FilterHashtable @{ Logname='System'; ProviderName='Service Control Manager' } | Where-Object -Property Message -Match 'Google Cloud Ops Agent' | Format-Table -AutoSize -Wrap
Messwertnutzung und -diagnose in Cloud Monitoring ansehen
Auf der Cloud Monitoring-Seite Messwertverwaltung finden Sie Informationen, mit denen Sie den Betrag steuern können, den Sie für kostenpflichtige Messwerte ausgeben, ohne die Beobachtbarkeit zu beeinträchtigen. Die Seite Messwertverwaltung enthält folgende Informationen:
- Aufnahmevolumen für byte- und probenbasierte Abrechnung für Messwertdomains und einzelne Messwerte
- Daten zu Labels und zur Kardinalität von Messwerten
- Verwenden Messwerten in Benachrichtigungsrichtlinien und benutzerdefinierten Dashboards
- Rate von Messwert-Schreibfehlern
So rufen Sie die Seite Messwertverwaltung auf:
-
Wechseln Sie in der Google Cloud Console zur
Seite Messwertverwaltung:Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
- Wählen Sie in der Symbolleiste das Zeitfenster aus. Standardmäßig werden auf der Seite Messwertverwaltung Informationen zu den Messwerten angezeigt, die am Vortag erfasst wurden.
Weitere Informationen zur Seite Messwertverwaltung finden Sie unter Messwertnutzung ansehen und verwalten.