Gérer l'accès à Personalized Service Health

Ce document explique comment définir des autorisations et activer l'accès pour pouvoir effectuer les opérations suivantes :

• Afficher les événements d'état des services à l'aide du tableau de bord Service Health.
• Extraire des informations sur l'état des services à l'aide de l'API Service Health.
• Configurer des alertes concernant vos projets.

Avant de commencer

Vérifiez que la facturation est activée pour votre Google Cloud projet.

Accéder à l'API et au tableau de bord Service Health

Personalized Service Health fournit un rôle prédéfini servicehealth.viewer que vous pouvez utiliser pour donner accès aux membres du projet. Utilisez ce rôle pour accéder à l'API et au tableau de bord Service Health.

Nom du rôle	Description	Autorisations Personalized Service Health
Lecteur Personalized Service Health roles/servicehealth.viewer	Accès en lecture seule aux événements d'état des services.	servicehealth.location.list servicehealth.location.get servicehealth.events.list servicehealth.events.get servicehealth.organizationEvents.list servicehealth.organizationEvents.get servicehealth.organizationImpacts.list servicehealth.organizationImpacts.get

Conseil : Pour obtenir les autorisations d'accès à Personalized Service Health tout en respectant le principe du moindre privilège, demandez à votre administrateur de vous attribuer le roles/servicehealth.viewer (Lecteur Personalized Service Health). Si vous disposez déjà de l'un des rôles de base (Lecteur, Éditeur ou Propriétaire), vous disposez déjà des autorisations nécessaires pour accéder à Personalized Service Health.

Vous pouvez utiliser directement les rôles et les autorisations via la gcloud CLI pour configurer des contrôles d'accès appropriés. Par exemple, vous pouvez attribuer le rôle directement avec la commande suivante :

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

Vous pouvez afficher la stratégie Identity and Access Management (IAM) pour le projet donné avec la commande suivante :

gcloud projects get-iam-policy PROJECT_ID

Vous pouvez également ajouter directement les autorisations à un rôle existant :

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

Utiliser des API et des services dans vos projets

1. Activez l'API Service Health pour le projet.
2. Attribuez le rôle Consommateur Service Usage (roles/serviceusage.serviceUsageConsumer).

Accéder aux journaux et configurer des alertes basées sur les journaux

Procédez comme suit :

1. Activez l'API Service Health pour le projet.
2. Obtenez les autorisations pour les alertes basées sur les journaux.

Si vous ne souhaitez pas attribuer le rôle Éditeur de canal de notification Monitoring (roles/monitoring.notificationChannelEditor), vous pouvez attribuer le rôle Lecteur de canal de notification Monitoring (roles/monitoring.notificationChannelViewer) à la place pour vous permettre de créer un lien vers un canal de notification dans une règle d'alerte.

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Activer l'API Service Health pour un seul projet

Pour configurer des alertes et extraire des informations sur l'état des services, vous devez activer l'API Service Health. Vous pouvez activer l'API via la Google Cloud console ou Google Cloud CLI.

Console

1. Dans la bibliothèque API et services, accédez à l'API Service Health.

   Accéder à l'API Service Health

   Vous pouvez également accéder à la bibliothèque d'API et rechercher "API Service Health".

2. Sélectionnez le projet.

3. Sélectionnez le bouton Activer.

gcloud

1. Dans la Google Cloud console, activez Cloud Shell.

   Activer Cloud Shell

2. Assurez-vous que la dernière version de Google Cloud CLI est installée. Exécutez la commande suivante depuis Cloud Shell :

     gcloud components update

3. Créez ou sélectionnez un projet, PROJECT_ID.

   • Créer un Google Cloud projet :

     gcloud projects create PROJECT_ID

   • Sélectionnez le Google Cloud projet que vous avez créé :

     gcloud projects config set project PROJECT_ID

4. Activez l'API Service Health dans le projet que vous venez de créer.

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

Script

Vous pouvez utiliser un script pour activer l' API Service Health pour les projets de votre organisation ou de votre dossier.

Pour obtenir des informations générales, consultez Activer une API dans votre Google Cloud projet.

L'API Service Health et les alertes reconnaissent les nouveaux événements quelques heures après l'activation de l'API.