Bewirb dich für das private Betaprogramm, um mit der Entwicklung von Matter-Geräten und -Apps in der Google Home Console zu beginnen. Jetzt bewerben

Ausfälle bei Smart-Home-Geräten überwachen

1. Hinweis

Wie bereits im Codelab zu Debugging des Smart Homes erläutert, veröffentlichen wir Messwerte und Protokolle für Ihre Smart-Home-Projekte. Anhand von Messwerten können Sie feststellen, wo Probleme mit Ihrer Smart-Home-Aktion auftreten. Logs sind nützlich, um diese Probleme zu beheben.

dd44868a4ff2df6e.png

Sie können Benachrichtigungen mithilfe der für Ihr Projekt bereitgestellten Messwerte einrichten, um Ausfälle automatisch zu überwachen und Benachrichtigungen bei Dienstunterbrechungen zu erhalten. Wir veröffentlichen einen Konfidenzmesswert, um die Unterbrechungen Ihres Projekts hervorzuheben. Wir werden in diesem Codelab zusammen mit allen anderen Benachrichtigungstools auf der Google Cloud Platform darauf eingehen.

Voraussetzungen

Lerninhalte

  • Wie Sie Leistungsprobleme und Dienstunterbrechungen bei Ihrem Projekt im Blick behalten
  • Hier erfahren Sie, wie Sie einen Schwellenwert einrichten und Benachrichtigungen erhalten, wenn Unterbrechungen auftreten.
  • Hier erfahren Sie, wie Sie den Konfidenzmesswert für Ihr Projekt verwenden, um Ausfälle zu erkennen.

2. Leistungsbewertung

Das Monitoring der Leistung ist entscheidend für eine erfolgreiche Integration mit Google Smart Home Ecosystem. Smart-Home-Entwicklern stehen auf der Google Cloud Platform verschiedene Monitoring-Tools zur Verfügung. Mithilfe dieser Tools kannst du dich ein Bild von der Leistung deines Projekts machen.

Auf Dashboards zugreifen

Der erste Schritt zum Zugriff auf Ihre Daten besteht darin, Google Home-Dashboards zu prüfen. Melden Sie sich dazu in der Google Cloud Console an und klicken Sie auf Vorgänge > Monitoring > Dashboards. Sie werden sehen, dass eine Reihe von Dashboards verfügbar ist und die Smart-Home-Dashboards ein Präfix für Google Home Analytics haben.

317697e52ced2437

Wir haben für jeden Integrationstyp ein eigenes Dashboard erstellt. Cloud-, Lokale und Matter-Integrationen haben ein eigenes Dashboard und die Daten für das Kamera-Streamingprotokoll werden im Dashboard "Kameraqualität" bereitgestellt. Diese Dashboards enthalten nur Daten, wenn Sie eine Verknüpfung des entsprechenden Typs und eines funktionierenden Projekts haben, das die Anfragen erfüllt.

Wenn Sie eines dieser Dashboards öffnen, sieht die Ansicht so aus:

f8bfd69286c569a4

Dashboards enthalten verschiedene Diagramme mit Details zu den von Ihrem Projekt verarbeiteten Anfragen. Zu jedem Integrations-Dashboard gehören ein Diagramm mit der Gesamtzahl der Anfragen, die von deinem Projekt verarbeitet werden, ein Diagramm, aus dem die Erfolgsquote für diesen Integrationstyp hervorgeht, und mehrere Diagramme mit den verwendeten Gerätetypen und Merkmalen.

Es gibt drei Diagramme, die die Leistung Ihrer Smart-Home-Aktionen kritisch beurteilen:

f511fafd3aaaa1eb.png

Bei Ausfällen sehen Sie häufig Trends in Bezug auf den Erfolgsprozentsatz und einen Anstieg im Fehleraufschlüsselungsdiagramm. Wenn Sie den Ausführungserfolg in Prozent beobachten, können Sie den Ausfall ermitteln. Während der Fehlerbehebung können Sie sich die häufigsten Fehler in der Fehleraufschlüsselung ansehen. Möglicherweise bemerken Sie auch einen Anstieg der Latenz bei Ausfällen, wie Sie in den Diagrammen zur Anfragelatenz erkennen können.

Die Standardansicht mit Diagrammen, die auf den Google Home Analytics-Dashboards angezeigt wird, ist nur eine Datenansicht, die wir für Ihr Projekt mit Smart-Home-Messwertdaten erstellt haben. Außerdem haben Sie die Möglichkeit, mit Metrics Explorer eigene Diagramme aus denselben zugrunde liegenden Messwerten zu erstellen und in Ihren benutzerdefinierten Dashboards zu speichern.

