Este documento explica como usar a API Cloud Monitoring para obter listas ou descrições do seguinte:
Antes de começar
- Para uma introdução às métricas e aos recursos monitorizados, consulte o artigo Métricas, séries cronológicas e recursos.
Liste descritores de métricas
Os descritores de métricas são os esquemas que definem as métricas. Para encontrar detalhes sobre as métricas que lhe interessam, procure os descritores de métricas disponíveis.Para mais informações sobre a forma como os tipos de métricas são denominados, consulte as Convenções de nomenclatura.
Tipos de métricas de listas
Para obter uma lista atual de descritores de métricas, use o método
metricDescriptors.list.
Para restringir o conjunto de tipos de métricas devolvidos, use um filtro.
Para obter ajuda na decisão sobre que tipos de métricas pesquisar, consulte o artigo
Tipos de valores e tipos de métricas.
C#
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Go
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Java
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Node.js
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
PHP
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Python
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Ruby
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Se tiver dificuldades, consulte o artigo Resolução de problemas de chamadas de API.
Obtenha descritores de métricas
Para obter informações sobre um único tipo de métrica, use o método metricDescriptors.get.
Este método devolve um descritor de métricas.
Para obter um descritor de métricas específico, tem de fornecer o nome completo da métrica à API. O nome completo é construído a partir de dois componentes:
- Um prefixo composto por
projects/PROJECT_ID/metricDescriptors. - O valor
typeque identifica o descritor de métricas, por exemplo,compute.googleapis.com/firewall/dropped_packets_count. Consulte o separador Protocolo em List metric types para saber mais sobre o valortype.
Segue-se um exemplo do nome completo de uma métrica:
projects/PROJECT_ID/metricDescriptors/compute.googleapis.com/firewall/dropped_packets_count
C#
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Go
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Java
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Node.js
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
PHP
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Python
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Ruby
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Se tiver dificuldades, consulte o artigo Resolução de problemas de chamadas de API.
Liste os recursos monitorizados
Os recursos monitorizados são entidades na nuvem que podem ser monitorizadas. Para encontrar os tipos de entidades que têm métricas, procure na lista de tipos de recursos monitorizados.
Para obter informações sobre recursos monitorizados, pode emitir pedidos de API para qualquer projeto existente ou usar a documentação da lista de recursos monitorizados.
Tipos de recursos de listas
Para obter uma lista atual de tipos de recursos monitorizados a partir da
API Monitoring,
use o método monitoredResourceDescriptors.list
e indique o ID do seu projeto.
C#
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Go
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Java
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Node.js
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
PHP
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Python
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Ruby
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Se tiver dificuldades, consulte o artigo Resolução de problemas de chamadas de API.
Obter descritores de recursos
Para obter um descritor de recurso monitorizado específico, use o método
monitoredResourceDescriptors.get.
Para obter um descritor de recurso monitorizado específico, tem de fornecer o nome completo do descritor à API. O nome completo é construído a partir de dois componentes:
- Um prefixo composto por
projects/PROJECT_ID/monitoredResourceDescriptors. - O valor
typeque identifica o descritor de recurso monitorizado, por exemplo,gce_instance. Consulte o separador Protocolo em List resource types para saber mais sobre o valortype.
Segue-se um exemplo do nome completo de um recurso monitorizado:
projects/PROJECT_ID/monitoredResourceDescriptors/gce_instance
C#
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Go
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Java
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Node.js
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
PHP
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Python
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Ruby
Para se autenticar no Monitoring, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Se tiver dificuldades, consulte o artigo Resolução de problemas de chamadas de API.
O que se segue?
- Para obter informações sobre como usar a Cloud Monitoring API para ler dados de séries cronológicas, consulte o artigo Recuperar dados de séries cronológicas.