Para usar o Monitoring, é necessário ter as permissões adequadas do Identity and Access Management (IAM). Em geral, cada método REST em uma API tem uma permissão associada. Para usar o método ou um recurso do console que depende dele, você precisa ter a permissão para usar o método correspondente. As permissões não são concedidas diretamente aos usuários. Em vez disso, elas são concedidas indiretamente por meio de papéis, que agrupam várias permissões para facilitar o gerenciamento delas:
- Para informações sobre controle de acesso, consulte Conceitos relacionados ao gerenciamento de acesso.
- Para saber como conceder papéis a principais, consulte Conceder acesso ao Cloud Monitoring.
Os papéis para combinações comuns de permissões são predefinidos para você. No entanto, você também pode criar suas próprias combinações de permissões gerando papéis personalizados do IAM.
Prática recomendada
Recomendamos que você crie Grupos do Google para gerenciar o acesso aos Projetos do Google Cloud:
- Para mais informações, consulte Como gerenciar grupos no console do Google Cloud.
- Para informações sobre como definir limites de funções, consulte Definir limites para a concessão de papéis.
- Para uma lista completa de papéis e permissões do IAM, consulte a referência de papéis básicos e predefinidos do IAM.
VPC Service Controls
Para ter mais acesso de controle aos dados de monitoramento, use o VPC Service Controls, além do IAM.
O VPC Service Controls oferece segurança adicional para o Cloud Monitoring, o que ajuda a reduzir o risco de filtração externa de dados. Com o VPC Service Controls, é possível adicionar um escopo de métricas a um perímetro de serviço que protege os recursos e serviços do Cloud Monitoring contra solicitações originadas de fora do perímetro.
Saiba mais sobre perímetros de serviço na documentação de configuração dos perímetros de serviço do VPC Service Controls.
Para informações sobre o suporte do Monitoring para o VPC Service Controls, incluindo limitações conhecidas, consulte a documentação do VPC Service Controls do Monitoring.
Conceder acesso ao Cloud Monitoring
Para gerenciar papéis do IAM para principais, use a página "Identity and Access Management" no console do Google Cloud ou na CLI do Google Cloud. No entanto, o Cloud Monitoring oferece uma interface simplificada que permite gerenciar papéis específicos do Monitoring, papéis no nível do projeto e os papéis comuns do Cloud Logging e do Cloud Trace.
Para conceder acesso a administradores ao Monitoring, Cloud Logging ou Cloud Trace ou para conceder um papel no nível do projeto, faça o seguinte:
Console
-
No console do Google Cloud, acesse a página
Permissões:Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
A página Permissões não mostra todos os principais. Ele lista apenas os participantes que têm um papel no nível do projeto ou um papel específico para monitoramento, registro ou rastreamento.
Nas opções desta página, você confere todos os principais com papéis que incluem qualquer permissão do Monitoring.
Clique em
CONCEDER ACESSO.Clique em Novos participantes e insira o nome de usuário do participante. É possível adicionar vários usuários principais.
Expanda arrow_drop_down Selecionar papel e selecione um valor na Por produto ou serviço. Em seguida, selecione uma função em Papéis menu:
Seleção Por produto ou serviço Seleção de papéis Descrição Monitoramento Visualizador de monitoramento Acessar dados de monitoramento e informações de configuração. Por exemplo, os principais com essa função podem acessar painéis personalizados e políticas de alerta. Monitoramento Editor do Monitoring Acessar dados de monitoramento e criar e editar configurações. Por exemplo, os administradores com essa função podem criar painéis personalizados e políticas de alerta. Monitoramento Administrador do Monitoring Acesse os dados do Monitoring, crie e edite configurações e modifique o escopo de métricas. Cloud Trace Usuário do Cloud Trace Acesso total ao console do Trace, acesso de leitura a traces e acesso de leitura e gravação a coletores. Para mais informações, consulte Rastrear papéis. Cloud Trace Administrador do Cloud Trace Acesso total ao console do Trace, acesso de leitura e gravação a traces e acesso de leitura e gravação a coletores. Para mais informações, consulte Papéis de rastreamento. Geração de registros Visualizador de registros Acesso para visualizar registros. Para mais informações, consulte Papéis de registro. Geração de registros Administrador do Logging Acesso total a todos os recursos do Cloud Logging. Para mais informações, consulte Papéis do Logging. Projeto Visualizador Acesso de leitura à maioria dos recursos do Google Cloud. Projeto Editor Visualize, crie, atualize e exclua a maioria dos recursos do Google Cloud. Projeto Proprietário Acesso total à maioria dos recursos do Google Cloud. Opcional: para conceder outro papel aos mesmos principais, clique em Adicione outro papel e repita a etapa anterior.
Clique em Salvar.
As etapas anteriores descrevem como conceder determinados papéis a um principal usando Páginas de monitoramento no console do Google Cloud. Para estes funções, essa página também oferece opções de edição e exclusão:
Para remover papéis de um participante, marque a caixa ao lado dele e clique em
Remover acesso.Para editar os papéis de um principal, clique em edit Editar. Depois de atualizar as configurações, Clique em Salvar.
gcloud
Use o comando gcloud projects add-iam-policy-binding
para conceder o papel monitoring.viewer
ou monitoring.editor
.
Exemplo:
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"
Use o comando gcloud projects get-iam-policy
para confirmar os papéis concedidos:
export PROJECT_ID="my-test-project"
gcloud projects get-iam-policy $PROJECT_ID
Papéis predefinidos
Esta seção lista um subconjunto de papéis do IAM predefinidos pelo Cloud Monitoring.
Papéis do Monitoring
Os papéis a seguir concedem permissões gerais para o Monitoring:
Nome Cargo |
Inclui as permissões |
---|---|
roles/monitoring.viewer Visualizador do Monitoring |
Concede acesso somente leitura ao Monitoring no console do Google Cloud e à API Cloud Monitoring. |
roles/monitoring.editor Editor do Monitoring |
Concede acesso de leitura e gravação ao Monitoring no console do Google Cloud e a API Cloud Monitoring. |
roles/monitoring.admin Administrador do Monitoring |
Concede acesso total ao Monitoring no console do Google Cloud e a API Cloud Monitoring. |
O papel a seguir é usado pelas contas de serviço para acesso somente de gravação:
Nome Cargo |
Descrição |
---|---|
roles/monitoring.metricWriter Gravador de métricas do Monitoring |
Esse papel é para contas de serviço e agentes. |
Funções da política de alertas
Os papéis a seguir concedem permissões para políticas de alertas:
Nome Cargo |
Descrição |
---|---|
roles/monitoring.alertPolicyViewer Visualizador de AlertPolicy do Monitoring |
Concede acesso somente leitura a políticas de alertas. |
roles/monitoring.alertPolicyEditor Editor de AlertPolicy do Monitoring |
Concede acesso de leitura e gravação a políticas de alertas. |
Papéis do painel
Os papéis a seguir concedem permissões somente para painéis:
Nome Cargo |
Descrição |
---|---|
roles/monitoring.dashboardViewer Visualizador de configuração de painel do Monitoring |
Concede acesso somente leitura às configurações do painel. |
roles/monitoring.dashboardEditor Editor de configuração de painel do Monitoring |
Concede acesso de leitura e gravação às configurações do painel. |
Papéis de incidentes
Os papéis a seguir concedem permissões apenas para incidentes:
Nome Cargo |
Descrição |
---|---|
roles/monitoring.cloudConsoleIncidentViewer Visualizador de incidentes do Console do Cloud do Monitoring |
Concede acesso para visualizar incidentes usando o console do Google Cloud. |
roles/monitoring.cloudConsoleIncidentEditor Como monitorar o editor de incidentes do console do Cloud |
Concede acesso para ver, reconhecer e fechar incidentes usando o console do Google Cloud. |
Para informações sobre como resolver erros de permissão do IAM ao visualizar incidentes, consulte Não foi possível ver os detalhes do incidente devido a um erro de permissão.
Papéis do canal de notificação
Os papéis a seguir concedem permissões apenas para canais de notificação:
Nome Cargo |
Descrição |
---|---|
roles/monitoring.notificationChannelViewer Visualizador de NotificationChannel do Monitoring |
Concede acesso somente leitura a canais de notificação. |
roles/monitoring.notificationChannelEditor Editor de NotificationChannel do Monitoring |
Concede acesso de leitura e gravação a canais de notificação. |
Adiar papéis de notificação
Os papéis a seguir concedem permissões para adiar notificações:
Nome Cargo |
Descrição |
---|---|
roles/monitoring.snoozeViewer Visualizador de adiamento do Monitoring |
Concede acesso somente leitura a adiamentos. |
roles/monitoring.snoozeEditor Editor de adiamento do Monitoring |
Concede acesso de leitura e gravação a adiamentos. |
Papéis do Service Monitoring
Os papéis a seguir concedem permissões para o gerenciamento de serviços:
Nome Cargo |
Descrição |
---|---|
roles/monitoring.servicesViewer Visualizador dos serviços do Monitoring |
Concede acesso somente leitura aos serviços. |
roles/monitoring.servicesEditor Editor dos serviços do Monitoring |
Concede acesso de leitura e gravação aos serviços. |
Para mais informações sobre o monitoramento de serviços, consulte Monitoramento de SLO.
Papéis de configuração de verificação de tempo de atividade
Os papéis a seguir concedem permissões somente para configurações da verificação de tempo de atividade:
Nome Cargo |
Descrição |
---|---|
roles/monitoring.uptimeCheckConfigViewer Visualizador de configurações de verificação de tempo de atividade do Monitoring |
Concede acesso somente leitura a configurações de verificação de tempo de atividade. |
roles/monitoring.uptimeCheckConfigEditor Editor de configurações de verificação de tempo de atividade do Monitoring |
Concede acesso de leitura e gravação a configurações de verificação de tempo de atividade. |
Papéis de configuração do escopo de métricas
Os papéis a seguir concedem permissões gerais para escopos de métricas:
Nome Cargo |
Descrição |
---|---|
roles/monitoring.metricsScopesViewer Leitor de escopos de métricas de monitoramento |
Concede acesso somente leitura aos escopos de métricas. |
roles/monitoring.metricsScopesAdmin Administrador de escopos de métricas do Monitoring |
Concede acesso de leitura/gravação a escopos de métricas. |
Permissões para papéis predefinidos
Esta seção lista as permissões atribuídas aos papéis predefinidos com o Monitoring.
Para mais informações sobre papéis predefinidos, consulte IAM: papéis e permissões. Para receber ajuda para escolher os papéis predefinidos mais apropriados, consulte Escolher papéis predefinidos.
Permissões para papéis de monitoramento
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:
|
|
Permissões para papéis de monitoramento de configuração de operações
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. |
|
Permissões para papéis do 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. |
|
Permissões de monitoramento incluídas nos papéis do Google Cloud
Os papéis do Google Cloud incluem estas permissões:
Nome Cargo |
Inclui as permissões |
---|---|
roles/viewer Leitor |
As permissões do Monitoring são iguais às de roles/monitoring.viewer . |
roles/editor Editor |
As permissões do Monitoring são as mesmas do
Este papel não concede permissão para modificar um escopo de métricas.
Para modificar um escopo de métricas ao usar a API, sua função precisa incluir a permissão |
roles/owner Proprietário |
As permissões do Monitoring são as mesmas do
roles/monitoring.admin :
|
Papéis personalizados
Crie um papel personalizado quando quiser conceder ao principal
um conjunto mais limitado de permissões do que as concedidas com papéis predefinidos.
Por exemplo, se você configurar Assured Workloads
porque tem requisitos de residência de dados ou
Impact Level 4 (IL4),
não use verificações de tempo de atividade, porque não há
garantia de que os dados de verificação de tempo de atividade sejam mantidos em um local geográfico específico.
Para impedir o uso de verificações de tempo de atividade, crie uma função que não inclua nenhuma
permissão com o prefixo monitoring.uptimeCheckConfigs
.
Para criar um papel personalizado com as permissões do Monitoring, siga estas etapas:
Para um papel que conceda permissões apenas para a API Monitoring, escolha as permissões na seção Permissões e papéis predefinidos.
Para um papel que conceda permissões para o Monitoring no console do Google Cloud, escolha entre os grupos de permissões na seção Papéis do Monitoring.
Para conceder a capacidade de gravar dados de monitoramento, inclua as permissões do papel
roles/monitoring.metricWriter
na seção Permissões e papéis predefinidos.
Para mais informações sobre papéis personalizados, consulte Como compreender papéis personalizadas do IAM.
Escopos de acesso do Compute Engine
Os escopos de acesso são o método legado de especificar permissões para as instâncias de VM do Compute Engine. Os escopos de acesso a seguir se aplicam ao Monitoring:
Escopo de acesso | Permissões concedidas |
---|---|
https://www.googleapis.com/auth/monitoring.read | As mesmas permissões de roles/monitoring.viewer . |
https://www.googleapis.com/auth/monitoring.write | As mesmas permissões de roles/monitoring.metricWriter . |
https://www.googleapis.com/auth/monitoring | Acesso completo ao Monitoring. |
https://www.googleapis.com/auth/cloud-platform | Acesso completo a todas as APIs do Cloud ativadas. |
Para mais detalhes, consulte Escopos de acesso.
Prática recomendada. Uma prática recomendada é fornecer às instâncias de VM o
escopo de acesso mais avançado (cloud-platform
) e usar os papéis
do IAM para restringir o acesso a APIs e operações específicas. Para mais detalhes, consulte Permissões da conta de serviço.