Metrics Explorer

Metrics Explorer ist ein Tool, um Querabschnitte Ihres Projekts zu visualisieren. Sie können auf das Tool in der Google Cloud Console zugreifen, indem Sie Operations > Monitoring > Metrics Explorer aufrufen.

Google Cloud bietet zahlreiche Messwerte an, auch solche, die nichts mit Smart Home zu tun haben. Die von uns für Smart-Home-Geräte verfügbaren Messwerte findest du unter „"actions.googleapis.com/smarthome_action/...". Diese Ressourcen können einfach durch Eingabe von „&home“ in das Messwertauswahlfeld eingegeben werden.

538d851edfd34764.png

Wenn du nach „Smarthome“ suchst, werden alle Smart-Home-Messwerte für dein Projekt angezeigt. Ausführliche Informationen zu jedem unserer Messwerte finden Sie in der Dokumentation auf der Seite Monitoring und Logging.

Der einfachste Messwert für das Monitoring Ihres Projekts ist der Anzahl der Anfragen. Dieser Messwert ist ein Deltamesswert. Hier wird ein Eintrag für jede von Ihren Nutzern initiierte Smart-Home-Ausführung erfasst. Darüber hinaus werden Felder für den Gerätetyp, die Eigenschaft, die Art der Ausführung und das Statusfeld mit dem Ergebnis aufgezeichnet.

Wenn Sie diesen Messwert auswählen, wird ein Bildschirm mit folgenden Daten angezeigt:

b1c18141d15a0e09.png

Im Grunde gibt es für jede Kombination aus Datenlabels, die in diesem Messwert vorhanden sind, einen Bucket, der die Änderung (Delta) zwischen dem vorherigen und dem aktuellen Zeitintervall erfasst. Sie können diese Buckets gruppieren oder herausfiltern, um den gewünschten Datenansichtsdatenabschnitt abzurufen. Außerdem werden die Daten mit einer Ausrichtungsfunktion (DELTA, MEAN, MEDIAN, SUM) mit den ausgewählten Zeitintervallen ausgerichtet. Sofern nicht anders angegeben, verwenden Sie in der Regel die Deltaausrichtung mit einem Deltamesswert.

Mit Metrics Explorer können Sie die meisten in Google Home Analytics-Dashboards verfügbaren Diagramme erstellen und für einen späteren Zugriff in einem benutzerdefinierten Dashboard speichern. Für komplexere Ansichten, z. B. ein Verhältnisdiagramm, müssen Sie MQL – Monitoring Query Language verwenden.

3. Erfolgsmessdaten

Sie können entweder die Erfolgsquote, die wir anhand des Messwerts für die Anzahl der Anfragen berechnen, als Grundlage verwenden oder den Erfolg bei einem stärker spezialisierten Ansatz verfolgen.

Erfolgsquote

Die Erfolgsquote wird für alle Integrationen berechnet, indem die Anzahl der erfolgreichen Anfragen durch die Anzahl aller Anfragen geteilt wird. Sie können über das Diagramm zur Erfolgsquote der Auftragsausführung in Ihrem Google Home Analytics-Dashboard darauf zugreifen.

55ea8930fbf48d9e.png

Das Diagramm der Erfolgsquote für die Auftragsausführung ist sehr nützlich, um die Leistung Ihres Projekts zu beobachten. Das ist jedoch nicht sehr wichtig, wenn Sie benutzerdefinierte Dashboards erstellen oder Benachrichtigungen einrichten. Da die Erfolgsquote von Ihrem Messwert der Anfrageanzahl und nicht von einem Messwert allein abgeleitet wird, müssen Sie ihn mit MQL (Monitoring Query Language) im Metrics Explorer neu erstellen, um ihn mit beiden Funktionen verwenden zu können.

Damit wir die Leistungsunterbrechung deines Projekts beobachten können, brauchen wir einen viel spezialisierteren Ansatz. Deshalb haben wir den Konfidenzmesswert erstellt, der sich daran ändert, wie stark Ihre aktuelle Erfolgsquote bei der Auftragsausführung von den bisherigen Normen abweicht.

Konfidenzmesswert

