Ü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 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.
Der Zugriff auf Logging-Daten wird für Nutzer des Actions-Projekts über Identity and Access Management (IAM) verwaltet. Weitere Informationen zu Rollen und Berechtigungen für das Logging von Daten finden Sie unter Cloud Logging-Zugriffssteuerung.
Logeinträge werden gemäß der Aufbewahrungsrichtlinie für Cloud Logging 30 Tage lang aufbewahrt und dann zum Löschen vorgemerkt. Sie können Einträge auch bei Bedarf mit der Log-Explorer-Oberfläche löschen.
Weitere Informationen zur effektiven Verwendung von Logs finden Sie in der Anleitung zur Fehlerbehebung im Abschnitt „Suchprotokolle“.
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. |
|
Ereignisprotokolle
Cloud-to-cloud-Projekte unterstützen die folgenden Ereignisse in Cloud Logging:
| Cloud Logging-Ressource | Veranstaltung |
|---|---|
| Google Assistant Action-Projekt | SYNC-Intent-Fehler |
| QUERY-Intent-Fehler | |
| EXECUTE-Intent-Fehler | |
| Fehler durch Benachrichtigungen | |
| Fehler bei der Kontoverknüpfung | |
| Local Home SDK HandlerError |
Logs synchronisieren
In der folgenden Tabelle ist das Schema eines syncLog-Eintrags aufgeführt:
| Property | Beschreibung |
|---|---|
requestId |
Smart-Home-Intent-Anfrage-ID. |
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:
| Property | 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 Einbindung. |
actionType |
Optionaler Indikator für die Nutzeraktion, z. B. QUERY oder EXECUTE.
Enthält für EXECUTE-Aktionen den Befehl, der für die Auftragsausführung für unterstützte Eigenschaften ausgegeben wird, z. B. ONOFF_OFF
|
trait |
Optionale Eigenschaft, die dieser Nutzeraktion zugeordnet 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 bei 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 von der Auftragsausführung.
|
externalDebugString |
Optionale Nachricht zur Fehlerbehebung, 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:
| Property | Beschreibung |
|---|---|
requestId |
ID der Anfrage. |
structName |
Name der Benachrichtigungsstruktur, z. B. "ObjectDetection". |
status |
Gibt den Status der Benachrichtigung an. |
Einstellung auf Protokollebene
Cloud-to-cloud-Projekte sind standardmäßig so konfiguriert, dass sie Fehlerlogs empfangen. Entwickler können dem Erhalt von Logs aber auch zustimmen. Dies ist besonders während der Entwicklungsphase nützlich, wenn Sie alle Logs von einigen Agents erfassen möchten. Wenn Sie das Logging-Kontingent überschreiten, können zusätzliche Gebühren für Ihr Projekt anfallen.
Sie können die Logebene für Ihr Projekt so steuern:
Rufen Sie in Actions on Google Console die Seite „Projekte“ auf.
Wählen Sie Ihr Smart-Home-Projekt aus.
Wählen Sie den Tab Entwickeln aus und klicken Sie in der Seitenleiste auf Aktionen.
Wählen Sie in der Drop-down-Liste Logcontrol-Aufnahme die Option Alle aus.
Logausschlüsse
Entwickler können mithilfe von Logging-Abfragesprachen 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.
Führen Sie die Schritte zum Erstellen von Ausschlussfiltern in dieser Anleitung aus. Konfigurieren Sie den Ausschlussfilter für die Senke _Default.
Logbasierte Messwerte
Entwickler können mithilfe von logbasierten Messwerten Muster in ihren Logs verfolgen und analysieren. Sie können auch benutzerdefinierte Diagramme erstellen und Benachrichtigungen zu logbasierten Messwerten einrichten.
Informationen zum Verwenden von logbasierten Messwerten für Smart Home finden Sie unter Logbasierte Zählermesswerte erstellen.
Weitere Ressourcen
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 zum Verwenden erweiterter Ausdrücke zum Abfragen und Analysieren von Logdaten