Zugriff auf Personalized Service Health verwalten

In diesem Dokument wird beschrieben, wie Sie Berechtigungen festlegen und den Zugriff aktivieren, damit Sie Folgendes tun können:

  • Service Health-Ereignisse im Service Health-Dashboard ansehen
  • Rufen Sie Informationen zum Dienststatus mit der Service Health API ab.
  • Konfigurieren Sie Benachrichtigungen, die für Ihre Projekte relevant sind.

Hinweise

Make sure that billing is enabled for your Google Cloud project.

Auf die Service Health API und das Dashboard zugreifen

Personalized Service Health bietet eine vordefinierte Rolle servicehealth.viewer, mit der Sie Projektmitgliedern Zugriff gewähren können. Mit dieser Rolle können Sie auf die Service Health API und das Dashboard zugreifen.

Rollenname Beschreibung Berechtigungen für Personalized Service Health
roles/servicehealth.viewer Betrachter von Personalized Service Health Lesezugriff auf Service Health-Ereignisse. servicehealth.location.list

servicehealth.location.get

servicehealth.events.list

servicehealth.events.get

servicehealth.organizationEvents.list

servicehealth.organizationEvents.get

servicehealth.organizationImpacts.list

servicehealth.organizationImpacts.get

Sie können die Rollen und Berechtigungen direkt über die gcloud CLI verwenden, um die richtigen Zugriffskontrollen einzurichten. Sie können die Rolle beispielsweise mit dem folgenden Befehl direkt zuweisen:

gcloud projects add-iam-policy-binding PROJECT_ID \
  --member {USER|GROUP|SERVICE_ACCOUNT} \
  --role roles/servicehealth.viewer

Mit dem folgenden Befehl können Sie die IAM-Richtlinie (Identity and Access Management) für das angegebene Projekt aufrufen:

gcloud projects get-iam-policy PROJECT_ID

Alternativ können Sie die Berechtigungen direkt einer vorhandenen Rolle hinzufügen:

gcloud iam roles update ROLE_ID --project=PROJECT_ID \
  --add-permissions=servicehealth.events.list
gcloud iam roles update ROLE_ID --project=PROJECT_ID \
  --add-permissions=servicehealth.events.get
gcloud iam roles update ROLE_ID --project=PROJECT_ID \
  --add-permissions=servicehealth.locations.list
gcloud iam roles update ROLE_ID --project=PROJECT_ID \
  --add-permissions=servicehealth.locations.get

APIs und Dienste in Ihren Projekten verwenden

  1. Aktivieren Sie die Service Health API für das Projekt.
  2. Weisen Sie die Rolle Service Usage-Nutzer (roles/serviceusage.serviceUsageConsumer) zu.

Auf Logs zugreifen und Logbenachrichtigungen konfigurieren

Gehen Sie dazu so vor:

  1. Aktivieren Sie die Service Health API für das Projekt.
  2. Berechtigungen für logbasierte Benachrichtigungen erhalten

Wenn Sie die Rolle Bearbeiter von Monitoring-Benachrichtigungskanälen (roles/monitoring.notificationChannelEditor) nicht zuweisen möchten, können Sie stattdessen die Rolle Betrachter von Monitoring-Benachrichtigungskanälen (roles/monitoring.notificationChannelViewer) zuweisen, um einen Benachrichtigungskanal mit einer Benachrichtigungsrichtlinie zu verknüpfen.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Service Health API für ein einzelnes Projekt aktivieren

Zum Einrichten von Benachrichtigungen und Abrufen von Service Health-Informationen muss die Service Health API aktiviert sein. Sie können die API über dieGoogle Cloud Console oder die Google Cloud CLI aktivieren.

Console

  1. Rufen Sie in der Bibliothek „APIs und Dienste“ die Service Health API auf.

    Zur Service Health API

    Alternativ können Sie die API-Bibliothek aufrufen und nach „Service Health API“ suchen.

  2. Wählen Sie das Projekt aus.

  3. Wählen Sie die Schaltfläche Aktivieren aus.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  2. Prüfen Sie, ob die neueste Version der Google Cloud CLI installiert ist. Führen Sie den folgenden Befehl in Cloud Shell aus:

      gcloud components update

  3. Erstellen oder wählen Sie ein neues Projekt aus, PROJECT_ID.

    • So erstellen Sie ein Google Cloud -Projekt:

      gcloud projects create PROJECT_ID

    • Wählen Sie das von Ihnen erstellte Google Cloud Projekt aus:

      gcloud projects config set project PROJECT_ID

  4. Aktivieren Sie die Service Health API in dem Projekt, das Sie gerade erstellt haben.

    gcloud services enable servicehealth.googleapis.com \
 --project PROJECT_ID

Skript

Sie können ein Script verwenden, um die Service Health API für Projekte in Ihrer Organisation oder Ihrem Ordner zu aktivieren.

Weitere Informationen finden Sie unter API in Ihrem Google Cloud -Projekt aktivieren.

Die Service Health API und Benachrichtigungen erkennen neue Ereignisse einige Stunden nach der API-Aktivierung.