Ausfälle können für Projekte in verschiedenen Formen und Größen vorkommen. Sie kann einige Stunden bis zu wenigen Minuten dauern, wodurch sie sich nicht leicht identifizieren lässt. Dafür haben wir in Ihrem Projekt einen Konfidenzmesswert erstellt, der einen normalisierten Wert für die Vorhersage der Zuverlässigkeit anhand der bisherigen Leistung liefert. Sie können auf den Konfidenzmesswert zugreifen, indem Sie im Metrics Explorer nach Smart Home suchen und dann die Erfolgsquote der Ausführung auswählen.

ab467a1777281526

Wenn Ihre Smart-Home-Integration die bisherige Leistung (durchschnittlich 7 Tage) oder höher erreicht, gibt dieser Messwert den Maximalwert (1,0) aus. Wenn Ihr Erfolgsprozentsatz um mehr als den Faktor von 4 Standardabweichungen weicht (auch über 7 Tage hinweg berechnet), gibt dieser Messwert den Mindestwert (0,0) aus. Wenn die Standardabweichungen zu klein sind (weniger als 2,5%), basiert dieser Messwert auf dem Wert von 0,0 bei einem Rückgang von 10% beim Erfolgsprozentsatz.

Für alle dazwischen liegenden Werte erhalten Sie für diesen Messwert Werte zwischen 1,0 (genaue Wahrscheinlichkeit eines Ausfalls) und 0,0 (maximale Wahrscheinlichkeit, dass ein Ausfall vorliegt).

Daher empfehlen wir, beim Einrichten einer Benachrichtigung (siehe nächsten Abschnitt) den Wert 0,5 als Grenzwert zu verwenden. Das entspricht 2 Standardabweichungen oder 5% Rückgang, je nachdem, was höher ist.

4. Benachrichtigungen einrichten

Als Nächstes richten Sie mithilfe der Erkenntnisse aus dem vorherigen Abschnitt Benachrichtigungen für Ihr Projekt ein.

Benachrichtigungsrichtlinie erstellen

Automatische Benachrichtigungen werden auf der Google Cloud Platform über Benachrichtigungsrichtlinien eingerichtet. Sie können die Benachrichtigungsrichtlinien über das seitliche Menü Vorgänge > Monitoring > Benachrichtigungen aufrufen. Sie können eine neue Benachrichtigungsrichtlinie erstellen. Wählen Sie dazu die Option + RICHTLINIE ERSTELLEN aus. Dadurch gelangen Sie zum Bildschirm mit der Erstellung der Benachrichtigungsrichtlinie:

6e417d88c2274b3d.png

Die Benachrichtigungsrichtlinie besteht aus drei Teilen. Zuerst müssen Sie festlegen, was erfasst werden soll, indem Sie eine Bedingung hinzufügen. Durch Klicken auf die Schaltfläche BEDINGUNG HINZUFÜGEN wird ein Fenster geöffnet, das dem Metrics Explorer ähnelt. Es gibt jedoch zusätzliche Steuerelemente zum Konfigurieren der Bedingung:

df1ccf7da741e1c7.png

Wählen Sie für das Ziel den Konfidenzmesswert aus, den wir im vorherigen Abschnitt behandelt haben. Achten Sie darauf, dass der Abgleich mit diesem Messwert auf Delta eingestellt ist (Erweiterte Optionen einblenden &aligner). Als Nächstes konfigurieren Sie die Benachrichtigungsbedingung und verwenden die folgenden Einstellungen:

4192e0f4ea00dd28

Bedingung wird ausgelöst: Dies ist die Hauptkonfiguration, die bestimmt, wann die Benachrichtigungen ausgelöst werden. Die Auswahl von Beliebige Zeitachse verstößt funktioniert, da wir einen Grenzwert für unseren Messwert festlegen und beobachten, ob der Wert überschritten wird.

Bedingung: Die Benachrichtigung soll ausgelöst werden, wenn der Wert unter den Grenzwert fällt. Daher wird dieser Wert auf ist unter festgelegt. Bei unserem Messwert bedeutet „1,0“, dass die Integration in Ordnung ist, und „0,0“ für einen definitiven Ausfall.

Grenzwert: Wir haben den Konfidenzmesswert erstellt, um optimale Ergebnisse zu erzielen, wenn dieser Wert auf 0,5 festgelegt wird. Wenn Sie häufigere Benachrichtigungen erhalten und bei kleineren Vorfällen eine Benachrichtigung erhalten möchten, können Sie diesen Wert erhöhen (maximal 1,0). Wenn Sie nur dann weniger Benachrichtigungen erhalten möchten, wenn dies komplexer ist, können Sie diesen Wert (min.0,0) verringern.

