In diesem Dokument werden Quellen von Diagnoseinformationen beschrieben, mit denen Sie Probleme bei der Installation oder Ausführung des Ops-Agents identifizieren können.
Agent-Status mit gcpdiag prüfen
Sie können gcpdiag verwenden, um den Status des Ops-Agent auf einzelnen VMs oder der gesamten VM-Flotte in Ihrem Projekt zu melden. So können Sie prüfen, ob der Agent installiert ist und aktiv Logs und Messwerte sendet. Mit gcpdiag können Sie Statusberichte in verschiedenen Formaten erstellen, einschließlich im CSV- 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, damit Sie häufige Probleme in Ihrem Google Cloud-Projekt, einschließlich Problemen mit dem Ops-Agent, selbst diagnostizieren können. „gcpdiag“ ist ein Open-Source-Tool, kein offizielles Google Cloud-Produkt, wird aber aktiv vom Google Cloud-Supportteam entwickelt und gewartet. Auf GitHub können Sie einen Beitrag leisten oder Probleme melden.
Hinweise
gcpdiag ist in Cloud Shell eingebunden, sodass Sie es ohne Installation ausführen können. Zum Ausführen von „gcpdiag“ müssen Sie zuerst die folgenden Voraussetzungen erfüllen:
Autorisierung: gcpdiag verwendet für die Authentifizierung die Standardanmeldedaten für Anwendungen in Cloud Shell.
Achten Sie darauf, dass die mit „gcpdiag“ verwendeten Anmeldedaten mindestens die folgenden Rollen für das Google Cloud-Projekt haben, 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 oder einer anderen Befehlszeile aus:
gcloud --project=PROJECT_ID services enable \ cloudresourcemanager.googleapis.com \ iam.googleapis.com \ logging.googleapis.com \ serviceusage.googleapis.com \
- Cloud Resource Manager API:
VM Manager: Aktivieren Sie VM Manager in der kostenlosen Stufe auf Ihrer Instanz. Wenn Sie den Ops-Agent während der VM-Erstellung installiert haben oder die Installation des Ops-Agents auf Ihren VM-Instanzen von einer Agent-Richtlinie verwaltet wird, haben Sie die Anforderungen für VM Manager bereits erfüllt.
„gcpdiag“ ausführen
Der Befehl gcpdiag
für den 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. Lassen Sie die Option zum Abfragen der gesamten Flotte weg. - Verwenden Sie die Option
--output
, um den Bericht in einer CSV- oder JSON-formatierten Datei zu speichern. Lassen Sie sie weg, wenn Sie keine Ausgabedatei wünschen.
Mit dem Wert der Option --include
werden eine oder mehrere gcpdiag-Regeln angegeben. gce/ERR/2024-004
ist die Regel für den Ops-Agent.
Weitere Informationen zur Syntax des Befehls „gcpdiag“ finden Sie unter gcpdiag – Diagnose der Google Cloud Platform.
Führen Sie beispielsweise den folgenden Befehl aus, um einen flottenweiten Bericht für das Projekt „my-project“ zu generieren:
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.
Führen Sie den folgenden Befehl aus, um einen Bericht für die Instanz "my-instance" im Projekt "my-project" zu erstellen:
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 der folgenden fehlschlägt, sollten Sie prüfen, ob alle Voraussetzungen für die Ausführung des Tools erfüllt sind.
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 von gcpdiag generierten Berichte.
Der Befehl „gcpdiag“ generiert Berichte, die die folgenden Informationen enthalten:
- 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. Bei einem flottenweiten Bericht enthält die Ausgabe einen Eintrag für jede VM. Bei einem Bericht für eine einzelne VM enthält die Ausgabe einen einzelnen Eintrag.
- Der Status der Diagnose. Der Status hat einen der folgenden Werte:
- Eine Beschreibung des Statuswerts.
In den folgenden Abschnitten finden Sie weitere Informationen zu den Statuswerten und ihrer Bedeutung.
Status: OK
Der Status OK
bedeutet, dass der Ops-Agent auf der VM ausgeführt wird und sowohl Logs als auch Messwerte von der VM sendet. 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 nicht sowohl Logs als auch Messwerte von der VM sendet. Die Statusbeschreibung gibt an, welches Problem erkannt wurde:
- Wenn der Ops-Agent nicht installiert ist, wird die folgende Statusbeschreibung angezeigt:
Ops Agent not installed on the VM
- Wenn der Ops-Agent nicht sowohl Logs als auch Messwerte von der VM sendet, wird eine Statusbeschreibung wie die folgende angezeigt:
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 Probleme vorliegen:
- Der VM ist kein Dienstkonto zugeordnet. Hängen Sie ein Dienstkonto an die VM an und versuchen Sie dann noch einmal, den Ops-Agent zu installieren, um dieses Problem zu beheben.
- Auf der VM ist einer der Legacy-Agents (der Monitoring-Agent oder der Logging-Agent) bereits installiert. Deinstallieren Sie die Legacy-Agents und versuchen Sie dann noch einmal, den Ops-Agent zu installieren, um dieses Problem zu beheben.
Wenn der Ops-Agent keine Logs oder Messwerte von der VM sendet, verwenden Sie die Systemdiagnosen des Agents auf Startfehler, um das Problem zu ermitteln und zu beheben.
Status: SKIP
Der Status SKIP
bedeutet, dass gcpdiag nicht feststellen konnte, ob der Ops-Agent auf der VM installiert ist. Der Bericht enthält die folgende 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 Status des Agents muss für gcpdiag auf Ihrer VM VM Manager ausgeführt werden. Installieren Sie die kostenlose VM Manager-Stufe auf Ihrer Instanz, um dieses Problem zu beheben. Warten Sie nach der Installation 15 Minuten und versuchen Sie dann noch einmal, den Befehl gcpdiag
auszuführen.
Agent-Systemdiagnosen
Mit Version 2.25.1 wurden Systemdiagnosen beim Start für den Ops-Agent eingeführt. Wenn der Ops-Agent gestartet wird, führt er eine Reihe von Prüfungen auf Bedingungen durch, die verhindern, dass der Agent korrekt ausgeführt wird. Wenn der Agent eine der Bedingungen erkennt, protokolliert er eine Nachricht, in der das Problem beschrieben wird. 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 wurde der Informationscode LogPingOpsAgent
eingeführt. 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 Err
enden, weisen auf Fehler hin. Andere Codes dienen nur zu Informationszwecken.
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 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 Erforderlicher 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 Probleme mit der Netzwerkverbindung. |
LogApiDisabledErr
|
API | Die Logging API ist im aktuellen Google Cloud-Projekt deaktiviert. | Aktivieren Sie die Logging API. |
LogApiPermissionErr
|
Berechtigung |
Dem Dienstkonto fehlt die Rolle „Logautor“ (roles/logging.logWriter ).
|
Gewähren Sie dem Dienstkonto die Rolle Logautor. Weitere Informationen finden Sie unter Agent fehlen API-Berechtigungen. |
LogApiScopeErr
|
Berechtigung | Der VM fehlt der Zugriffsbereich https://www.googleapis.com/auth/logging.write. | 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 Informationsnutzlastnachricht, die alle 10 Minuten in das Log ops-agent-health geschrieben wird. Anhand der resultierenden Logeinträge können Sie prüfen, ob der Agent Logs sendet. Dies ist kein Fehler.
|
Diese Meldung wird voraussichtlich alle 10 Minuten angezeigt. Wenn die Nachricht 20 Minuten oder länger nicht angezeigt wird, hat der Kundenservicemitarbeiter möglicherweise ein Problem festgestellt. Informationen zur Fehlerbehebung finden Sie unter Fehlerbehebung für den Ops-Agent. | |
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 Zwischenspeicherdateien hat. Prüfen Sie, ob ein volles Laufwerk vorhanden ist, und prüfen Sie, ob die Ops-Agent-Konfiguration korrekt ist. Weitere Informationen finden Sie unter Pipelinefehler. |
MetaApiConnErr
|
Verbindung | Die Anfrage an den G C E-Metadatenserver zum Abfragen von VM-Zugriffsbereichen, OAuth-Tokens und Ressourcenlabels ist fehlgeschlagen. | Prüfen Sie Ihre Internetverbindung und Ihre Firewallregeln. Weitere Informationen finden Sie unter 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 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 | Der VM fehlt der Zugriffsbereich https://www.googleapis.com/auth/monitoring.write. | 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 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 ops-agent-health
-Log geschrieben (die Versionen 2.33.0 und 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, müssen Sie den Agent neu starten. Die Systemdiagnosen werden beim Start des Agents ausgeführt. Wenn Sie die Prüfungen also noch einmal ausführen möchten, 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 auf eine der folgenden Ursachen hinweisen:
- 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 die Logs des Agents möglicherweise lokal auf der VM zur Fehlerbehebung überprüfen. 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:
-
Rufen Sie in der Google Cloud Console die Seite
Messwertverwaltung auf: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.