Cloud Logging für Matter

Sie können über Google Cloud Logging auf Ereignislogs für Ihre Integrationen zugreifen. Mit Cloud Logging können Sie Logs untersuchen, Messwerte und Benachrichtigungen erstellen oder Logs mit Google Cloud Pub/Sub in andere Anwendungen exportieren.

Zugriffs-Logging

Wenn Sie über die Google Cloud Console auf Cloud Logging zugreifen möchten, klicken Sie auf Alle Produkte ansehen und dann auf Operations > Logging.

Zu Cloud Logging

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 unter Zugriffssteuerung für Cloud Logging .

Logeinträge werden gemäß der Aufbewahrungsrichtlinie für Cloud Logging 30 Tage lang aufbewahrt und dann zur Löschung geplant. 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 suchen der Anleitung zur Fehlerbehebung.

Cloud Logging bietet die folgenden Ressourcentypen:

Ressourcentyp Anzeigename Beschreibung Labels
assistant_action_project Google Assistant Action-Projekt Ein Container für das Google Cloud-Projekt, das mit einer Assistant Action verknüpft ist.
  • project_id: Die ID Ihres 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:

Attribut Beschreibung
requestId Eindeutige Anfrage-ID, z. B. 5325511189174727525.
latencyMsec Verstrichene Zeit, bevor eine Antwort eingegangen ist, z. B. 6000.
executionType Für die Anfrage verwendeter Transport, z. B. CLOUD oder MATTER, je nach Integration.
actionType Optionaler Indikator für die ausgeführte Nutzeraktion, z. B. QUERY oder EXECUTE. Bei EXECUTE Aktionen enthält dies den Befehl, der an die Ausführung für unterstützte Merkmale gesendet wurde, z. B. ONOFF_OFF
trait Optionales Merkmal, das 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 bei der lokalen Ausführung an die Cloud-Ausfü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 Ausführung bereitgestellten errorCode.
externalDebugString Optionale detaillierte Debugging-Nachricht, die mit dieser Nutzeraktion verknüpft ist.
locale Sprachcode, der mit der Anfrage verknüpft ist.

Logausschlüsse

Entwickler können Logausschlüsse mit der Logging-Abfragesprache erstellen, um ihre Logs flexibler anzupassen. Die Logging-Abfragesprache wird auch vom Log-Explorer verwendet. Sie können also Abfragen mit dem Log-Explorer erstellen.

Folgen Sie der Anleitung zum Erstellen von Ausschlussfiltern in dieser Anleitung (Ausschlussfilter für die _Default Senke konfigurieren).

Logbasierte Messwerte

Entwickler können logbasierte Messwerte verwenden, um Muster in ihren Logs zu verfolgen und zu analysieren. Außerdem können benutzerdefinierte Diagramme erstellt und Benachrichtigungen für logbasierte Messwerte eingerichtet werden.

Informationen zum Erstellen eines logbasierten Zählermesswerts für Smart Home finden Sie in dieser Anleitung. creating a counter log-based metric guide.

Weitere Informationen zur Verwendung von Cloud Logging in Ihrem Projekt finden Sie in der folgenden Dokumentation:

  • Preise: Details zu Kontingenten und Kosten für die Überschreitung von Kontingenten.
  • 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.