Aktualisierungsdatum: 06.01.2023
Google Cloud bietet Ihnen die Tools, mit denen Sie die Zuverlässigkeit Ihrer Projekte überwachen können mit Google Cloud Monitoring und Fehler beheben mit Google Cloud Logging Fehlerlogs. Wenn bei der Erfüllung von Nutzer-Intents ein Fehler auftritt, Die Google Home Analytics-Pipeline zeichnet diesen Fehler bei Ihren Messwerten auf. veröffentlicht ein Fehlerlog in Ihren Projektlogs.
Zur Fehlerbehebung sind zwei Schritte erforderlich:
- Behalte den Status deiner Projekte mit Smart-Home-Messwerten im Blick.
- Untersuchen Sie die Probleme, indem Sie die detaillierten Fehlerbeschreibungen in der Fehlerlogs.
Monitoringfehler
Sie können Google Cloud Monitoring dashboards verwenden um auf Ihre Projektmetriken zuzugreifen. Einige wichtige Diagramme sind besonders nützlich für die Qualitätsüberwachung und das Debugging:
- Das Diagramm Erfolgsquote ist das erste Diagramm, ab dem die Zuverlässigkeit Ihrer Projekte überwachen. Rückgänge in diesem Diagramm können auf einen Ausfall für einen Teil oder die gesamte Nutzerbasis hinweisen. Wir empfehlen, Sie überwachen dieses Diagramm nach jeder Änderung genau auf Unregelmäßigkeiten. oder ein Update für Ihr Projekt.
- Die Diagramme zur Fehleraufschlüsselung sind am nützlichsten für: Fehlerbehebung bei deinen Integrationen. Für jeden Fehler wird im Diagramm für den Erfolgsprozentsatz markiert, wird ein Fehlercode Fehleraufschlüsselung. Sie können die gemeldeten Fehler sehen, vom Google Home platform und zur Fehlerbehebung in der Tabelle unten.
Plattformfehlercodes
Im Folgenden finden Sie einige häufige Fehlercodes, die Sie möglicherweise in Ihren Projektprotokollen sehen, um von der Google Home platform erfasste Probleme identifizieren. Weitere Informationen finden Sie in der folgenden Tabelle mit Informationen zur Fehlerbehebung.
Fehlercode | Beschreibung |
---|---|
BACKEND_FAILURE_URL_ERROR |
Google hat von Ihrer Website einen anderen HTTP-Fehlercode 401 als 401 erhalten.
.
Verwenden Sie die requestId in GCP Logging, um Ihre intelligente
Protokolle von Haushaltsdienstleistungen.
|
BACKEND_FAILURE_URL_TIMEOUT |
Bei der Anfrage von Google kam es zu einer Zeitüberschreitung, als Sie versucht haben, Ihren Dienst zu erreichen.
Stellen Sie sicher, dass Ihr Dienst online ist und Verbindungen akzeptiert und nicht über der Kapazität liegt. Prüfen Sie außerdem, ob das Ziel das Gerät eingeschaltet, online und synchronisiert ist. |
BACKEND_FAILURE_URL_UNREACHABLE |
Google hat von Ihrem Dienst einen HTTP-Fehlercode 5xx erhalten.
Verwenden Sie die requestId in GCP Logging, um Ihre intelligente
Protokolle von Haushaltsdienstleistungen.
|
DEVICE_NOT_FOUND |
Das Gerät ist beim Partnerdienst nicht vorhanden.
Dies deutet in der Regel auf einen Fehler bei der Datensynchronisierung oder einen Race-Fehler hin. . |
GAL_BAD_3P_RESPONSE |
Google kann die Antwort von deinem Kontoverknüpfungsdienst nicht parsen
Format oder Werte in der Nutzlast ungültig.
Verwenden Sie requestId in GCP Logging, um Fehlerlogs zu prüfen
in Ihrem Kontoverknüpfungsdienst.
|
GAL_INTERNAL |
Beim Abrufen eines Fehlers ist ein interner Google-Fehler aufgetreten.
ein Zugriffstoken hinzufügen.
Wenn Sie eine erhöhte Fehlerrate in GCP Logging feststellen, wenden Sie sich an . |
GAL_INVALID_ARGUMENT |
Beim Abrufen eines Fehlers ist ein interner Google-Fehler aufgetreten.
ein Zugriffstoken hinzufügen.
Wenn Sie eine erhöhte Fehlerrate in GCP Logging feststellen, wenden Sie sich an . |
GAL_NOT_FOUND |
Die in Google gespeicherten Zugriffstokens und Aktualisierungstokens des Nutzers werden
ungültig gemacht und kann nicht mehr aktualisiert werden. Die Nutzenden müssen
Verknüpfen Sie das Konto wieder, um Ihren Dienst weiterhin nutzen zu können.
Wenn Sie eine erhöhte Fehlerrate in GCP Logging feststellen, wenden Sie sich an . |
GAL_PERMISSION_DENIED |
Ein interner Google-Fehler ist aufgetreten, wenn die Tokenfreigabe nicht
autorisiert wurde.
Wenn Sie eine erhöhte Fehlerrate in GCP Logging feststellen, wenden Sie sich an . |
GAL_REFRESH_IN_PROGRESS |
Das Zugriffstoken des Nutzers ist abgelaufen und es wird ein weiterer gleichzeitiger Versuch unternommen,
wird bereits aktualisiert.
Dies stellt kein Problem dar und Sie müssen nichts weiter tun. |
INVALID_AUTH_TOKEN |
Google hat von Ihrem Dienst den HTTP-Fehlercode 401 erhalten.
Das Zugriffstoken ist nicht abgelaufen, aber Ihr Dienst hat es ungültig gemacht. Verwenden Sie requestId in GCP Logging, um Ihre intelligente
Protokolle von Haushaltsdienstleistungen.
|
INVALID_JSON |
Die JSON-Antwort kann nicht geparst oder verstanden werden.
Prüfen Sie die Struktur Ihrer JSON-Antwort auf ungültige Syntax wie als nicht übereinstimmende Klammern, fehlende Kommas oder ungültige Zeichen. |
OPEN_AUTH_FAILURE |
Das Zugriffstoken des Nutzers ist abgelaufen und Google kann es nicht aktualisieren.
oder Google vom Dienst den HTTP-Fehlercode 401 erhalten hat.
Wenn Sie eine erhöhte Rate für diesen Code feststellen, prüfen Sie, ob Sie auch eine höhere Fehlerrate im Zusammenhang mit Smart-Home-Intents oder Aktualisierungen Token-Anfragen. |
PARTNER_RESPONSE_INVALID_ERROR_CODE |
Die Antwort zeigt einen unbekannten Fehlercode an.
Wenn in Ihrer Antwort auf einen Fehler ein Fehler vorliegt, verwenden Sie zur Verfügung gestellt von unserem unterstützten Fehlercodes. |
PARTNER_RESPONSE_INVALID_PAYLOAD |
Das Antwortfeld „payload “ kann nicht als JSON geparst werden
Objekt.
Prüfen Sie, ob das Nutzlastfeld in Ihrer Antwort auf die Anfrage übereinstimmende Werte enthält. Klammern und ist korrekt als JSON-Feld strukturiert. |
PARTNER_RESPONSE_INVALID_STATUS |
Die Antwort gibt keinen oder einen falschen Status an.
Antworten auf Anfragen zur Intent-Auftragsausführung sollten einen Status angeben entweder mit SUCCESS, OFFLINE, ERROR, EXCEPTIONS . Ich
finden Sie weitere Informationen zu
Umgang mit Fehlern und Ausnahmen.
|
PARTNER_RESPONSE_MISSING_COMMANDS_AND_DEVICES |
Mindestens ein Intent in der Anfrage fehlt im
Antwort.
Prüfen Sie, ob Ihr <ph type="x-smartling-placeholder"></ph> Ausführungsantwort korrekt strukturiert und die Ergebnisse für alle Intents aus der Anfrage sind in Ihrer Antwort vorhanden. |
PARTNER_RESPONSE_MISSING_DEVICE |
Mindestens ein in der Anfrage enthaltenes Gerät fehlt auf der
Antwort.
Prüfen Sie, ob Ihr <ph type="x-smartling-placeholder"></ph> Ausführungsantwort korrekt strukturiert ist und alle Geräte IDs aus der Anfrage sind in Ihrer Antwort enthalten. |
PARTNER_RESPONSE_MISSING_PAYLOAD |
Die Antwort enthält kein payload -Feld.
Achten Sie darauf, in Ihrer Antwort auf die Anfrage ein Nutzlastfeld anzugeben. Ich erfahren Sie mehr darüber, wie Sie <ph type="x-smartling-placeholder"></ph> Ausführungsantwort. |
PARTNER_RESPONSE_NOT_OBJECT |
Die Antwort kann nicht als JSON-Objekt geparst werden.
Prüfen Sie alle Felder in Ihrer Antwortanfrage auf unbeabsichtigte Zeichen. nicht übereinstimmende Klammern oder Formatierungsfehler. Einige Unicode-Zeichen wird möglicherweise nicht unterstützt. Achten Sie außerdem darauf, dass Ihre Antwort richtig ist. die als JSON-Objekt strukturiert sind. |
PROTOCOL_ERROR |
Fehler beim Verarbeiten der Anfrage.
Verwenden Sie die requestId in Google Cloud Logging, um Ihre
Smart-Home-Dienstprotokolle.
|
RESPONSE_TIMEOUT |
Zeitüberschreitung bei der Anfrage, während auf die Antwort gewartet wurde.
Die Zeitüberschreitung beim Senden einer Antwort beträgt 9 Sekunden ab dem wird die Anfrage gesendet. Antworte bitte innerhalb dieses Zeitraums der Zeit. |
RESPONSE_UNAVAILABLE |
Es wird keine Antwort empfangen oder die Antwort gibt keinen Status an.
Antworten auf Anfragen zur Intent-Auftragsausführung sollten strukturiert sein laut Smart-Home-Dokumente und den Status anzeigen. |
TRANSIENT_ERROR |
Ein vorübergehender Fehler ist ein Fehler, der von selbst behoben wird.
Meistens werden diese Fehler durch eine Verbindung zu einem Gerät oder dass der Dienst unterbrochen wird. Wenn neue Verbindungen zu einem Server nicht geöffnet. |
Suchprotokolle
Sobald Sie sich mit dem Monitoring Ihrer Integrationen mithilfe von Messwerten vertraut gemacht haben, bestimmte Fehler mithilfe Cloud Logging Ein Fehlerprotokoll ist Ein JSON-ähnlicher Eintrag mit Feldern, die nützliche Informationen wie Zeit, Fehler Code und Details zum ursprünglichen Smart-Home-Intent.
Mehrere Systeme in Google Cloud senden Protokolle an jederzeit und überall ein. Erforderliche Schritte Abfragen schreiben, um Logs zu filtern und die richtigen finden. Abfragen können auf einem Zeitraum basieren, Ressource, protokollieren Sie Schweregrad- oder benutzerdefinierte Einträge.
Mithilfe der Abfrageschaltflächen können Sie Ihre benutzerdefinierten Filter erstellen.
Um einen Zeitraum festzulegen, klicken Sie auf die entsprechende Schaltfläche zur Auswahl des Zeitraums
und wähle eine der verfügbaren Optionen. Dadurch werden die Logs gefiltert und nur diejenigen angezeigt, die aus dem ausgewählten Zeitraum.Um eine Ressource anzugeben, klicken Sie auf das Drop-down-Menü Ressource. und wählen Sie Google Assistant Action Project aus. Dadurch wird ein Filter um Logs aufzurufen, die aus Ihrem Projekt stammen.
Verwenden Sie die Schaltfläche Schweregrad, um nach Notfall, Info, Fehlerbehebung, und andere Schweregrad-Logebenen.
Sie können auch das Abfragefeld im Logs Explorer verwenden.
um benutzerdefinierte Einträge einzugeben. Die von diesem Feld verwendete Abfrage-Engine unterstützt sowohl
einfache Abfragen wie String-Abgleiche und komplexere Abfragetypen, einschließlich
Vergleichsoperatoren (<, >=, !=
) und boolesche Operatoren (AND, OR, NOT
) an.
Der benutzerdefinierte Eintrag unten würde beispielsweise Fehler zurückgeben, die
von einem LIGHT
-Gerätetyp stammen:
resource.type = "assistant_action_project" AND severity = ERROR AND jsonPayload.executionLog.executionResults.actionResults.device.deviceType = "LIGHT"
Abfragebibliothek finden Sie weitere Beispiele für effektive Abfragen von Logs.
Fehlerkorrekturen beim Testen
Nachdem Sie Fehler identifiziert und Aktualisierungen angewendet haben, um sie zu beheben, empfehlen wir, Tests durchzuführen. Ihre Korrekturen gründlich mit Google Home Test Suite Wir stellen Ihnen ein Nutzerhandbuch zur wie Sie Test Suite verwenden. Sie werden Schritt für Schritt durch das Testen Ihres effektiv ändern können.
Lernmaterialien
In diesem Dokument wird beschrieben, wie Sie Fehler in Ihrem Smart Home beheben. Action – Weitere Informationen zum Debugging finden Sie auch in unseren Codelabs:
- Fehlerbehebung im Smart-Home-Codelab Kurzanleitung zum Debuggen der Smart-Home-Cloud-Integration.
- Fehlerbehebung im Codelab für die lokale Startseite: Kurzanleitung zur Fehlerbehebung bei der lokalen Smart-Home-Integration.