Verificare la presenza di interruzioni con Personalized Service Health

Questo documento spiega cosa fare se Personalized Service Health subisce un'interruzione.

Personalized Service Health potrebbe essere interessato da un incidente, parzialmente o completamente. Puoi controllare la presenza di incidenti, problemi di elaborazione e problemi di prestazioni con Service Health tramite la risorsa API Status e la dashboard di Google Cloud Service Health.

Utilizzare l'API Status

La risorsa API Status dell'API Service Health indica se funzionalità specifiche di Service Health riscontrano problemi.

Prima di iniziare

Per iniziare a utilizzare l'API Status:

  1. Abilita l'API Service Health per il progetto o l'organizzazione che utilizzerai per accedere a questo stato.

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

  3. Imposta le autorizzazioni per accedere all'API Service Health.

  4. Configura le autorizzazioni Identity and Access Management (IAM) sul tuo progetto o sulla tua organizzazione per utilizzare l'API Status.

    Per configurare le autorizzazioni per il tuo progetto, esegui questo comando:

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

    Per configurare le autorizzazioni nella tua organizzazione, esegui questo comando:

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

    Per ottenere il tuo ORGANIZATION_ID, vedi Ottenere l'ID risorsa dell'organizzazione.

I criteri IAM concessi a un'organizzazione vengono ereditati da tutti i progetti dell'organizzazione. Questi criteri ti consentono di accedere alle API per eventi di organizzazione e progetto in tutta l'organizzazione.

Riferimenti

Consulta il riferimento API Status per il metodo che puoi utilizzare e il significato dei campi nella risposta.

Quando imposti il prodotto o la località, utilizza i valori riportati in Prodotti Google Cloud e Località.

Recuperare lo stato di Service Health utilizzando un ID progetto

Per ottenere lo stato di Service Health utilizzando un ID progetto, utilizza la seguente richiesta:

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

Se il valore dello stato è OK, la richiesta genera la seguente risposta:

{
  "state": "OK",
}

Questo stato indica che le funzionalità a cui si accede utilizzando l'ID progetto, ad esempio eventi o impatti, non presentano problemi internamente.

Se il valore dello stato è ISSUES_DETECTED, la richiesta genera la seguente risposta:

{
  "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"
      }
    }
  ]
}

Uno stato ISSUES_DETECTED restituisce anche un insieme di problemi, a indicare che le funzionalità a cui si accede utilizzando l'ID progetto potrebbero non essere accurate.

Se non disponi delle autorizzazioni per ottenere lo stato, riceverai un errore 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"
        }
      }
    ]
  }
}

Recuperare lo stato di Service Health utilizzando un ID organizzazione

Per ottenere lo stato, utilizza la seguente richiesta:

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

Se lo stato del servizio funziona senza problemi, lo stato dovrebbe restituire la seguente risposta:

{
  "state": "OK",
}

Se Service Health riscontra problemi che potrebbero influire sulla sua accuratezza o capacità, lo stato dovrebbe restituire una risposta con lo stato ISSUES_DETECTED:

{
  "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"
      }
    }
  ]
}

Se non disponi delle autorizzazioni per ottenere lo stato, riceverai un errore 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"
        }
      }
    ]
  }
}

Controlla Google Cloud Service Health

Google Cloud Service Health ti informa se Personalized Service Health sta riscontrando un problema. Puoi anche utilizzare un feed RSS per utilizzare i dati.

Per ulteriori informazioni su Google Cloud Service Health, consulta Incidenti e Google Cloud Service Health.