Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.

Auf Ereignislogs mit Cloud Logging zugreifen

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Sie können über Google Cloud Logging 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 zum Aufrufen von Cloud Logging über Google Cloud Console auf Alle Produkte ansehen und dann auf Vorgänge > Logging.

Gehe zu Cloud Logging

Der Zugriff auf Logging-Daten wird für Nutzer Ihres Actions-Projekts über die Identitäts- und Zugriffsverwaltung (Identity and Access Management, IAM) verwaltet. Weitere Informationen zu Rollen und Berechtigungen für Logging-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 bei Bedarf auch über die Log-Explorer-Oberfläche löschen.

Weitere Informationen zur effektiven Verwendung von Logs finden Sie im Abschnitt „Logs suchen“ des Leitfadens 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-Aktion verknüpft ist.
  • project_id: Die ID des aktuellen Projekts, das mit dieser Ressource verknüpft ist, z. B. my-project.

Ereignisprotokolle

Cloud-to-cloud projects support the following events in Cloud Logging:

Cloud Logging-Ressource Veranstaltung
Google Assistant Action-Projekt SYNC-Intent-Fehler
Intent-Fehler für QUERY
EXECUTE-Intent-Fehler
Benachrichtigungen
Fehler bei der Kontoverknüpfung
Local Home SDK HandlerError

Logs synchronisieren

In der folgenden Tabelle ist das Schema eines syncLog-Eintrags aufgeführt:

Attribut Beschreibung
requestId Anfrage-ID für Smart-Home-Intent.
httpLatencyMsec Verstrichene Zeit, bevor eine Antwort empfangen wurde.
status Gibt den Status der Intent-Antwort an.

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 empfangen wurde, z. B. 6000.
executionType Für die Anfrage verwendeter Transport, z. B. CLOUD oder MATTER, je nach Integration.
actionType Optionaler Indikator 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 Merkmale ausgeführt wird, z. B. ONOFF_OFF
trait Optionales Merkmal, das mit dieser Nutzeraktion verknüpft ist.
deviceTypes Liste der vom Ereignis betroffenen Gerätetypen, 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 Auftragsausführung weitergeleitet wurde.
statusType Gibt den Status der Intent-Antwort an, z. B. SUCCESS, PENDING oder OFFLINE. Bei ERROR-Antworten enthält diese Property die errorCode, die von der Auftragsausführung bereitgestellt wird.
externalDebugString Optionale detaillierte Debug-Meldung, die mit dieser Nutzeraktion verknüpft ist.
locale Sprachcode, der der Anfrage zugeordnet ist.

Benachrichtigungsprotokolle

In der folgenden Tabelle ist das Schema eines notificationLog-Eintrags aufgeführt:

Attribut Beschreibung
requestId ID der Benachrichtigungsanfrage.
structName Name der Benachrichtigungsstruktur, z. B. „ObjectDetection“.
status Gibt den Status der Benachrichtigung an.

Einstellung auf Logebene

Cloud-to-cloud-Projekte sind standardmäßig so konfiguriert, dass sie Fehlerlogs empfangen. Entwickler können dem Erhalt von Erfolgslogs auch zustimmen. Dies ist besonders während der Entwicklungsphase nützlich, wenn Sie alle Logs von wenigen Agents erfassen möchten. Wenn Sie das Logging-Kontingent überschreiten, können für Ihr Projekt zusätzliche Gebühren anfallen.

Sie können die Logebene für Ihr Projekt so steuern:

  1. Im Actions on Google Console, go to the Projects page.

    Zur Actions on Google-Konsole

  2. Wählen Sie Ihr Smart-Home-Projekt aus.

  3. Wählen Sie den Tab Entwickeln aus und klicken Sie in der Seitenleiste auf Aktionen.

  4. Wählen Sie in der Drop-down-Liste Log-Steuerungsaufnahme die Option Alle aus.

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, sodass Sie mit dem Log-Explorer Abfragen erstellen können.

Sie können die Schritte zum Erstellen von Ausschlussfiltern in dieser Anleitung ausführen (Ausschlussfilter für die Senke _Default konfigurieren).

Logbasierte Messwerte

Entwickler können Log-basierte Messwerte verwenden, um Muster in ihren Logs nachzuverfolgen und zu analysieren. Sie können auch benutzerdefinierte Diagramme erstellen und Benachrichtigungen zu logbasierten Messwerten einrichten.

Wie Sie logbasierte Messwerte für Smart Home verwenden, erfahren Sie unter Logbasierte Zählermesswerte erstellen.

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

  • Preise: Details zu Kontingenten und Überschreitungsgebühren
  • Kontingente und Limits: Details zu Limits und Aufbewahrungsrichtlinien für die Logging-Nutzung.
  • Erweiterte Logabfragen: Anleitung zum Verwenden von erweiterten Ausdrücken zum Abfragen und Analysieren von Logdaten.