Über Google Cloud Logging können Sie auf Ereignislogs für Ihre Integrationen zugreifen. Verwenden Sie Cloud Logging, um mit Google Cloud Pub/Sub Logs zu durchsuchen, Messwerte und Benachrichtigungen zu erstellen oder in andere Anwendungen zu exportieren.
Zugriffs-Logging
Klicken Sie zum Aufrufen von Cloud Logging über Google Cloud Console auf Alle Produkte ansehen und rufen Sie dann Vorgänge > Logging auf.
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 Logging-Daten finden Sie in der Cloud Logging-Zugriffssteuerung.
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 Log-Explorer-Oberfläche löschen.
Weitere Informationen zur effektiven Nutzung von Logs finden Sie in der Anleitung zur Fehlerbehebung im Abschnitt „Logs suchen“.
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 einer Assistant-Aktion zugeordnet ist. |
|
Ereignisprotokolle
Projekte vom Typ Cloud-to-cloud unterstützen die folgenden Ereignisse in Cloud Logging:
| Cloud Logging-Ressource | Veranstaltung |
|---|---|
| Google Assistant Action-Projekt | SYNC-Intent-Fehler |
| Intent-Fehler vom Typ QUERY | |
| EXECUTE Intent-Fehler | |
| Benachrichtigungsfehler | |
| Fehler bei der Kontoverknüpfung | |
| Local Home SDK HandlerError |
Synchronisierungsprotokolle
In der folgenden Tabelle ist das Schema eines syncLog-Eintrags aufgeführt:
| Property | Beschreibung |
|---|---|
requestId |
Smart-Home-Intent-Anfrage-ID |
httpLatencyMsec |
Verstrichene Zeit, bevor eine Antwort eingegangen ist. |
status |
Gibt den Status der Intent-Antwort an. |
Ausführungsprotokolle
In der folgenden Tabelle ist das Schema eines executionLog-Eintrags aufgeführt:
| Property | Beschreibung |
|---|---|
requestId |
Eindeutige Anfrage-ID, z. B. 5325511189174727525. |
latencyMsec |
Verstrichene Zeit, bevor eine Antwort empfangen wurde, z. B. 6000. |
executionType |
Das für die Anfrage verwendete Transportmittel, z. B. CLOUD oder MATTER, je nach Ihrer Integration. |
actionType |
Optionaler Indikator der ausgeführten Nutzeraktion, z. B. QUERY oder EXECUTE.
Enthält für EXECUTE-Aktionen den Befehl, der für unterstützte Traits an die Auftragsausführung ausgegeben wird, z. B. ONOFF_OFF
|
trait |
Optionale Trait, die mit dieser Nutzeraktion verknüpft ist. |
deviceTypes |
Liste der Gerätetypen, die von dem 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 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 errorCode, der von der Auftragsausführung bereitgestellt wird.
|
externalDebugString |
Optionale ausführliche Debugging-Nachricht für diese Nutzeraktion. |
locale |
Der mit der Anfrage verknüpfte Sprachcode. |
Benachrichtigungsprotokolle
In der folgenden Tabelle ist das Schema eines notificationLog-Eintrags aufgeführt:
| Property | Beschreibung |
|---|---|
requestId |
Benachrichtigungsanfrage-ID. |
structName |
Name der Benachrichtigungsstruktur, z. B. "ObjectDetection". |
status |
Gibt den Status der Benachrichtigung an. |
Einstellung auf Protokollebene
Cloud-to-cloud-Projekte erhalten standardmäßig Fehlerlogs. Entwickler können den Erhalt von Erfolgslogs ebenfalls aktivieren. Dies ist besonders in der Entwicklungsphase nützlich, wenn Sie alle Logs von wenigen Agents erfassen möchten. Für Ihr Projekt können zusätzliche Gebühren anfallen, wenn Sie das Logging-Kontingent überschreiten.
Sie können die Logebene für Ihr Projekt folgendermaßen steuern:
Rufen Sie in Actions on Google Console die Seite „Projekte“ auf.
Wählen Sie Ihr Smart-Home-Projekt aus.
Wählen Sie den Tab Entwickeln aus und klicken Sie in der Seitenleiste auf Aktionen.
Wählen Sie in der Drop-down-Liste Log Control-Aufnahme die Option Alle aus.
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 ihn zum Erstellen von Abfragen verwenden können.
Sie können die Schritte zum Erstellen von Ausschlussfiltern in dieser Anleitung ausführen (konfigurieren Sie den Ausschlussfilter für die Senke _Default).
Logbasierte Messwerte
Entwickler können logbasierte Messwerte verwenden, um Muster in ihren Logs zu verfolgen und zu analysieren. Außerdem können Sie für logbasierte Messwerte benutzerdefinierte Diagramme erstellen und Benachrichtigungen einrichten.
Informationen zum Verwenden logbasierter Messwerte für Smart Homes finden Sie unter Leitfaden 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.