Cloud Logging für Matter

Auf Ereignisprotokolle für deine Integrationen kannst du über Google Cloud Logging Verwenden Sie Cloud Logging, um Logs zu untersuchen, Messwerte und Benachrichtigungen zu erstellen oder die Logs in andere Anwendungen mit Google Cloud Pub/Sub

Zugriffs-Logging

Zugriff auf Cloud Logging über die Google Cloud Console, Klicken Sie auf Alle Produkte ansehen und dann auf Vorgänge > Logging:

Gehe zu Cloud Logging

Der Zugriff auf Logging-Daten wird über Identity and Access Management (IAM) verwaltet für Nutzer Ihres Actions-Projekts. Weitere Informationen zu Rollen und Berechtigungen für Logging-Daten finden Sie unter Cloud Logging Zugriffssteuerung.

Logeinträge werden gemäß Cloud Logging 30 Tage lang aufbewahrt. Aufbewahrungsrichtlinie zum Löschen vorgemerkt. Sie können Einträge auch bei Bedarf mit dem Log-Explorer-Oberfläche

Weitere Informationen zur effektiven Verwendung von Protokollen finden Sie im Abschnitt zum Durchsuchen von Protokollen. in 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 einem Assistant verknüpft ist Action –
  • project_id: Die Kennung Ihres aktuellen Projekts. die dieser Ressource zugeordnet 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 bis zum Eingang einer Antwort, z. B. 6000
executionType Der für die Anfrage verwendete Transport, z. B. CLOUD oder MATTER, je nach Integration.
actionType Optionaler Indikator für die durchgeführte Nutzeraktion, z. B. QUERY oder EXECUTE. Enthält für EXECUTE-Aktionen den Befehl, der an Auftragsausführung für unterstützte Traits, 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 an die Cloud-Auftragsausführung weitergeleitet wurde der lokalen Auftragsausführung.
statusType Gibt den Status der Intent-Antwort an, z. B. SUCCESS, PENDING oder OFFLINE. Für ERROR enthält, enthält diese Property Das von der Auftragsausführung bereitgestellte errorCode.
externalDebugString Optionale detaillierte Debugging-Nachricht im Zusammenhang mit dieser Nutzeraktion.
locale Der mit der Anfrage verknüpfte Sprachcode.

Logausschlüsse

Entwickelnde können Logausschlüsse mit Logging-Abfrage Sprache um ihre Logs flexibler anzupassen. Logging-Abfragesprache wird auch vom Log-Explorer verwendet, sodass Sie mit dem Log-Explorer Abfragen.

Eine Anleitung zum Erstellen von Ausschlussfiltern erhalten Sie unter dieser Anleitung Konfigurieren Sie den Ausschlussfilter für die Senke _Default.

Logbasierte Messwerte

Entwickler können Logbasierte Messwerte um Muster in ihren Logs zu verfolgen und zu analysieren. Es ist auch möglich, Benutzerdefinierte Diagramme erstellen und Benachrichtigungen einrichten zu logbasierten Messwerten.

Informationen zur Verwendung logbasierter Messwerte für Smart Homes findest du in Leitfaden zum Erstellen eines logbasierten Zählermesswerts

Weitere Informationen zur Verwendung von Cloud Logging in Ihrem Projekt finden Sie in den 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 von erweiterten Ausdrücken zum Abfragen und Analysieren von Logdaten.