Hinweis: Mit dieser Einstellung geben Sie an, wie lange der Ausfall dauern soll, bevor Sie benachrichtigt werden. Wir empfehlen, diese Einstellung auf dem letzten Wert zu lassen, damit Sie benachrichtigt werden, wenn der Grenzwert überschritten wird. Der Konfidenzmesswert wird alle 15 Minuten veröffentlicht und betrachtet den durchschnittlichen Erfolg in diesem Zeitraum.

Nachdem Sie eine Bedingung hinzugefügt haben, wählen Sie als Nächstes den Benachrichtigungskanal aus. Die einfachste Methode für Benachrichtigungen sind die E-Mail-Benachrichtigungen. Du kannst eine E-Mail-Adresse auswählen, die im Drop-down-Menü Benachrichtigungskanäle aufgeführt ist:

3cc10629830e7f13.png

Wenn Sie die Option Bei Vorfällen benachrichtigen aktivieren, wird eine weitere Benachrichtigung gesendet, sobald der Vorfall als geschlossen gekennzeichnet ist. In diesem Fall sollten Sie auch eine Dauer des automatischen Schließens von Vorfällen auswählen, die standardmäßig auf 7 Tage festgelegt ist.

Im letzten Schritt geben Sie der Benachrichtigung einen Namen und fügen Sie alle Dokumente hinzu, die in den Benachrichtigungen enthalten sein sollen.

686fb1c537fee10.png

Wir empfehlen die Dokumentation, insbesondere dann, wenn Sie nicht die Person sind, die die Benachrichtigung erhält. Das Hinzufügen von Schritten, z. B. zur Überprüfung während eines Vorfalls und zur Einordnung und Behebung von Fehlern, kann bei einem Ausfall hilfreich sein. Weitere Informationen finden Sie in unserem Leitfaden zur Fehlerbehebung.

Nach dem Speichern wird Ihre Benachrichtigungsrichtlinie auf der Seite „Benachrichtigungen“ im Abschnitt „Richtlinien“ aufgeführt.

c71a001e4df035ee.PNG

5. Ausfälle minimieren

Sobald Sie die Benachrichtigungen eingerichtet haben, werden Sie bei Ausfällen der von Ihnen angegebenen Benachrichtigungskanäle benachrichtigt und ein Eintrag für einen Vorfall wird auf der Seite „Benachrichtigungen“ erstellt.

Benachrichtigungen erhalten

Der Benachrichtigungskanal in diesem Codelab war eine E-Mail-Adresse. Sie erhalten dann hoffentlich keine Benachrichtigungen (keine Ausfälle). In diesem Fall sieht die Benachrichtigung jedoch so aus:

43217b0a145c2cd.png

Die Benachrichtigung enthält den beobachteten Wert, der den von Ihnen festgelegten Grenzwert überschreitet, sowie einen Zeitstempel, der angibt, wann der Vorfall erstmals gestartet wurde.

Vorfälle überwachen

Vorfälle werden auch im Abschnitt zu Vorfällen auf der Seite „Benachrichtigungen“ aufgeführt.

fdd883a9604ed981

Sie können auf den jeweiligen Vorfall klicken, um Details zum Ausfall aufzurufen, z. B. wie lange er gedauert hat oder wie schwerwiegend es war.

Wenn Sie Benachrichtigungen erhalten, sollten Sie sich zuerst Ihre Messwerte ansehen und dann in den Protokollen nach den Fehlern suchen, die zu Ihrem Ausfall führen. Eine kurze Auffrischung finden Sie im Codelab Debugging des Smart Homes.

6. Glückwunsch

17d485868a6771bc

Das war's auch schon! Sie wissen jetzt, wie Sie Benachrichtigungen mithilfe der für Ihr Projekt bereitgestellten Messwerte einrichten, um Ausfälle automatisch zu überwachen und Benachrichtigungen bei Dienstunterbrechungen zu erhalten.

Nächste Schritte

Aufbauen Sie dieses Codelab und machen Sie dann mit den folgenden Übungen zusätzliche Ressourcen:

  • Sie können das, was Sie in diesem Codelab gelernt haben, mit anderen Messwerten für Ihr Projekt kombinieren. Eine vollständige Liste der verfügbaren Messwerte finden Sie auf der Seite Monitoring und Logging im Abschnitt „Unterstützte Messwerte“.
  • Weitere Arten von Benachrichtigungskanälen finden Sie auf der Seite Benachrichtigungsoptionen der Google Cloud Platform-Dokumentation.