1. Hinweis
Wie bereits im Codelab Fehlerbehebung im Smart Home behandelt, veröffentlichen wir Messwerte und Protokolle in Ihren Smart-Home-Projekten. Anhand von Messwerten kannst du feststellen, wo deine Smart-Home-Aktion Probleme hat. Die Protokolle sind für eine detaillierte Lösung dieser Probleme hilfreich.
Mithilfe der für Ihr Projekt bereitgestellten Messwerte können Sie Benachrichtigungen einrichten, um Ausfälle automatisch zu überwachen und Benachrichtigungen bei Dienstunterbrechungen zu erhalten. Wir veröffentlichen einen Konfidenzmesswert, um auf die Störungen bei Ihrem Projekt hinzuweisen. Wir behandeln ihn in diesem Codelab zusammen mit allen anderen Benachrichtigungstools, die Ihnen auf der Google Cloud Platform zur Verfügung stehen.
Voraussetzungen
- Funktioniert mit Smart Home.
- Codelab zur Fehlerbehebung im Smart Home
Lerninhalte
- Hier erfahren Sie, wie Sie Leistungsprobleme und Dienstunterbrechungen bei Ihrem Projekt überwachen.
- So erstellen Sie eine schwellenwertbasierte Benachrichtigung und erhalten Benachrichtigungen bei Unterbrechungen.
- Wie Sie die Konfidenzkennzahl für Ihr Projekt nutzen können, um Ausfälle zu erkennen.
2. Leistungsbewertung
Die Leistungsüberwachung ist für eine erfolgreiche Integration in das Smart-Home-System von Google entscheidend. Auf der Google Cloud Platform stellen wir Smart-Home-Entwicklern eine Reihe von Überwachungstools zur Verfügung. Sie können diese Tools verwenden, um ein Gefühl für die Leistung Ihres Projekts zu bekommen.
Auf Dashboards zugreifen
Der erste Schritt für den Zugriff auf Ihre Daten besteht darin, sich die Google Home-Dashboards anzusehen. Melden Sie sich dazu in der Google Cloud Console an und rufen Sie Vorgänge > Monitoring > Dashboards auf. Sie werden sehen, dass es mehrere Dashboards gibt, und die Dashboards für Smart Home sind mit dem Präfix Google Home Analytics versehen.
Wir haben für jeden Integrationstyp individuelle Dashboards erstellt. Cloud-, lokale und Matter-Integrationen haben ein eigenes Dashboard und die Daten für Kamera-Streaming-Protokolle finden Sie im Dashboard zur Kameraqualität. Diese Dashboards enthalten nur Daten, wenn Sie eine Integration des entsprechenden Typs sowie ein funktionierendes Projekt haben, das Anfragen erfüllt.
Wenn Sie eines dieser Dashboards öffnen, sehen Sie folgende Ansicht:
Dashboards enthalten verschiedene Diagramme, die die Details der von Ihrem Projekt bearbeiteten Anfragen zeigen. Bei jedem Integrations-Dashboard sehen Sie ein Diagramm mit der Gesamtzahl der von Ihrem Projekt bearbeiteten Anfragen, ein Diagramm mit der Erfolgsquote für diesen Integrationstyp und mehrere Diagramme mit den beteiligten Gerätetypen und Merkmalen.
Es gibt drei Diagramme, die für die Bewertung der Leistung deiner Smart-Home-Aktionen wichtig sind:
Bei Ausfällen sehen Sie häufig Abwärtstrends im Erfolgsprozentsatz und einen Aufwärtstrend im Fehleraufschlüsselungsdiagramm. Die Überwachung des Prozentsatzes für erfolgreiche Ausführungen hilft dabei, den Ausfall zu erkennen, während ein Blick auf die häufigsten Fehler in der Fehleraufschlüsselung bei der Fehlerbehebung hilfreich ist. Möglicherweise beobachten Sie auch einen Anstieg der Latenz bei Ausfällen, der in den Diagrammen zur Anfragelatenz zu erkennen ist.
Hinweis: Die Standardansicht mit Diagrammen, die Sie in den Dashboards von Google Home Analytics sehen, ist nur eine Ansicht, die wir unter Verwendung von Smart-Home-Messwertdaten für Ihr Projekt erstellt haben. Mit dem Metrics Explorer können Sie auch eigene Diagramme aus denselben zugrunde liegenden Messwerten erstellen und in Ihren benutzerdefinierten Dashboards speichern.
Metrics Explorer
Der Metrics Explorer ist ein Tool zur Visualisierung von Querschnitten des Datasets Ihres Projekts. In der Google Cloud Console kann über Vorgänge > Monitoring > Metrics Explorer auf das Tool zugegriffen werden.
Google Cloud bietet sofort viele verschiedene Messwerte, darunter auch einige, die nichts mit Smart Homes zu tun haben. Die von uns für Smart Home bereitgestellten Messwerte sind unter der Ressource „actions.googleapis.com/smarthome_action/...“ aufgeführt. Sie können einfach nach „smarthome“ suchen und in das Auswahlfeld für Messwerte eingeben.
Wenn Sie nach „Smart Home“ suchen, werden alle Smart-Home-Messwerte angezeigt, die wir für Ihr Projekt bereitstellen. Ausführliche Informationen zu jedem unserer Messwerte finden Sie in unserer Dokumentation auf den Seiten Monitoring und Logging.
Am einfachsten können Sie sich bei der Überwachung Ihres Projekts auf den Messwert Anzahl der Anfragen beziehen, bei dem es sich um einen Deltamesswert handelt. Dieser Messwert erfasst für jede von Nutzern initiierte Smart-Home-Ausführung einen Eintrag. Es werden auch Felder wie Gerätetyp, Eigenschaft, Ausführungstyp und das Statusfeld mit dem Ergebnis erfasst.
Wenn Sie diesen Messwert auswählen, wird ein Bildschirm mit jedem Daten-Bucket angezeigt, der in etwa so aussieht:
Im Grunde gibt es für jede Kombination von Datenlabels in diesem Messwert einen Bucket, in dem die Änderung (Delta) zwischen dem vorherigen und dem aktuellen Zeitintervall aufgezeichnet wird. Sie können diese Gruppen gruppieren oder herausfiltern, um den gewünschten Datenbereich für die Datenansicht zu erhalten. Darüber hinaus werden die Daten mit einer Ausrichtungsfunktion (DELTA, MEAN, MEDIAN, SUM) in ausgewählten Zeitintervallen ausgerichtet. Sofern nicht anders erforderlich, verwenden Sie in der Regel die Deltaausrichtung mit einem Deltamesswert.
Sie können die meisten Diagramme, die in Google Home Analytics-Dashboards verfügbar sind, mit dem Metrics Explorer erstellen und Ihre Diagramme für den späteren Zugriff in einem benutzerdefinierten Dashboard speichern. Wenn Sie komplexere Ansichten erstellen möchten, z. B. ein Verhältnisdiagramm, müssen Sie Monitoring Query Language (MQL) verwenden.
3. Erfolgsmessdaten
Wenn es darum geht, den Erfolg der Integration zu verfolgen, können Sie entweder die Erfolgsquote, die wir aus Ihrem Messwert für die Anzahl der Anfragen berechnen, als Basisindikator verwenden, oder die Erfolgskonfidenz für einen spezialisierteren Ansatz.
Erfolgs quote
Die Erfolgsquote wird für alle Ihre Integrationen berechnet, indem die Anzahl der erfolgreichen Anfragen durch die Anzahl aller Anfragen geteilt wird. Du kannst es über das Diagramm „Erfolgsquote bei der Auftragsausführung“ im Dashboard der Google Home-Analyse aufrufen.
Das Diagramm der Erfolgsquote für die Auftragsausführung ist sehr nützlich, um die Leistung bei Ihrem Projekt zu überwachen, jedoch nicht besonders beim Erstellen Ihrer benutzerdefinierten Dashboards oder beim Einrichten von Benachrichtigungen. Da die Erfolgsquote aus dem Messwert für die Anzahl der Anfragen und nicht aus einem eigenen Messwert abgeleitet wird, müssen Sie ihn mit MQL (Monitoring Query Language) im Metrics Explorer neu erstellen, um ihn mit den beiden Funktionen verwenden zu können.
Um die Leistungsstörungen bei Ihrem Projekt zu verfolgen, denken wir, dass ein viel stärker spezialisierter Ansatz erforderlich ist. Deshalb haben wir den Messwert „Konfidenz“ erstellt, der sich danach ändert, wie sehr Ihre aktuelle Erfolgsquote bei der Auftragsausführung von den bisherigen Normen abweicht.
Konfidenzmesswert
Bei Projekten können Ausfälle in verschiedenen Formen und Größen auftreten. Sie können mehrere Stunden oder nur wenige Minuten dauern, was die Identifizierung zu einer Herausforderung erschweren kann. Dazu haben wir in Ihrem Projekt einen Konfidenzmesswert erstellt, der einen normalisierten Wert für die Vorhersage der Zuverlässigkeit basierend auf der bisherigen Leistung liefert. Sie können auf den Konfidenzmesswert zugreifen, indem Sie im Metrics Explorer nach „Smart Home“ suchen und dann Ausführungs-Erfolgskonfidenz auswählen.
Wenn die Leistung Ihrer Smart-Home-Integration der bisherigen Leistung (7-Tage-Durchschnitt) entspricht oder darüber liegt, gibt dieser Messwert den Maximalwert (1,0) aus. Wenn der Prozentsatz für den Erfolg um mehr als einen Faktor von 4 Standardabweichungen weicht (auch über 7 Tage berechnet), gibt dieser Messwert den Mindestwert (0,0) aus. In Fällen, in denen die Standardabweichungen zu gering sind (weniger als 2,5%), basiert dieser Messwert auf dem Wert 0,0 bei einem Rückgang von 10% basierend auf dem Prozentsatz für den Erfolg.
Für alle dazwischen liegenden Fälle gibt dieser Messwert Werte zwischen 1,0 (es ist absolut sicher, dass kein Ausfall vorliegt) und 0,0 (maximale Sicherheit, dass es einen Ausfall gibt).
Daher empfehlen wir, beim Einrichten einer Benachrichtigung (siehe nächster Abschnitt) einen Wert von 0,5 als Grenzwert festzulegen. Dies entspricht zwei Standardabweichungen oder einem Rückgang von 5 %, je nachdem, welcher Wert höher ist.
4. Einrichten von Benachrichtigungen
Wenden Sie als Nächstes alles an, was Sie im vorherigen Abschnitt gelernt haben, um Benachrichtigungen für Ihr Projekt einzurichten.
Benachrichtigungsrichtlinie erstellen
Automatische Benachrichtigungen auf der Google Cloud Platform werden durch Benachrichtigungsrichtlinien festgelegt. Sie können die Benachrichtigungsrichtlinien über das Seitenmenü Vorgänge > Monitoring > Benachrichtigungen aufrufen. Sie können eine neue Benachrichtigungsrichtlinie erstellen, indem Sie die Option +CREATE POLICY (+ RICHTLINIE ERSTELLEN) auswählen. Dadurch gelangen Sie zum Bildschirm zum Erstellen der Benachrichtigungsrichtlinie:
Das Erstellen einer Benachrichtigungsrichtlinie besteht aus drei Teilen. Legen Sie zuerst fest, was erfasst werden soll, indem Sie eine Bedingung hinzufügen. Wenn Sie auf die Schaltfläche BEDINGUNG HINZUFÜGEN klicken, wird ein Fenster geöffnet, das dem Metrics Explorer ähnelt und einige zusätzliche Steuerelemente zum Konfigurieren der Bedingung enthält:
Wählen Sie für das Ziel den Konfidenzmesswert aus, den wir im vorherigen Abschnitt behandelt haben. Achten Sie darauf, dass der Aligner mithilfe dieses Messwerts auf „Delta“ festgelegt ist (Erweiterte Optionen anzeigen > Aligner). Im nächsten Schritt konfigurieren Sie die Benachrichtigungsbedingung und verwenden die folgenden Einstellungen:
Bedingung wird ausgelöst, wenn: Dies ist die Hauptkonfiguration für die Auslösung der Benachrichtigungen. Die Auswahl von Bei jedem Verstoß 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. Legen Sie daher den Wert liegt unter fest. Bei unserem Messwert bedeutet 1,0, dass die Integration problemlos funktioniert, und 0,0 bedeutet, dass die Integration definitiv ausfällt.
Grenzwert: Wir haben den Konfidenzmesswert erstellt, um die besten Ergebnisse zu erzielen, wenn dieser Wert auf 0,5 festgelegt ist. Wenn Sie häufigere Benachrichtigungen und Benachrichtigungen für weniger Vorfälle erhalten möchten, können Sie diesen Wert erhöhen (max.1,0). Wenn Sie später weniger Benachrichtigungen erhalten möchten, aber nur bei schwerwiegenden Problemen, können Sie versuchen, diesen Wert zu senken (min.0,0).
For (Für): Mit dieser Einstellung wird festgelegt, wie lange der Ausfall dauern sollte, bevor Sie benachrichtigt werden. Wir empfehlen, für diese Einstellung den aktuellen Wert beizubehalten, damit Sie bei Überschreitung des Grenzwerts benachrichtigt werden. Unser Konfidenzmesswert wird alle 15 Minuten veröffentlicht und zeigt den durchschnittlichen Erfolg in diesem Zeitraum an.
Nachdem Sie eine Bedingung hinzugefügt haben, müssen Sie im nächsten Schritt den Benachrichtigungskanal auswählen. Die einfachste Benachrichtigungsmethode sind E-Mail-Benachrichtigungen. Sie können eine E-Mail-Adresse auswählen, die im Drop-down-Menü Benachrichtigungskanäle aufgeführt ist:
Wenn Sie das Kästchen Bei Schließung des Vorfalls benachrichtigen anklicken, wird eine weitere Benachrichtigung gesendet, sobald der Vorfall als geschlossen gekennzeichnet ist. In diesem Fall sollten Sie auch die Dauer der automatischen Schließung von Vorfällen auswählen, die standardmäßig 7 Tage beträgt.
Im letzten Schritt geben Sie einen Namen für die Benachrichtigung ein und fügen die Dokumentation hinzu, die in die Benachrichtigungen aufgenommen werden soll.
Wir empfehlen, die entsprechenden Unterlagen einzureichen, insbesondere wenn Sie nicht die Person sind, die die Benachrichtigung erhalten wird. Es kann hilfreich sein, Schritte hinzuzufügen, z. B. wo während eines Vorfalls geprüft werden soll und wie sich dies bei einem Ausfall beheben lässt. Weitere Informationen finden Sie in unserer Anleitung zur Fehlerbehebung.
Nach dem Speichern wird die Benachrichtigungsrichtlinie auf der Seite „Benachrichtigungen“ im Abschnitt „Richtlinien“ aufgeführt.
5. Minderung von Ausfällen
Nachdem Sie Benachrichtigungen eingerichtet haben, werden Sie über die von Ihnen angegebenen Benachrichtigungskanäle bei Ausfällen informiert. Außerdem wird auf der Seite „Benachrichtigungen“ ein Vorfalleintrag erstellt.
Benachrichtigungen erhalten
In diesem Codelab haben wir Benachrichtigungen per E-Mail bereitgestellt. Nach der Einrichtung erhalten Sie hoffentlich keine Benachrichtigungen (keine Ausfälle). Wenn Sie dies jedoch tun, sieht die Benachrichtigung so aus:
Die Benachrichtigung enthält den beobachteten Wert, der den von Ihnen festgelegten Grenzwert überschreitet, sowie einen Zeitstempel, der angibt, wann der Vorfall zum ersten Mal begonnen hat.
Vorfälle überwachen
Vorfälle werden auch auf der Seite „Benachrichtigungen“ im Bereich „Vorfälle“ aufgeführt.
Sie können auf einen bestimmten Vorfall klicken, um Details zum Ausfall zu sehen, z. B. wie lange er gedauert hat oder wie schwerwiegend er war.
Wenn Sie Benachrichtigungen erhalten, sollten Sie sich als Erstes die Messwerte ansehen und dann in den Logs nach Fehlern suchen, die zu Ihrem Ausfall beitragen. Weitere Informationen dazu findest du im Codelab Fehlerbehebung beim Smart Home.
6. Glückwunsch
Glückwunsch! Sie haben gelernt, wie Sie mithilfe der für Ihr Projekt bereitgestellten Messwerte Benachrichtigungen einrichten, um Ausfälle automatisch zu überwachen und Benachrichtigungen bei Dienstunterbrechungen zu erhalten.
Weiteres Vorgehen
Bauen Sie auf diesem Codelab auf und versuchen Sie es mit den folgenden Übungen und zusätzlichen Ressourcen:
- Sie können das in diesem Codelab Gelernte mit anderen Messwerten kombinieren, die Sie für Ihr Projekt erhalten haben. Eine vollständige Liste der verfügbaren Messwerte finden Sie auf der Seite Monitoring im Abschnitt Unterstützte Messwerte.
- In der Google Cloud Platform-Dokumentation finden Sie auf der Seite Benachrichtigungsoptionen weitere Arten von Benachrichtigungskanälen.