Mit Personalized Service Health nach Unterbrechungen suchen

In diesem Dokument wird beschrieben, was Sie tun können, wenn bei Personalized Service Health eine Störung auftritt.

Personalized Service Health kann teilweise oder vollständig von einem Vorfall betroffen sein. Sie können über die Status API und das Google CloudService Health-Dashboard nach Vorfällen, Verarbeitungsproblemen und Leistungsproblemen suchen.

Status API verwenden

Die Status API-Ressource der Service Health API gibt Aufschluss darüber, ob bei bestimmten Service Health-Funktionen Probleme auftreten.

Hinweise

So verwenden Sie die Status API:

  1. Aktivieren Sie die Service Health API für das Projekt oder die Organisation, mit der Sie auf diesen Status zugreifen möchten.
  2. Make sure that billing is enabled for your Google Cloud project.

  3. Legen Sie Berechtigungen für den Zugriff auf die Service Health API fest.
  4. Konfigurieren Sie IAM-Berechtigungen (Identity and Access Management) für Ihr Projekt oder Ihre Organisation, um die Status API zu verwenden.

    Führen Sie den folgenden Befehl aus, um Berechtigungen für Ihr Projekt zu konfigurieren:

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

    Führen Sie den folgenden Befehl aus, um Berechtigungen für Ihre Organisation zu konfigurieren:

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

    Wie Sie Ihre ORGANIZATION_ID abrufen, erfahren Sie unter ID der Organisationsressource abrufen.

Die für eine Organisation gewährten IAM-Richtlinien werden von allen Projekten in der Organisation übernommen. Mit diesen Richtlinien können Sie unternehmensweit auf APIs für Organisations- und Projektereignisse zugreifen.

Verweise

In der Status API-Referenz finden Sie die Methode, die Sie verwenden können, und die Bedeutung der Felder in der Antwort.

Verwenden Sie beim Festlegen des Produkts oder Standorts die Werte unter Google Cloud-Produkte und Standorte.

Dienststatus mithilfe einer Projekt-ID abrufen

Wenn Sie den Status der Dienstbereitschaft mit einer Projekt-ID abrufen möchten, verwenden Sie die folgende Anfrage:

GET https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/status

Wenn der Statuswert OK ist, wird für die Anfrage die folgende Antwort zurückgegeben:

{
  "state": "OK",
}

Dieser Status gibt an, dass bei den Funktionen, auf die über die Projekt-ID zugegriffen wird, z. B. bei Ereignissen oder Auswirkungen, intern keine Probleme auftreten.

Wenn der Statuswert ISSUES_DETECTED ist, wird für die Anfrage die folgende Antwort zurückgegeben:

{
  "state": "ISSUES_DETECTED",
  "issues": [
    {
      "message": "We are experiencing problems creating new events",
      "details": {
        "API": "events"
      }
    },
    {
      "message": "We are experiencing problems creating new impacts",
      "details": {
        "API": "impacts"
      }
    }
  ]
}

Bei einem Status von ISSUES_DETECTED werden auch eine Reihe von Problemen zurückgegeben, die darauf hinweisen, dass die über die Projekt-ID aufgerufenen Funktionen möglicherweise nicht korrekt sind.

Wenn Sie nicht berechtigt sind, den Status abzurufen, erhalten Sie den Fehler PERMISSION_DENIED.

{
  "error": {
    "code": 403,
    "message": "Permission 'servicehealth.statuses.get' denied on resource '//servicehealth.googleapis.com/projects/PROJECT_ID/locations/global/status' (or it may not exist).",
    "status": "PERMISSION_DENIED",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "IAM_PERMISSION_DENIED",
        "domain": "servicehealth.googleapis.com",
        "metadata": {
          "resource": "projects/PROJECT_ID/locations/global/status",
          "permission": "servicehealth.statuses.get"
        }
      }
    ]
  }
}

Dienststatus mit einer Organisations-ID abrufen

Verwenden Sie die folgende Anfrage, um den Status abzurufen:

GET https://servicehealth.googleapis.com/v1beta/organizations/ORGANIZATION_ID/locations/global/status

Wenn der Dienst ohne Probleme funktioniert, sollte die folgende Antwort zurückgegeben werden:

{
  "state": "OK",
}

Wenn bei der Dienstbereitschaft Probleme auftreten, die sich auf ihre Genauigkeit oder Funktionalität auswirken können, sollte der Status eine Antwort mit dem Status ISSUES_DETECTED zurückgeben:

{
  "state": "ISSUES_DETECTED",
  "issues": [
    {
      "message": "We are experiencing problems creating new organization level events",
      "details": {
        "API": "organizationEvents"
      }
    },
    {
      "message": "We are experiencing problems creating new organization level impacts",
      "details": {
        "API": "organizationImpacts"
      }
    }
  ]
}

Wenn Sie nicht die Berechtigungen zum Abrufen des Status haben, erhalten Sie den Fehler PERMISSION_DENIED.

{
  "error": {
    "code": 403,
    "message": "Permission 'servicehealth.statuses.get denied on resource '//servicehealth.googleapis.com/organizations/ORGANIZATION_ID/locations/global/status' (or it may not exist).",
    "status": "PERMISSION_DENIED",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "IAM_PERMISSION_DENIED",
        "domain": "servicehealth.googleapis.com",
        "metadata": {
          "resource": "organizations/ORGANIZATION_ID/locations/global/status",
          "permission": "servicehealth.statuses.get"
        }
      }
    ]
  }
}

Google Cloud Service Health prüfen

Unter Google Cloud Dienststatus sehen Sie, ob bei Personalized Service Health ein Problem auftritt. Sie können die Daten auch über einen RSS-Feed abrufen.

Weitere Informationen zur Google Cloud Dienstbereitschaft finden Sie unter Vorfälle und Google Cloud Dienstbereitschaft.