In diesem Dokument werden die wichtigsten Konzepte und Begriffe beschrieben, die in Personalized Service Health (PSH) verwendet werden. Wenn Sie diese Konzepte verstehen, können Sie Ereignisse effektiv interpretieren und Benachrichtigungen konfigurieren.
Personalized Service Health-Ereignis
Ein Service Health-Ereignis (v1, v1beta) ist ein störendes Ereignis, das sich auf ein Google Cloud -Produkt auswirkt, das für Ihre Projekte oder Ressourcen relevant ist. Beispiele hierfür sind Netzwerkausfälle, Konfigurationsfehler und Leistungsprobleme.
Jedes Ereignis enthält Details zu den Gesamtauswirkungen des Ereignisses, Updates von Google und Informationen zu Ihrem Google Cloud -Projekt.
Vorfall
Vorfälle sind neue und aktive Google Cloud Dienstausfälle oder -beeinträchtigungen, die für Ihre Projekte relevant sind. Ein Vorfall ist auch eine Kategorie eines Service Health-Ereignisses.
Ein Vorfall umfasst Folgendes:
- Auswirkungen des Vorfalls: Details zum Umfang des Ereignisses, z. B. betroffeneGoogle Cloud -Produkte und ‑Standorte.
- Updates von Google Cloud: Regelmäßige Updates vomGoogle Cloud Support.
- Personalisierte Relevanz: Relevanz des Vorfalls für Ihr Google Cloud-Projekt.
- Symptome, Problemumgehungen und voraussichtliche Ankunftszeiten: Informationen, die Ihnen helfen, die Auswirkungen zu bewerten, eine Problemumgehung anzuwenden oder mehr über die Ursache zu erfahren.
Zu Vorfällen kann es einen Vorfallbericht geben, der die Faktoren enthält, die zum Vorfall beigetragen haben, sowie die Schritte, die Google Cloud plant, um ähnliche Vorfälle in Zukunft zu vermeiden. Vorfallberichte sind für Vorfälle verfügbar, die die folgenden Bedingungen erfüllen:
- Der Vorfall hat globale Auswirkungen oder betrifft einen erheblichen Prozentsatz der Kundenprojekte in einer oder mehreren Regionen.
- Mindestens ein Produkt ist nicht verfügbar oder stark beeinträchtigt.
Ereignisstatus und detaillierte Status
Ein Ereignis hat zwei Felder, die seinen Status angeben. Die Werte für diese Felder ändern sich im Laufe des Ereignisses.
Ereignisstatus: Gibt den Gesamtstatus des Ereignisses an. Mögliche Werte:
- Aktiv: Das Ereignis wirkt sich aktiv auf Google Cloud aus und es werden weiterhin Updates bereitgestellt.
- Geschlossen: Das Ereignis wirkt sich nicht mehr auf ein Google Cloud Produkt aus oder wurde mit einem anderen Ereignis zusammengeführt.
Detaillierter Status: Hier finden Sie weitere Informationen zum Status des Ereignisses. Er gilt nur für Vorfälle und kann je nach Ereignisstatus einen der folgenden Werte haben:
Neu: Google-Entwickler untersuchen den Vorfall aktiv, um die Auswirkungen zu ermitteln. Ein neu auftretender Vorfall wird nach Abschluss der Folgenabschätzung entweder zu einem bestätigten oder zu einem behobenen Vorfall. Ein aktiver Vorfall kann ein neu auftretender Vorfall sein.
Support für neu auftretende Vorfälle ist nur für Google CloudNetzwerkprodukte verfügbar.
Bestätigt: Der Vorfall wurde von Google-Entwicklern bestätigt und wirkt sich auf mindestens ein Google Cloud -Produkt aus. Bis zur Behebung des Problems werden laufend Statusaktualisierungen bereitgestellt.
Ein aktiver Vorfall kann ein bestätigter Vorfall sein.
Zusammengeführt: Der Vorfall wurde mit einem übergeordneten Vorfall zusammengeführt. Alle weiteren Updates werden nur für das übergeordnete Element veröffentlicht.
Behoben: Der Vorfall wirkt sich nach Ergreifen von Maßnahmen nicht mehr auf ein Google Cloud-Produkt aus. Es wird keine weiteren Updates mehr geben.
Ein geschlossener Vorfall ist in der Regel ein gelöster Vorfall.
Falsch positiv: Nach einer Untersuchung kamen die Google-Entwickler zu dem Schluss, dass der Vorfall kein Google Cloud -Produkt betrifft. Dieser Status kann sich ändern, wenn der Vorfall noch einmal überprüft wird.
Automatisch geschlossen: Der Vorfall wurde aus folgenden Gründen automatisch geschlossen:
- Die Auswirkungen des Vorfalls konnten nicht bestätigt werden.
- Der Vorfall trat nur zeitweise auf oder wurde von selbst behoben.
Der Vorfall hat keine Lösung, da keine Aktion oder Untersuchung stattgefunden hat. Wenn das Problem nur zeitweise auftritt, wird der Vorfall möglicherweise wieder geöffnet.
Detaillierter Störungsstatus
Bei einem Vorfall, der mehrere Produkte oder Standorte betrifft, können einzelne Produkte oder Standorte wiederhergestellt werden, bevor der gesamte Vorfall behoben ist. Personalized Service Health bietet einen detaillierten Ausfallstatus auf Produkt- und Standortebene, um die teilweise Wiederherstellung während eines aktiven Vorfalls widerzuspiegeln. Der detaillierte Ausfallstatus ist sowohl für Ereignisse auf Projektebene als auch auf Organisationsebene verfügbar.
Ein Produkt oder ein Standort kann einen der folgenden detaillierten Ausfallstatus haben:
- Betroffen: Das Produkt oder der Standort ist aufgrund des Vorfalls von einer Störung betroffen.
- Behoben: Das jeweilige Produkt oder der jeweilige Standort ist nicht mehr von der Störung betroffen und hat sich erholt.
Unterscheidung zwischen Ereignisstatus und detailliertem Status
Es ist wichtig, zwischen dem Gesamtstatus des Ereignisses, dem detaillierten Status und dem detaillierten Ausfallstatus einzelner Produkte oder Standorte zu unterscheiden:
- Gesamtstatus und detaillierter Status des Ereignisses: Gelten für den gesamten Vorfall. Ein Vorfall bleibt Aktiv (mit einem detaillierten Status wie Bestätigt), solange mindestens ein Produkt oder Standort Betroffen ist. Ein Vorfall wechselt erst dann zu Geschlossen (mit dem detaillierten Status Gelöst), wenn alle zugehörigen Produkte und Standorte den Status Gelöst erreicht haben.
- Detaillierter Status der Störung: Gilt unabhängig für jedes betroffene Produkt oder jeden betroffenen Standort. Ein einzelnes Produkt oder ein einzelner Standort kann in den Status Behoben wechseln, während der Gesamtstatus des Ereignisses Aktiv bleibt.
Wenn ein Vorfall mit einem übergeordneten Vorfall zusammengeführt wird, werden die detaillierten Ausfallstatus des untergeordneten Vorfalls gelöscht und der untergeordnete Vorfall delegiert den detaillierten Status an den übergeordneten Vorfall als einzige verlässliche Quelle.
Relevanz
Personalized Service Health bewertet die Auswirkungen aller Vorfälle auf Ihr Projekt. Wenn die Auswirkungen des Vorfalls auf Ihr Projekt möglich oder bestätigt sind, wird er im Service Health-Dashboard und in der API verfügbar.
Die Relevanz gibt an, ob Ihr Projekt von einem Ereignis betroffen ist, damit zusammenhängt oder teilweise damit zusammenhängt. Bei unterstützten Produkten in der Vorabversion werden durch die Relevanz auch die spezifischen Ressourcen in Ihrem Projekt identifiziert, die betroffen sind.
Für die Relevanz sind folgende Werte möglich:
- Betroffen: Der Vorfall wirkt sich nachweislich auf Ihr Projekt aus. Unter Unterstützte Produkte (Vorschau) können Sie auch sehen, welche spezifischen Ressourcen in Ihrem Projekt betroffen sind.
- Zugehörig: Der Vorfall steht in direkter Verbindung mit Ihrem Projekt und wirkt sich auf ein Google Cloud -Produkt an einem Standort aus, der vom Projekt verwendet wird.
- Teilweise relevant: Der Vorfall ist mit einem Google Cloud-Produkt verknüpft, das von Ihrem Projekt verwendet wird, hat aber möglicherweise keine Auswirkungen auf das Projekt. Beispielsweise kann sich der Vorfall auf ein von Ihrem Projekt verwendetes Google Cloud-Produkt auswirken, allerdings an einem Standort, der vom Projekt nicht verwendet wird.
- Nicht betroffen: Der Vorfall hat keine Auswirkungen auf Ihr Projekt.
- Unbekannt: Die Auswirkungen auf Ihr Projekt sind zu diesem Zeitpunkt nicht bekannt.
Betroffene Ressourcen
Wenn ein Ereignis für Ihr Projekt die Relevanz IMPACTED hat, kann Personalized Service Health die spezifischen Ressourcen von Google Cloud in Ihrem Projekt identifizieren, die von der Störung betroffen sind (z. B. eine bestimmte Cloud SQL-Instanz oder ein bestimmter Google Kubernetes Engine-Cluster).
In der Service Health v1beta API wird jede betroffene Ressource durch eine Impact-Ressource (projects/{PROJECT_ID}/locations/global/impacts/{IMPACT_ID}) dargestellt. Eine Impact-Ressource enthält:
- Verknüpfte Ereignisse (
events): Ein oder mehrereEvent-Ressourcennamen von Service Health auf Projektebene (projects/{PROJECT_ID}/locations/global/events/{EVENT_ID}), die mit den Auswirkungen auf die Ressource verknüpft sind. - Betroffenes Asset (
asset):assetName: Der vollständige Ressourcenname der betroffenenGoogle Cloud -Ressource (z. B.//cloudsql.googleapis.com/projects/123456789/instances/my-db-instance).assetType: Der Cloud Asset Inventory-Ressourcentyp der betroffenen Ressource (z. B.sqladmin.googleapis.com/Instanceodercontainer.googleapis.com/Cluster).
- Beschreibung (
description): Zusätzlicher Kontext zu den Auswirkungen auf die Ressource, falls verfügbar. - Zeitstempel (
createTime,updateTime): Gibt an, wann der Ressourcenauswirkungsdatensatz zum ersten Mal erstellt und zuletzt aktualisiert wurde.
Beachten Sie bei der Verwendung betroffener Ressourcen in der Vorabversion Folgendes:
- Auswirkungen auf Projekte im Vergleich zu Auswirkungen auf Organisationen:
- Auswirkungen (
projects.locations.impacts) sind auf ein einzelnes Projekt beschränkt und geben nur Nicht-Container-Ressourcen zurück, wenn das Ereignis eine bestätigteIMPACTED-Relevanz für dieses Projekt hat und Produktsupport verfügbar ist. - Auswirkungen auf die Organisation (
organizations.locations.organizationImpacts) aggregiert die Daten der gesamten Organisation, um Container-Assets (Projekte) mit einer Relevanz ungleich null (PARTIALLY_RELATED,RELATEDoderIMPACTED) zurückzugeben. Relevanz ungleich null bedeutet, dass ein Projekt von einerOrganizationEventbetroffen sein kann.
- Auswirkungen (
- Voraussetzung für die API-Aktivierung: Damit
Impact-Einträge empfangen werden können, muss die Service Health API (servicehealth.googleapis.com) mindestens 24 Stunden vor Beginn des Ereignisses im Projekt aktiviert werden. Wenn Sie die API nach dem Start eines Ereignisses aktivieren, werden Ereignisse auf Projektebene der letzten 90 Tage rückwirkend erfasst, Auswirkungen auf Ressourcenebene jedoch nicht. - Lebenszyklus der Ereignisdauer: Sobald eine Ressource als von einem Ereignis betroffen identifiziert wurde, bleibt ihr
Impact-Eintrag für den Lebenszyklus des Vorfalls mit dem Ereignis verknüpft. Verwenden Sie die verknüpfteEvent-Ressource, um den Gesamtstatus des Vorfalls (ACTIVEoderCOMPLETED) und Kommunikationsupdates zu verfolgen. - Unterstützte Produkte und Vorfallsumfang: Die Auswirkungen auf Ressourcenebene sind für unterstützte Google Cloud Produkte und Ressourcentypen verfügbar.
Wenn ein Ereignis ein Produkt betrifft, das keine Auswirkungen auf Ressourcenebene unterstützt, oder wenn die Störung auf der Steuerungsebene oder auf regionaler Ebene auftritt und nicht an einzelne Ressourceninstanzen gebunden ist, wird das Projekt
Eventweiterhin mitrelevance: IMPACTEDangezeigt, währendimpacts.listeine leere Liste zurückgibt.
Informationen zum Abfragen betroffener Ressourcen finden Sie unter Ereignisse verwalten, die sich auf ein Projekt auswirken.
Produktidentitätsnamen und Anzeigenamen (nur Alpha und Beta)
Damit Administratoren Vorgänge schnell finden können, ohne dass lokale Zuordnungen von Produktkennzeichnungen erforderlich sind, enthalten Ereigniseinträge in v1alpha- und v1beta-Releases Anzeigestrings in referenzierten Ressourcen.
Insbesondere in den Product-Objekten, die in Standardnutzlasten angegeben sind (in den impact-Sammlungen sowohl für Event als auch für OrganizationEvent), helfen zwei neue Attribute bei der Identifizierung:
display_name(String): EinOUTPUT_ONLY-Tag, das menschenlesbare Produkttitel enthält, die für Kunden geeignet sind (z. B."Google Cloud SQL").previous_display_names(wiederholter String): EinOUTPUT_ONLY-Array, das alle Titel enthält, die diese Ressource früher unterstützt hat. So bleibt die Kontinuität bei der Rückverfolgung von Ereignissen über aktive Rebrandings hinweg erhalten.
Produktanzeigefelder werden auf der vGA (v1)-Oberfläche verzögert, um die Systemstabilität zu maximieren.
So ermitteln Sie die richtigen unveränderlichen Kennungen für die Verwendung in Filtern und Benachrichtigungen:
- Öffnen Sie den Leitfaden Unterstützte Produkte und Standorte.
- Suchen Sie in der Tabelle nach dem Zielprodukt von Google Cloud .
- Kopieren Sie den Wert, der unter Produkt-ID aufgeführt ist.
Alternativ können Sie die korrekten unveränderlichen Kennungen direkt aus API-Nutzlasten ermitteln:
- Führen Sie einen API-Aufruf aus, der Ereignisressourcen (z. B.
projects.locations.events.list) zurückgibt. - Prüfen Sie die
impact-Blockzuordnungen im resultierenden JSON-Array. - Extrahieren Sie den String im Attribut
product. Dieser Wert gibt die stabile Produkt-ID an, unabhängig von unterschiedlichen Anzeigenamen.