Nesta página, descrevemos como ativar e autorizar o uso da API Monitoring v3. Você precisa ativar essa API antes de usá-la.
Ativar a API Monitoring
Para ativar a API Monitoring, use o console do Google Cloud ou a Google Cloud CLI.
Console
Ative a API Cloud Monitoring, se ela ainda não estiver ativada.
Funções necessárias para ativar APIs
Para ativar APIs, você precisa da 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, é possível receber essa permissão com o papel de
Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin).
Saiba como conceder papéis.
gcloud
Ative a API Cloud Monitoring, se ainda não tiver feito isso:
Funções necessárias para ativar APIs
Para ativar APIs, você precisa da 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, é possível receber essa permissão com o papel de
Administrador do Service Usage (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 por 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, você pode chamar o método timeSeries.list
da sua 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 ver a lista de tipos disponíveis.
Se você estiver escrevendo um aplicativo que usa as bibliotecas de cliente recomendadas, elas autorizarão seu aplicativo usando o 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 no guia de autenticação.