Cloud Logging für Matter

Sie können über Google Cloud Logging 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 Logs in andere Anwendungen zu exportieren.

Zugriffs-Logging

Für den Zugriff auf Cloud Logging über Google Cloud Console klicken Sie auf Alle Produkte ansehen und rufen dann Vorgänge > Logging auf.

Zu Cloud Logging

Der Zugriff auf Logging-Daten wird für Nutzer Ihres Actions-Projekts über Identity and Access Management (IAM) verwaltet. Weitere Informationen zu den Rollen und Berechtigungen für Logging-Daten finden Sie in der Zugriffssteuerung für 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 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 mit einer Assistant-Aktion verknüpft ist.
  • project_id: Die ID des aktuellen Projekts, das mit dieser Ressource verknüpft ist, z. B. my-project.

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 eingegangen ist, z. B. 6000.
executionType Transportmittel, das für die Anfrage verwendet wird, je nach Einbindung CLOUD oder MATTER.
actionType Optionale Anzeige der ausgeführten Nutzeraktion, z. B. QUERY oder EXECUTE. Enthält für EXECUTE-Aktionen den Befehl, der für die Auftragsausführung für unterstützte Traits ausgegeben wird, z. B. ONOFF_OFF
trait Optionale Eigenschaft, die 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 bei 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 detaillierte Debugging-Nachricht, die mit dieser Nutzeraktion verknüpft ist.
locale Der mit der Anfrage verknüpfte Sprachcode.

Logausschlüsse

Entwickler können mit der Logging-Abfragesprache Logausschlüsse erstellen und ihre Logs so flexibler anpassen. Die Logging-Abfragesprache wird auch vom Log-Explorer verwendet, sodass Sie den Log-Explorer 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. Es ist auch möglich, für logbasierte Messwerte benutzerdefinierte Diagramme zu erstellen und Benachrichtigungen einzurichten.

Informationen zum Verwenden logbasierter Messwerte für Smart Homes finden Sie im Leitfaden zum Erstellen logbasierter Zählermesswerte.

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.