Administra el acceso a Personalized Service Health

En este documento, se explica cómo configurar permisos y habilitar el acceso para que puedas hacer lo siguiente:

  • Consulta los eventos de Personalized Service Health con el panel de Service Health.
  • Extrae información de Service Health con la API de Service Health.
  • Configura alertas relevantes para tus proyectos.

Antes de comenzar

Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

Accede a la API y al panel de Service Health

Para obtener los permisos que necesitas para acceder a la API y al panel de Service Health, pídele a tu administrador que te otorgue el rol de IAM de Visualizador de Personalized Service Health (roles/servicehealth.viewer) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Puedes usar los roles y permisos directamente a través de gcloud CLI para configurar los controles de acceso adecuados. Por ejemplo, puedes otorgar el rol directamente con el siguiente comando:

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

Puedes ver la política de Identity and Access Management (IAM) para el proyecto determinado con el siguiente comando:

gcloud projects get-iam-policy PROJECT_ID

Como alternativa, puedes agregar los permisos directamente a un rol existente:

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"

Controla el acceso a los detalles de los recursos afectados (versión preliminar)

Los permisos servicehealth.impacts.list y servicehealth.impacts.get se incluyen en el rol predefinido de visualizador de Service Health (roles/servicehealth.viewer) y en los roles básicos de visualizador, editor y propietario (roles/viewer, roles/editor, roles/owner).

Cuando una interrupción del servicio afecta recursos específicos de tu proyecto, estos permisos permiten que las principales vean los nombres completos de los recursos (assetName) y los tipos de recursos (assetType) de los recursos afectados en todo el proyecto.

Si deseas que una principal vea los eventos de Service Health a nivel del proyecto sin ver los nombres de los recursos individuales afectados en el proyecto, crea un rol personalizado que incluya servicehealth.events.get y servicehealth.events.list, pero omita servicehealth.impacts.get y 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"

Usa APIs y servicios en tus proyectos

  1. Habilita la API de Service Health para el proyecto.
  2. Otorga el rol de Consumidor de Service Usage (roles/serviceusage.serviceUsageConsumer).

Acceder a los registros y configurar alertas de registro

Haz lo siguiente:

  1. Habilita la API de Service Health para el proyecto.
  2. Obtén permisos para las alertas basadas en registros.

Si no quieres otorgar el rol de editor de canal de notificación de Monitoring (roles/monitoring.notificationChannelEditor), puedes otorgar el rol de visualizador de canal de notificación de Monitoring (roles/monitoring.notificationChannelViewer) para que puedas vincular un canal de notificaciones a una política de alertas.

Si quieres obtener más información para otorgar roles, consulta Administra el acceso.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Habilita la API de Service Health para un solo proyecto

Para configurar alertas y extraer información de Service Health, se debe habilitar la API de Service Health. Puedes habilitar la API a través de la consola deGoogle Cloud o Google Cloud CLI.

Console

  1. En la biblioteca de APIs y servicios, ve a la API de Service Health.

    Ir a la API de Service Health

    Como alternativa, puedes ir a la Biblioteca de APIs y buscar "API de Service Health".

  2. Selecciona el proyecto.

  3. Selecciona el botón Habilitar.

gcloud

  1. En la consola de Google Cloud , activa Cloud Shell.

    Activa Cloud Shell

  2. Asegúrate de que esté instalada la versión más reciente de Google Cloud CLI. Ejecuta el siguiente comando desde Cloud Shell:

      gcloud components update

  3. Crea o selecciona un proyecto nuevo, PROJECT_ID.

    • Crea un proyecto de Google Cloud :

      gcloud projects create PROJECT_ID
    • Selecciona el proyecto de Google Cloud que creaste:

      gcloud projects config set project PROJECT_ID
  4. Habilita la API de Service Health en el proyecto que acabas de crear.

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

Secuencia de comandos

Puedes usar una secuencia de comandos para habilitar la API de Service Health en los proyectos de tu organización o carpeta.

La API de Service Health y las alertas reconocerán los eventos nuevos unas horas después de la habilitación de la API.