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

Ce document explique comment définir des autorisations et activer l'accès pour :

  • Affichez les événements Personalized Service Health à l'aide du tableau de bord Service Health.
  • Récupérez les informations de Service Health à l'aide de l'API Service Health.
  • Configurez des alertes concernant vos projets.

Avant de commencer

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

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

Pour obtenir les autorisations nécessaires pour accéder à l'API et au tableau de bord Service Health, demandez à votre administrateur de vous accorder le rôle IAM Lecteur Personalized Service Health (roles/servicehealth.viewer) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

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

Vous pouvez utiliser les rôles et les autorisations directement via la gcloud CLI pour configurer les contrôles d'accès appropriés. Par exemple, vous pouvez attribuer le rôle directement à l'aide de 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 IAM (Identity and Access Management) du projet donné à l'aide de la commande suivante :

gcloud projects get-iam-policy PROJECT_ID

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

gcloud iam roles update ROLE_ID \
  --project=PROJECT_ID \
  --permissions="servicehealth.events.get,servicehealth.events.list,servicehealth.impacts.get,servicehealth.impacts.list,servicehealth.locations.get,servicehealth.locations.list,servicehealth.organizationEvents.get,servicehealth.organizationEvents.list,servicehealth.organizationImpacts.get,servicehealth.organizationImpacts.list,servicehealth.statuses.get,resourcemanager.projects.get,resourcemanager.projects.list"

Contrôler l'accès aux détails des ressources concernées (preview)

Les autorisations servicehealth.impacts.list et servicehealth.impacts.get sont incluses dans le rôle prédéfini de lecteur Service Health (roles/servicehealth.viewer) et dans les rôles de base Lecteur, Éditeur et Propriétaire (roles/viewer, roles/editor, roles/owner).

Lorsqu'une interruption de service affecte des ressources spécifiques de votre projet, ces autorisations permettent aux comptes principaux d'afficher les noms complets (assetName) et les types (assetType) des ressources concernées dans l'ensemble du projet.

Si vous souhaitez qu'un compte principal puisse afficher les événements Service Health au niveau du projet sans voir les noms des ressources individuelles concernées dans le projet, créez un rôle personnalisé incluant servicehealth.events.get et servicehealth.events.list, mais omettant servicehealth.impacts.get et servicehealth.impacts.list :

gcloud iam roles create EVENT_ONLY_ROLE_ID --project=PROJECT_ID \
--title="Service Health Event-Only Viewer" \
--description="Grants access to Service Health project events without resource-level impact details" \
--permissions="servicehealth.events.get,servicehealth.events.list,servicehealth.locations.get,servicehealth.locations.list,servicehealth.statuses.get,resourcemanager.projects.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 de journal

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 Monitoring NotificationChannel (roles/monitoring.notificationChannelEditor), vous pouvez attribuer le rôle Lecteur Monitoring NotificationChannel (roles/monitoring.notificationChannelViewer) pour vous permettre d'associer un canal de notification à 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 via 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 Service Health, vous devez activer l'API Service Health. Vous pouvez activer l'API via la consoleGoogle Cloud ou Google Cloud CLI.

Console

  1. Dans la bibliothèque d'API et de 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 console Google Cloud , activez Cloud Shell.

    Activer Cloud Shell

  2. Assurez-vous que la version la plus récente 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éez un projet Google Cloud  :

      gcloud projects create PROJECT_ID
    • Sélectionnez le projet Google Cloud 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.

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