Über Google Cloud Logging können Sie auf Ereignislogs für Ihre Integrationen zugreifen. Verwenden Sie Cloud Logging, um Logs zu untersuchen, Messwerte und Benachrichtigungen zu erstellen oder Logs mit Google Cloud Pub/Sub in andere Anwendungen zu exportieren.
Zugriffs-Logging
Klicken Sie im Google Cloud Console auf Alle Produkte ansehen und rufen Sie dann Vorgänge > Logging auf, um auf Cloud Logging zuzugreifen.
Der Zugriff auf Logging-Daten wird über Identity and Access Management (IAM) für Nutzer Ihres Actions-Projekts verwaltet. Weitere Informationen zu Rollen und Berechtigungen für das Logging von Daten finden Sie unter Zugriffssteuerung in Cloud Logging.
Logeinträge werden gemäß der Aufbewahrungsrichtlinie von Cloud Logging 30 Tage lang aufbewahrt und dann zum Löschen vorgemerkt. Sie können Einträge auch bei Bedarf über die Benutzeroberfläche des Log-Explorers löschen.
Weitere Informationen zur effektiven Verwendung von Logs finden Sie im Abschnitt "Logs durchsuchen" der Anleitung zur Fehlerbehebung.
Cloud Logging stellt die folgenden Ressourcentypen bereit:
| Ressourcentyp | Anzeigename | Beschreibung | Labels |
|---|---|---|---|
assistant_action_project |
Google Assistant Action-Projekt | Ein Container für das Google Cloud-Projekt, das mit einer Assistant-Aktion verknüpft ist. |
|
Ausführungsprotokolle
In der folgenden Tabelle ist das Schema eines executionLog-Eintrags aufgeführt:
| Attribut | Beschreibung |
|---|---|
requestId |
Eindeutige Anfrage-ID, z. B. 5325511189174727525. |
latencyMsec |
Verstrichene Zeit bis zum Empfang einer Antwort, z. B. 6000. |
executionType |
Der für die Anfrage verwendete Transport, je nach Integration, z. B. CLOUD oder MATTER. |
actionType |
Optionaler Indikator für die durchgeführte Nutzeraktion, z. B. QUERY oder EXECUTE.
Beinhaltet für EXECUTE-Aktionen den Befehl, der für die Auftragsausführung für unterstützte Traits ausgegeben wird, z. B. ONOFF_OFF
|
trait |
Optionales Merkmal, das mit dieser Nutzeraktion verknüpft ist. |
deviceTypes |
Liste der Gerätetypen, die vom Ereignis betroffen sind, z. B. LIGHT. |
isSuccess |
Gibt an, ob die Anfrage eine erfolgreiche Antwort erhalten hat. |
fallbackToCloud |
Gibt an, ob die Anfrage nach einem Fehler aus der lokalen Auftragsausführung an die Cloud-Auftragsausführung weitergeleitet wurde. |
statusType |
Gibt den Status der Intent-Antwort an, z. B. SUCCESS, PENDING oder OFFLINE. Bei ERROR-Antworten enthält dieses Attribut den von der Auftragsausführung bereitgestellten errorCode.
|
externalDebugString |
Optionale detaillierte Debugging-Nachricht zu dieser Nutzeraktion. |
locale |
Der mit der Anfrage verknüpfte Sprachcode. |
Logausschlüsse
Entwickler können mit der Logging-Abfragesprache Logausschlüsse erstellen, um ihre Logs flexibler anzupassen. Die Logging-Abfragesprache wird auch vom Log-Explorer verwendet, sodass Sie mit dem Log-Explorer Abfragen erstellen können.
In dieser Anleitung erfahren Sie, wie Sie Ausschlussfilter erstellen und den Ausschlussfilter für die Senke _Default konfigurieren.
Logbasierte Messwerte
Entwickler können logbasierte Messwerte verwenden, um Muster in ihren Logs zu verfolgen und zu analysieren. Außerdem haben Sie die Möglichkeit, benutzerdefinierte Diagramme zu erstellen und Benachrichtigungen zu logbasierten Messwerten einzurichten.
Informationen zur Verwendung logbasierter Messwerte für Smart Homes finden Sie in der Anleitung zum Erstellen logbasierter Zählermesswerte.
Weitere Informationen
Weitere Informationen zur Verwendung von Cloud Logging in Ihrem Projekt finden Sie in der folgenden Dokumentation:
- Preise: Details zu Kontingenten und Überschreitungskosten.
- Kontingente und Limits: Details zu Limits und Aufbewahrungsrichtlinien für die Logging-Nutzung.
- Erweiterte Logabfragen: Anleitung zur Verwendung erweiterter Ausdrücke zum Abfragen und Analysieren von Logdaten.