<ph type="x-smartling-placeholder"></ph> Cloud-zu-Cloud Rechtsangelegenheit
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:
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 – |
|
Ereignisprotokolle
Cloud-to-cloud Projekte unterstützen die folgenden Ereignisse in Cloud Protokollierung:
| Cloud Logging-Ressource | Ereignis |
|---|---|
| Google Assistant Action-Projekt | Intent-Fehler SYNC |
| QUERY-Intent-Fehler | |
| Intent-Fehler vom Typ EXECUTE | |
| Benachrichtigungen Fehler | |
| Kontoverknüpfung Fehler | |
| Local Home SDK <ph type="x-smartling-placeholder"></ph> 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 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. |
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 |
Gibt an, dass Status der Benachrichtigung. |
Einstellung auf Logebene
Cloud-to-cloud Projekte erhalten standardmäßig Fehlerlogs. und Entwickler haben auch die Möglichkeit, Erfolgsprotokolle zu aktivieren. Dies ist besonders in der Entwicklungsphase nützlich, wenn Sie Logs von einigen Agents abrufen. Für Ihr Projekt können zusätzliche Gebühren anfallen, wenn Sie übertreffen die Logging-Kontingent.
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
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
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.