Nesta página, descrevemos como ativar e autorizar o uso da API Monitoring v3. É necessário ativar essa API antes de usá-la.
Ativar a API Monitoring
Para ativar a API Monitoring, use o Google Cloud console ou a Google Cloud CLI.
Console
Ative a API Cloud Monitoring.
Funções necessárias para ativar APIs
Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder
papéis.
gcloud
Ative a API Cloud Monitoring:
Funções necessárias para ativar APIs
Para ativar as APIs, é necessário ter o papel do IAM de administrador de Service Usage
role (roles/serviceusage.serviceUsageAdmin), que contém a
serviceusage.services.enable permissão. Saiba como conceder
papéis.
gcloud services enable monitoring.googleapis.com
Autorizar o uso da API Monitoring
O acesso à API Monitoring é controlado pelos papéis e permissões do Identity and Access Management (IAM). Há uma permissão associada a cada método, e as permissões para métodos relacionados são agrupadas em papéis, que podem ser concedidos aos usuários. Para mais informações, consulte Controlar o acesso com o IAM.
Depois que o acesso a uma API é autorizado, ela pode ser usada de qualquer lugar.
Por exemplo, é possível chamar o timeSeries.list
método da estação de trabalho local. Também é possível usar a API para enviar métricas a qualquer entidade que possa ser representada como um recurso monitorado.
Consulte Tipos de recursos monitorados para métricas definidas pelo usuário
para conferir a lista de tipos disponíveis.
Se você estiver gravando um aplicativo que usa as bibliotecas de cliente recomendadas, essas bibliotecas autorizarão o aplicativo usando Application Default Credentials.
Também é possível usar chaves de API em algumas situações, mas as contas de serviço geralmente são recomendadas. As chaves de API são úteis em clientes como navegadores e aplicativos para dispositivos móveis que não têm um servidor de back-end. Para saber mais, consulte como usar chaves de API.
Saiba mais sobre autenticação e autorização em nosso Guia de autenticação.