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
- Habilita la API de Service Health para el proyecto.
- Otorga el rol de Consumidor de Service Usage
(
roles/serviceusage.serviceUsageConsumer).
Acceder a los registros y configurar alertas de registro
Haz lo siguiente:
- Habilita la API de Service Health para el proyecto.
- 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
En la biblioteca de APIs y servicios, ve a la API de Service Health.
Como alternativa, puedes ir a la Biblioteca de APIs y buscar "API de Service Health".
Selecciona el proyecto.
Selecciona el botón Habilitar.
gcloud
-
En la consola de Google Cloud , activa Cloud Shell.
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
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
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.