Rechercher des perturbations avec Personalized Service Health

Ce document explique ce qu'il faut faire en cas d'indisponibilité de Personalized Service Health.

Il est possible que Personalized Service Health soit affecté partiellement ou totalement par un incident. Vous pouvez rechercher des incidents, des problèmes de traitement et des problèmes de performances avec Service Health à l'aide de la ressource Status API et du tableau de bord Google CloudService Health.

Utiliser l'API Status

La ressource d'API Status de l'API Service Health vous indique si des fonctionnalités Service Health spécifiques rencontrent des problèmes.

Avant de commencer

Pour commencer à utiliser l'API Status :

  1. Activez l'API Service Health pour le projet ou l'organisation que vous utiliserez pour accéder à cet état.
  2. Make sure that billing is enabled for your Google Cloud project.

  3. Définissez les autorisations d'accès à l'API Service Health.
  4. Configurez les autorisations Identity and Access Management (IAM) sur votre projet ou votre organisation pour utiliser l'API Status.

    Pour configurer les autorisations sur votre projet, exécutez la commande suivante :

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

    Pour configurer les autorisations dans votre organisation, exécutez la commande suivante :

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

    Pour obtenir votre ORGANIZATION_ID, consultez Obtenir l'ID de ressource de votre organisation.

Les stratégies IAM accordées à une organisation sont héritées par tous les projets de l'organisation. Ces règles vous permettent d'accéder aux API d'événements d'organisation et de projet dans l'ensemble de l'organisation.

Références

Consultez la documentation de référence de l'API Status pour connaître la méthode à utiliser et la signification des champs de la réponse.

Lorsque vous définissez le produit ou l'emplacement, utilisez les valeurs disponibles dans les produits Google Cloud et les emplacements.

Obtenir l'état de fonctionnement d'un service à l'aide d'un ID de projet

Pour obtenir l'état de l'Service Health à l'aide d'un ID de projet, utilisez la requête suivante :

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

Si la valeur de l'état est OK, la requête génère la réponse suivante :

{
  "state": "OK",
}

Ce statut indique que les fonctionnalités accessibles à l'aide de l'ID de projet, telles que les événements ou les impacts, ne rencontrent pas de problèmes en interne.

Si la valeur de l'état est ISSUES_DETECTED, la requête génère la réponse suivante :

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

Un état ISSUES_DETECTED renvoie également un ensemble de problèmes, indiquant que les fonctionnalités accessibles à l'aide de l'ID de projet peuvent ne pas être précises.

Si vous ne disposez pas des autorisations nécessaires pour obtenir l'état, une erreur PERMISSION_DENIED s'affiche.

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

Obtenir l'état de fonctionnement du service à l'aide d'un ID d'organisation

Pour obtenir l'état, utilisez la requête suivante :

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

Si l'état du service fonctionne sans problème, la réponse devrait être la suivante :

{
  "state": "OK",
}

Si l'état du service rencontre des problèmes susceptibles d'affecter sa précision ou ses capacités, l'état doit renvoyer une réponse avec l'état 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"
      }
    }
  ]
}

Si vous ne disposez pas des autorisations nécessaires pour obtenir l'état, une erreur PERMISSION_DENIED s'affiche.

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

Consulter l'état du service Google Cloud

Google Cloud État du service vous indique si Personalized Service Health rencontre un problème. Vous pouvez également utiliser un flux RSS pour consommer les données.

Pour en savoir plus sur Google Cloud Service Health, consultez Incidents et Google Cloud Service Health.