Über Google Cloud Logging können Sie 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 im Google Cloud Console auf Alle Produkte ansehen und rufen Sie dann Vorgänge > Logging auf, um auf Cloud Logging zuzugreifen.
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 das Logging von 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 auch bei Bedarf über die Benutzeroberfläche des Log-Explorers löschen.
Weitere Informationen zur effektiven Verwendung von Logs finden Sie im Abschnitt "Logs durchsuchen" 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 einer Assistant-Aktion verknüpft ist. |
|
Ereignisprotokolle
Cloud-to-cloud-Projekte unterstützen die folgenden Ereignisse in Cloud Logging:
| Cloud Logging-Ressource | Veranstaltung |
|---|---|
| Google Assistant Action-Projekt | Intent-Fehler SYNC |
| QUERY-Intent-Fehler | |
| Intent-Fehler vom Typ EXECUTE | |
| Benachrichtigungen | |
| Fehler bei der Kontoverknüpfung | |
| Local Home SDK HandlerError |
Protokolle 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 bis zum Eingang einer Antwort. |
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 bis zum Empfang einer Antwort, z. B. 6000. |
executionType |
Der für die Anfrage verwendete Transport, je nach Integration, z. B. CLOUD oder MATTER. |
actionType |
Optionaler Indikator für die durchgeführte Nutzeraktion, z. B. QUERY oder EXECUTE.
Beinhaltet für EXECUTE-Aktionen den Befehl, der für die Auftragsausführung für unterstützte Traits ausgegeben wird, z. B. ONOFF_OFF
|
trait |
Optionales Merkmal, das 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 aus 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 von der Auftragsausführung bereitgestellten errorCode.
|
externalDebugString |
Optionale detaillierte Debugging-Nachricht zu dieser Nutzeraktion. |
locale |
Der mit der Anfrage verknüpfte Sprachcode. |
Benachrichtigungsprotokolle
In der folgenden Tabelle ist das Schema eines notificationLog-Eintrags aufgeführt:
| Attribut | Beschreibung |
|---|---|
requestId |
Benachrichtigungsanfrage-ID. |
structName |
Name der Benachrichtigungsstruktur, z. B. "ObjectDetection". |
status |
Zeigt den Status der Benachrichtigung an. |
Einstellung auf Logebene
Cloud-to-cloud-Projekte sind so eingestellt, dass sie standardmäßig Fehlerlogs erhalten. Außerdem können Entwickler dem Erhalt von Erfolgslogs auch zustimmen. Dies ist besonders in der Entwicklungsphase nützlich, wenn Sie alle Logs von einigen Agents erfassen möchten. Wenn Sie das Logging-Kontingent überschreiten, können zusätzliche Kosten für Ihr Projekt anfallen.
Sie können die Logebene für Ihr Projekt folgendermaßen steuern:
Rufen Sie in der Actions on Google Console die Seite „Projekte“ auf.
Wählen Sie Ihr Smart-Home-Projekt aus.
Wählen Sie den Tab Develop aus und klicken Sie in der Seitenleiste auf Aktionen.
Wählen Sie in der Drop-down-Liste Aufnahme der Log-Steuerelemente 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 mit dem Log-Explorer Abfragen erstellen können.
In dieser Anleitung erfahren Sie, wie Sie Ausschlussfilter erstellen und den Ausschlussfilter für die Senke _Default konfigurieren.
Logbasierte Messwerte
Entwickler können logbasierte Messwerte verwenden, um Muster in ihren Logs zu verfolgen und zu analysieren. Außerdem haben Sie die Möglichkeit, benutzerdefinierte Diagramme zu erstellen und Benachrichtigungen zu logbasierten Messwerten einzurichten.
Informationen zur Verwendung logbasierter Messwerte für Smart Homes finden Sie in der Anleitung 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.