Einmal im Monat werden für Looker (Google Cloud Core) Wartungszeiträume geplant, in denen Ihre Instanz aktualisiert wird. Während eines Wartungszeitraums wird Ihre Instanz neu gestartet und Sie können vorübergehend nicht darauf zugreifen. Sie können für Ihre Instanz ein Wartungsfenster in Form eines Wochentags und einer Uhrzeit angeben, zu der die Wartung stattfindet. Wenn Sie kein bevorzugtes Wartungsfenster angeben, erfolgen Upgrades innerhalb von zwei Wochen nach der Einführung einer neuen Looker (Google Cloud Core)-Version. Sie können auch einen Zeitraum für den Wartungsausschluss angeben, um zu verhindern, dass die Wartung während des von Ihnen angegebenen Zeitraums stattfindet.
Wenn Sie einen Wartungszeitraum für die Ablehnung angeben, in dem Looker (Google Cloud Core)-Instanzen auf die nächste unterstützte Looker-Version aktualisiert werden, können sich die in Ihrer Looker (Google Cloud Core)-Instanz verfügbaren Funktionen von den Einstellungen unterscheiden, die in der Google Cloud Console für die aktualisierte Version angegeben sind.
Auf dieser Dokumentationsseite wird beschrieben, wie Sie Informationen zu geplanten Wartungsarbeiten finden, ein bevorzugtes Wartungsfenster festlegen, einen Wartungsausschlusszeitraum angeben und Benachrichtigungen über anstehende Wartungsupdates für eine Looker (Google Cloud Core)-Instanz konfigurieren.
Releasekanäle und Wartungsrichtlinien
Wenn eine Looker (Google Cloud Core)-Instanz für einen Release-Version registriert ist, hängen die Wartungseinstellungen, die Sie konfigurieren können, vom Release-Version Ihrer Instanz ab:
- Rapid Channel: Wartungsfenster und Wartungsausschlüsse werden nicht unterstützt. Wenn Sie sich für den Rapid Channel registrieren, werden alle Wartungsfenster oder Zeiträume für den Wartungsausschluss, die zuvor für die Instanz festgelegt wurden, entfernt.
- Regulärer Channel: Sie können ein bevorzugtes Wartungsfenster und einen Zeitraum für den Wartungsausschluss angeben.
- Keine Version: Sie können ein bevorzugtes Wartungsfenster und einen Zeitraum für den Wartungsausschluss angeben.
Erforderliche Rolle
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Looker Admin (roles/looker.admin) für das Projekt zuzuweisen, in dem die Instanz erstellt wurde, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren der Wartungseinstellungen für eine Looker (Google Cloud Core)-Instanz benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Wartungseinstellungen
Mit Looker (Google Cloud Core) können Sie Wartungsupdates über eine Reihe von Wartungseinstellungen konfigurieren.
Sie können die Wartung so konfigurieren, dass sie zu Zeiten geplant wird, zu denen kurze Ausfallzeiten für Ihre Instanz die geringste Auswirkung haben. Sie können Folgendes konfigurieren:
Wartungsfenster: Der Wochentag und die Stunde, in der die Wartung von Looker (Google Cloud Core) geplant wird. Wartungsfenster dauern eine Stunde.
Wartungsausschlusszeitraum: Ein Block von Tagen, in dem für Looker (Google Cloud Core) keine Wartung geplant wird. Zeiträume für Wartungsausschlüsse können bis zu 60 Tage lang sein. Zwischen zwei Zeiträumen für Wartungsausschlüsse müssen mindestens 14 Tage liegen, in denen die Wartung möglich ist.
Sie können Wartungsrichtlinien aktualisieren, wenn Sie Ihre Looker (Google Cloud Core)-Instanz erstellen oder indem Sie die Konfiguration einer vorhandenen Instanz bearbeiten.
Bevorzugtes Wartungsfenster festlegen
Wenn Sie ein bevorzugtes Zeitfenster angeben möchten, in dem die Wartung für Looker (Google Cloud Core) geplant werden soll, wählen Sie eine der folgenden Optionen aus:
Console
Erstellen Sie in der Google Cloud Console eine Looker (Google Cloud Core)-Instanz oder bearbeiten Sie die Konfiguration einer vorhandenen Looker (Google Cloud Core)-Instanz.
Konfigurieren Sie unter Wartungsfenster im Bereich Bevorzugte Wartung die folgenden Einstellungen für das Wartungsfenster:
Tag: Der Wochentag, an dem Ihre Instanz aktualisiert wird.
Zeitfenster: Die ungefähre Tageszeit, zu der die Instanzwartung beginnt
Klicken Sie auf Speichern.
Wenn Sie Ihre Instanz für die Release-Version „Rapid“ registriert haben, ist diese Option in der Google Cloud -Konsole nicht verfügbar.
gcloud
Verwenden Sie den Befehl gcloud looker instances create, wenn Sie die Instanz erstellen, oder den Befehl gcloud looker instances update, wenn Sie die Instanz aktualisieren, und fügen Sie die folgenden Parameter ein:
--maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-time=MAINTENANCE_WINDOW_TIME
Ersetzen Sie Folgendes:
MAINTENANCE_WINDOW_DAY: der Wochentag, an dem Ihre Instanz aktualisiert wird. Muss einer der folgenden Werte sein:friday,monday,saturday,sunday,thursday,tuesday,wednesday.MAINTENANCE_WINDOW_TIME: die Startzeit des Wartungsfensters im 24-Stunden-Format in UTC (z. B.13:00,17:45).
Wenn Sie eine Looker (Google Cloud Core)-Instanz für den Rapid Channel der Vorschaufunktion Release-Channels registriert haben, können Sie für diese Instanz kein Wartungsfenster festlegen.
Nachdem Sie ein Wartungsfenster angegeben haben, kann es bis zu einer Woche dauern, bis Ihre Änderungen an der Einstellung wirksam werden.
Zeitraum für den Wartungsausschluss konfigurieren
Wenn Sie die geplante Wartung auf einen späteren Zeitpunkt verschieben möchten, können Sie den Zeitraum des Wartungsausschlusses für die Instanz ändern. Ein Zeitraum für den Wartungsausschluss kann bis zu 60 Tage lang sein.
Zwischen zwei Zeiträumen für Wartungsausschlüsse müssen mindestens 14 Tage liegen, in denen die Wartung möglich ist.
Wenn Sie ein bevorzugtes Zeitfenster angeben möchten, in dem in Looker (Google Cloud Core) keine Wartung durchgeführt wird, wählen Sie eine der folgenden Optionen aus:
Console
Erstellen Sie in der Google Cloud Console eine Looker (Google Cloud Core)-Instanz oder bearbeiten Sie die Konfiguration einer vorhandenen Looker (Google Cloud Core)-Instanz.
Konfigurieren Sie im Bereich Zeitraum für den Wartungsausschluss die folgenden Einstellungen für den Zeitraum für den Wartungsausschluss:
Startdatum: Wählen Sie das Startdatum des Zeitraums aus, in dem keine Wartung stattfindet.
Enddatum: Wählen Sie das Enddatum des Zeitraums aus, in dem keine Wartung stattfindet.
Start-/Endzeit: Legen Sie die genaue Uhrzeit fest, zu der der Wartungsausschluss – Dauer am Startdatum beginnt und am Enddatum endet.
- Klicken Sie auf Speichern.
Wenn Sie Ihre Instanz für den Release-Kanal „Schnelle Veröffentlichung“ registriert haben, ist diese Option in der Google Cloud -Konsole nicht verfügbar.
gcloud
Verwenden Sie den Befehl gcloud looker instances create, wenn Sie die Instanz erstellen, oder den Befehl gcloud looker instances update, wenn Sie die Instanz aktualisieren, und fügen Sie die folgenden Parameter ein:
--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE
--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE
--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME
Ersetzen Sie Folgendes:
DENY_MAINTENANCE_PERIOD_START_DATE: das Startdatum des Ablehnungszeitraums im FormatYYYY-MM-DD.DENY_MAINTENANCE_PERIOD_END_DATE: das Enddatum des Ablehnungszeitraums im FormatYYYY-MM-DD.DENY_MAINTENANCE_PERIOD_TIME: Start- und Endzeit im 24-Stunden-Format in UTC (z. B.13:00,17:45).
Wenn Sie eine Looker (Google Cloud Core)-Instanz für den Rapid Channel der Vorschaufunktion Release-Channels registriert haben, können Sie für diese Instanz keinen Wartungszeitraum festlegen, in dem Wartungsarbeiten abgelehnt werden.
Beispiel für die Wartung
Sie können beispielsweise die Wartungseinstellungen Ihrer Produktionsinstanz so festlegen:
- Wartungsfenster: Sonntags zwischen 00:00 Uhr und 1:00 Uhr ET (UTC-4/-5)
- Zeitraum für Wartungsausschluss: 1. Dezember um 22:00 Uhr bis 15. Januar um 22:00 Uhr
Benachrichtigungen über anstehende Wartungen
Sie können eine Benachrichtigung über bevorstehende Wartungen bis zu eine Woche vor der geplanten Wartung an Ihre E-Mail-Adresse erhalten. Wenn Sie einen E-Mail-Filter für Benachrichtigungen einrichten möchten, lautet der E-Mail-Titel [Looker (Google Cloud Core) Advanced Maintenance Notification] Your instance is scheduled for maintenance. (Benachrichtigung über erweiterte Wartung von Looker (Google Cloud Core): Ihre Instanz ist für die Wartung geplant).
Wartungsbenachrichtigungen werden nicht standardmäßig gesendet. Wenn Sie Benachrichtigungen zu bevorstehenden Wartungsupdates erhalten möchten, müssen Sie Folgendes tun:
- Legen Sie ein Wartungsfenster fest.
- Aktivieren Sie Wartungsbenachrichtigungen auf Projektebene oder richten Sie logbasierte Benachrichtigungen ein.
- Damit Sie Benachrichtigungen über die geplante Wartung erhalten, müssen Sie beide Schritte mindestens sieben Tage vor dem nächsten geplanten Wartungsupdate für Ihre Looker (Google Cloud Core)-Instanz ausführen.
Benachrichtigungen, die über die Google Cloud Konsole konfiguriert werden, werden an die E‑Mail-Adresse gesendet, die mit Ihrem Google-Konto verknüpft ist. Sie können einen benutzerdefinierten E-Mail-Alias wie einen Team-E-Mail-Alias verwenden.
Wenn für Ihre Looker (Google Cloud Core)-Instanz SAML oder OpenID Connect (OIDC) für die Authentifizierung verwendet wird oder wenn Sie Benachrichtigungen an Drittanbieter-Kommunikationskanäle wie Slack, PagerDuty oder benutzerdefinierte Webhooks weiterleiten möchten, können Sie logbasierte Benachrichtigungen einrichten.
Sie können Wartungsbenachrichtigungen für alle Looker (Google Cloud Core)-Instanzen aktivieren, die Wartungsfenster in einem bestimmten Projekt haben. Sie erhalten pro Instanz eine Benachrichtigung.
Wartungsbenachrichtigungen aktivieren
So aktivieren Sie Wartungsbenachrichtigungen in der Google Cloud Console:
Rufen Sie in der Google Cloud Console die Seite Kommunikation auf:
Wählen Sie den Tab Produktbenachrichtigungen aus.
Wählen Sie Ihr Projekt im Drop-down-Menü aus.
Stellen Sie in der Zeile für Looker (Google Cloud Core) den E-Mail-Schalter auf AN.
Logbasierte Benachrichtigungen für Wartungsereignisse einrichten
Wenn Sie sich mit der Workforce Identity-Föderation bei Google Cloud authentifizieren, kann die Google Cloud Console keine Wartungsbenachrichtigungen an Ihre verbundenen Konten senden. Außerdem können Sie Benachrichtigungen an Dienste wie Slack, PagerDuty oder benutzerdefinierte Webhooks weiterleiten. Wenn Sie in diesen Fällen Benachrichtigungen erhalten möchten, können Sie logbasierte Benachrichtigungsrichtlinien in Cloud Logging konfigurieren.
Wenn Looker (Google Cloud Core) ein Wartungsupdate plant, startet, abschließt oder abbricht, wird ein Logeintrag in Logging geschrieben. Sie können Benachrichtigungsrichtlinien erstellen, die diesen Logeinträgen entsprechen, und Benachrichtigungen an Ihre konfigurierten Benachrichtigungskanäle senden.
Wenn Sie eine logbasierte Benachrichtigung für ein Wartungsereignis erstellen möchten, folgen Sie der Anleitung in der Dokumentation Logbasierte Benachrichtigungsrichtlinie mit dem Log-Explorer erstellen, um eine Benachrichtigungsrichtlinie zu erstellen. Beispiele für Abfragen, die in der Richtlinie verwendet werden können, finden Sie unter Wartungslog-Abfragen.
Wartungslog-Abfragen
Mit den folgenden Abfragen können Sie logbasierte Benachrichtigungen für verschiedene Phasen des Wartungslebenszyklus erstellen.
Ersetzen Sie LOOKER_INSTANCE_NAME durch den Namen Ihrer Looker-Instanz (Google Cloud Core).
Vorabbenachrichtigung (geplant): Sie werden benachrichtigt, wenn eine Wartung für Ihre Instanz geplant ist.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutAdvanced" AND labels.instance_id = "LOOKER_INSTANCE_NAME"Benachrichtigung über den Beginn: Sie werden benachrichtigt, wenn die Wartung Ihrer Instanz beginnt.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutInProgress" AND labels.is_completed = "false" AND labels.is_failed = "false" AND labels.instance_id = "LOOKER_INSTANCE_NAME"Benachrichtigung über Abschluss (Erfolg): Sie werden benachrichtigt, wenn die Wartung erfolgreich abgeschlossen wurde.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutInProgress" AND labels.is_completed = "true" AND labels.is_failed = "false" AND labels.instance_id = "LOOKER_INSTANCE_NAME"Benachrichtigung über Fehler oder Abbruch: Sie werden benachrichtigt, wenn die Wartung fehlschlägt oder abgebrochen wird.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND (labels.is_failed = "true" OR labels.activity_type_name = "LookerRolloutCanceled") AND labels.instance_id = "LOOKER_INSTANCE_NAME"
Geplante Wartung finden
Wenn für Ihre Instanz eine Wartung geplant ist, können Sie sie so aufrufen:
Rufen Sie in der Google Cloud Console die Seite Looker (Google Cloud Core) auf.
Wählen Sie den Namen der Instanz aus, für die Sie die geplante Wartung aufrufen möchten.
Wenn Sie sich die Konfigurationsdetails für Ihre Instanz ansehen, können Sie auf der Seite Details die folgenden Informationen aufrufen: