Para usar Monitoring, debes tener los permisos adecuados de Identity and Access Management (IAM). En general, cada método REST en una API tiene un permiso asociado. Para usar el método o una función de la consola que se base en él, debes tener el permiso correspondiente. Los permisos no se otorgan directamente a los usuarios. En cambio, los permisos se otorgan indirectamente a través de funciones, que agrupan varios permisos para facilitar su administración:
- Para obtener información sobre el control de acceso, consulta Conceptos relacionados con la administración del acceso.
- Para obtener información sobre cómo otorgar roles a las principales, consulta Otorga acceso a la supervisión de Cloud.
Los roles para combinaciones comunes de permisos están predefinidos. Sin embargo, también puedes crear tus propias combinaciones de permisos si creas funciones personalizadas de IAM.
Práctica recomendada
Te recomendamos que crees Grupos de Google para administrar el acceso a los proyectos de Google Cloud:
- Para obtener más información, consulta Administra grupos en la consola de Google Cloud.
- Para obtener información sobre cómo establecer límites en los roles, consulta Establece límites en el otorgamiento de roles.
- Para obtener una lista completa de los roles y permisos de IAM, consulta Referencia de roles básicos y predefinidos de IAM.
Controles del servicio de VPC
Para tener más control sobre el acceso a los datos de supervisión, usa los Controles del servicio de VPC además de IAM.
Los Controles del servicio de VPC brindan seguridad adicional para Cloud Monitoring a fin de mitigar el riesgo de robo de datos. Si usas los Controles del servicio de VPC, puedes agregar un permiso de métricas a un perímetro de servicio que proteja los recursos y servicios de Cloud Monitoring de las solicitudes que se originan fuera del perímetro.
Para obtener más información sobre los perímetros de servicio, consulta la documentación de configuración del perímetro de servicio de los Controles del servicio de VPC.
Para obtener información sobre la compatibilidad de Monitoring con los controles del servicio de VPC, incluidas las limitaciones conocidas, consulta la documentación de los controles del servicio de VPC.
Otorga acceso a Cloud Monitoring
Para administrar los roles de IAM de las principales entidades, puedes usar la página Identity and Access Management en la consola de Google Cloud o Google Cloud CLI. Sin embargo, Cloud Monitoring proporciona una interfaz simplificada que te permite gestionar tus roles específicos de Monitoring, los roles a nivel del proyecto y los roles comunes de Cloud Logging y Cloud Trace.
Para otorgar a los principales acceso a Monitoring, Cloud Logging o Cloud Trace, o para otorgar un rol a nivel del proyecto, haz lo siguiente:
Console
-
En la consola de Google Cloud, ve a la página
Permisos:Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
La página Permisos no muestra todos los principales. Solo enumera aquellos principales que tienen un rol a nivel del proyecto o uno específico de Monitoring, Logging o Trace.
Las opciones de esta página te permiten ver a todas las principales cuyos roles incluyen cualquier permiso de Monitoring.
Haz clic en
Grant access.Haz clic en Nuevas principales y, luego, ingresa el nombre de usuario de la principal. Puedes agregar varios principales.
Expande arrow_drop_down Selecciona un rol, selecciona un valor del menú Por producto o servicio y, luego, selecciona un rol del menú Roles:
Selección Por producto o servicio Selección de Roles Descripción Supervisión Visualizador de Monitoring Consultar los datos de Monitoring y la información de configuración Por ejemplo, los directores con este rol pueden ver paneles personalizados y políticas de alertas. Supervisión Editor de Monitoring Consulta los datos de supervisión y crea y edita parámetros de configuración. Por ejemplo, los directores con este rol pueden crear paneles personalizados y políticas de alertas. Supervisión Administrador de Monitoring Acceso completo a Monitoring en la consola de Google Cloud y a la API de Cloud Monitoring. Puedes ver los datos de Monitoring, crear y editar parámetros de configuración, y modificar el alcance de las métricas. Cloud Trace Usuario de Cloud Trace Acceso completo a la consola de Trace, acceso de lectura a los seguimientos y acceso de lectura y escritura a los receptores. Para obtener más información, consulta Roles de seguimiento. Cloud Trace Administrador de Cloud Trace Acceso completo a la consola de Trace, acceso de lectura y escritura a los seguimientos y acceso de lectura y escritura a los receptores. Para obtener más información, consulta Roles de seguimiento. Logging Visor de registros Ver el acceso a los registros Para obtener más información, consulta Roles de registro. Logging Administrador de Logging Acceso completo a todas las funciones de Cloud Logging. Para obtener más información, consulta Roles de registro. Proyecto Visualizador Visualiza el acceso a la mayoría de los recursos de Google Cloud. Proyecto Editor Puede ver, crear, actualizar y borrar la mayoría de los recursos de Google Cloud. Proyecto Propietario Acceso completo a la mayoría de los recursos de Google Cloud. Opcional: Para otorgar otro rol a los mismos principales, haz clic en Agregar otro rol y repite el paso anterior.
Haz clic en Guardar.
En los pasos anteriores, se describe cómo otorgarle a un principal ciertos roles con las páginas de Monitoring en la consola de Google Cloud. Para estos roles, esta página también admite las opciones de edición y eliminación:
Para quitar los roles de un principal, selecciona la casilla junto a él y, luego, haz clic en
Quitar acceso.Para editar los roles de un director, haz clic en edit Editar. Después de actualizar la configuración, haz clic en Guardar.
gcloud
Usa el comando gcloud projects add-iam-policy-binding
para otorgar la función monitoring.viewer
o monitoring.editor
.
Por ejemplo:
export PROJECT_ID="my-test-project"
export EMAIL_ADDRESS="myuser@gmail.com"
gcloud projects add-iam-policy-binding \
$PROJECT_ID \
--member="user:$EMAIL_ADDRESS" \
--role="roles/monitoring.editor"
Puedes confirmar las funciones otorgadas con el comando gcloud projects get-iam-policy
:
export PROJECT_ID="my-test-project"
gcloud projects get-iam-policy $PROJECT_ID
Funciones predefinidas
En esta sección, se enumera un subconjunto de roles de IAM que están predefinidos por Cloud Monitoring.
Funciones de Monitoring
Las siguientes funciones otorgan permisos para Monitoring:
Título del nombre |
Permisos incluidos |
---|---|
roles/monitoring.viewer Visualizador de Monitoring |
Otorga acceso de solo lectura a Monitoring en la consola de Google Cloud y a la API de Cloud Monitoring. |
roles/monitoring.editor Editor de Monitoring |
Otorga acceso de lectura y escritura a Monitoring en la consola de Google Cloud y a la API de Cloud Monitoring. |
roles/monitoring.admin Administrador de Monitoring |
Otorga acceso completo a Monitoring en la consola de Google Cloud y a la API de Cloud Monitoring. |
Las cuentas de servicio usan la siguiente función para el acceso de solo escritura:
Título del nombre |
Descripción |
---|---|
roles/monitoring.metricWriter Escritor de métricas de Monitoring |
Este rol es para cuentas de servicio y agentes. |
Roles de la política de alertas
Los siguientes roles otorgan permisos para las políticas de alertas:
Título del nombre |
Descripción |
---|---|
roles/monitoring.alertPolicyViewer Visualizador de políticas de alertas de Monitoring |
Otorga acceso de solo lectura a las políticas de alertas. |
roles/monitoring.alertPolicyEditor Editor de políticas de alertas de Monitoring |
Otorga acceso de lectura y escritura a las políticas de alertas. |
Roles del panel
Las siguientes funciones otorgan permisos solo para los paneles:
Título del nombre |
Descripción |
---|---|
roles/monitoring.dashboardViewer Visualizador de configuración del panel de Monitoring |
Otorga acceso de solo lectura a las configuraciones del panel. |
roles/monitoring.dashboardEditor Editor de configuración del panel de Monitoring |
Otorga acceso de lectura y escritura a la configuración del panel. |
Roles de incidentes
Las siguientes funciones otorgan permisos solo para los incidentes:
Título del nombre |
Descripción |
---|---|
roles/monitoring.cloudConsoleIncidentViewer Visualizador de incidentes de la consola de Cloud de Monitoring |
Otorga acceso para ver incidentes con la consola de Google Cloud. |
roles/monitoring.cloudConsoleIncidentEditor Editor de incidentes de la consola de Cloud de Monitoring |
Otorga acceso para ver, confirmar y cerrar incidentes mediante la consola de Google Cloud. |
Para obtener información sobre cómo resolver errores de permisos de IAM cuando visualizas incidentes, consulta No se pueden ver los detalles del incidente debido a un error de permiso.
Roles de los canales de notificación
Las siguientes funciones otorgan permisos solo para los canales de notificaciones:
Título del nombre |
Descripción |
---|---|
roles/monitoring.notificationChannelViewer Visualizador de canales de notificaciones de Monitoring |
Otorga acceso de solo lectura a los canales de notificación. |
roles/monitoring.notificationChannelEditor Editor de canales de notificaciones de Monitoring |
Otorga acceso de lectura y escritura a los canales de notificación. |
Roles de posposición de notificaciones
Los siguientes roles otorgan permisos para posponer notificaciones:
Título del nombre |
Descripción |
---|---|
roles/monitoring.snoozeViewer Visualizador de alertas pospuestas |
Otorga acceso de solo lectura a las posposiciones. |
roles/monitoring.snoozeEditor Editor de alertas pospuestas |
Otorga acceso de lectura y escritura a las posposiciones. |
Roles de supervisión de servicios
Las siguientes funciones otorgan permisos para administrar servicios:
Título del nombre |
Descripción |
---|---|
roles/monitoring.servicesViewer Visualizador de servicios de Monitoring |
Otorga acceso de solo lectura a los servicios. |
roles/monitoring.servicesEditor Editor de servicios de Monitoring |
Otorga acceso de lectura y escritura a los servicios. |
Para obtener más información sobre la supervisión de servicios, consulta Supervisión de SLO.
Roles de configuración de verificaciones de tiempo de actividad
Las siguientes funciones otorgan permisos solo para la configuración de verificaciones de tiempo de actividad:
Título del nombre |
Descripción |
---|---|
roles/monitoring.uptimeCheckConfigViewer Visualizador de configuración de verificaciones de tiempo de actividad de Monitoring |
Otorga acceso de solo lectura a la configuración de verificaciones de tiempo de actividad. |
roles/monitoring.uptimeCheckConfigEditor Editor de configuración de verificaciones de tiempo de actividad de Monitoring |
Otorga acceso de lectura y escritura a la configuración de verificaciones del tiempo de actividad. |
Roles de configuración del alcance de las métricas
Las siguientes funciones otorgan permisos generales para los permisos de métricas:
Título del nombre |
Descripción |
---|---|
roles/monitoring.metricsScopesViewer Visualizador de permisos de métricas de supervisión |
Otorga acceso de solo lectura a los permisos de las métricas. |
roles/monitoring.metricsScopesAdmin Administrador de permisos de métricas de supervisión |
Otorga acceso de lectura y escritura a los permisos de las métricas. |
Permisos para roles predefinidos
En esta sección, se enumeran los permisos asignados a los roles predefinidos asociados con Monitoring.
Para obtener más información sobre los roles predefinidos, consulta IAM: Roles y permisos. Si deseas obtener ayuda para elegir los roles predefinidos más adecuados, consulta Elige roles predefinidos.
Permisos de los roles de supervisión
Role | Permissions |
---|---|
Monitoring Admin( Provides full access to Cloud Monitoring. Lowest-level resources where you can grant this role:
|
|
Monitoring AlertPolicy Editor( Read/write access to alerting policies. |
|
Monitoring AlertPolicy Viewer( Read-only access to alerting policies. |
|
Monitoring Cloud Console Incident Editor Beta( Read/write access to incidents from Cloud Console. |
|
Monitoring Cloud Console Incident Viewer Beta( Read access to incidents from Cloud Console. |
|
Monitoring Dashboard Configuration Editor( Read/write access to dashboard configurations. |
|
Monitoring Dashboard Configuration Viewer( Read-only access to dashboard configurations. |
|
Monitoring Editor( Provides full access to information about all monitoring data and configurations. Lowest-level resources where you can grant this role:
|
|
Monitoring Metric Writer( Provides write-only access to metrics. This provides exactly the permissions needed by the Cloud Monitoring agent and other systems that send metrics. Lowest-level resources where you can grant this role:
|
|
Monitoring Metrics Scopes Admin Beta( Access to add and remove monitored projects from metrics scopes. |
|
Monitoring Metrics Scopes Viewer Beta( Read-only access to metrics scopes and their monitored projects. |
|
Monitoring NotificationChannel Editor Beta( Read/write access to notification channels. |
|
Monitoring NotificationChannel Viewer Beta( Read-only access to notification channels. |
|
Monitoring Services Editor( Read/write access to services. |
|
Monitoring Services Viewer( Read-only access to services. |
|
Monitoring Snooze Editor(
|
|
Monitoring Snooze Viewer(
|
|
Monitoring Uptime Check Configuration Editor Beta( Read/write access to uptime check configurations. |
|
Monitoring Uptime Check Configuration Viewer Beta( Read-only access to uptime check configurations. |
|
Monitoring Viewer( Provides read-only access to get and list information about all monitoring data and configurations. Lowest-level resources where you can grant this role:
|
|
Permisos para los roles de Monitoring de configuración de operaciones
Role | Permissions |
---|---|
Ops Config Monitoring Resource Metadata Viewer Beta( Read-only access to resource metadata. |
|
Ops Config Monitoring Resource Metadata Writer Beta( Write-only access to resource metadata. This provides exactly the permissions needed by the Ops Config Monitoring metadata agent and other systems that send metadata. |
|
Permisos de los roles de Stackdriver
Role | Permissions |
---|---|
Stackdriver Accounts Editor( Read/write access to manage Stackdriver account structure. |
|
Stackdriver Accounts Viewer( Read-only access to get and list information about Stackdriver account structure. |
|
Stackdriver Resource Metadata Writer Beta( Write-only access to resource metadata. This provides exactly the permissions needed by the Stackdriver metadata agent and other systems that send metadata. |
|
Permisos de supervisión incluidos en los roles de Google Cloud
Las funciones de Google Cloud incluyen estos permisos:
Título del nombre |
Permisos incluidos |
---|---|
roles/viewer Visualizador |
Los permisos de Monitoring son los mismos que los de roles/monitoring.viewer . |
roles/editor Editor |
Los permisos de Monitoring son los mismos que los de Este rol no otorga permiso para modificar el alcance de las métricas.
Para modificar el alcance de las métricas cuando usas la API, tu rol debe incluir el permiso |
roles/owner Propietario |
Los permisos de Monitoring son los mismos que los de roles/monitoring.admin .
|
Funciones personalizadas
Te recomendamos que crees un rol personalizado cuando quieras otorgarle a un miembro un conjunto de permisos más limitado que los otorgados con roles predefinidos.
Por ejemplo, si configuras Assured Workloads porque tienes requisitos de residencia de datos o de Impact Level 4 (IL4), no debes usar verificaciones de tiempo de actividad porque no hay garantía de que los datos de las verificaciones de tiempo de actividad se conserven en una ubicación geográfica específica.
Para evitar el uso de verificaciones de tiempo de actividad, crea un rol que no incluya ningún permiso con el prefijo monitoring.uptimeCheckConfigs
.
Para crear una función personalizada con permisos de Monitoring, realiza las siguientes acciones:
Para una función que otorgue permisos solo a la API de Monitoring, elige los permisos en la sección Permisos y roles predefinidos.
Para una función que otorgue permisos para Monitoring en la consola de Google Cloud, elige entre los grupos de permisos en la sección Roles de Monitoring.
Para otorgar la capacidad de escribir datos de supervisión, incluye los permisos de la función
roles/monitoring.metricWriter
en la sección Permisos y roles predefinidos.
Para obtener más información sobre las funciones personalizadas, consulta Comprende las funciones personalizadas de IAM.
Permisos de acceso de Compute Engine
Los niveles de acceso son el método heredado de especificar permisos para tus instancias de VM de Compute Engine. Los siguientes niveles de acceso se aplican a Monitoring:
Nivel de acceso | Permisos otorgados |
---|---|
https://www.googleapis.com/auth/monitoring.read | Los mismos permisos que en roles/monitoring.viewer |
https://www.googleapis.com/auth/monitoring.write | Los mismos permisos que en roles/monitoring.metricWriter |
https://www.googleapis.com/auth/monitoring | Acceso completo a Monitoring |
https://www.googleapis.com/auth/cloud-platform | Acceso completo a todas las API de Cloud habilitadas |
Para obtener más información, consulta Permisos de acceso.
Prácticas recomendadas: Una práctica recomendada es configurar las instancias de VM con el permiso de acceso más eficaz (cloud-platform
) y, luego, usar las funciones de IAM para restringir el acceso a operaciones y APIs específicas. Para obtener más información, consulta Permisos de la cuenta de servicio.