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 APIs, é necessário ter a permissão serviceusage.services.enable. Se você
criou o projeto, provavelmente já tem essa permissão com o
papel de proprietário (roles/owner). Caso contrário, você pode receber essa permissão com o
papel de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin).
Saiba como conceder papéis.
gcloud
Ative a API Cloud Monitoring:
Funções necessárias para ativar APIs
Para ativar APIs, é necessário ter a permissão serviceusage.services.enable. Se você
criou o projeto, provavelmente já tem essa permissão com o
papel de proprietário (roles/owner). Caso contrário, você pode receber essa permissão com o
papel de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin).
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.