Usar métricas personalizadas

Este guia descreve como criar e usar métricas personalizadas. As informações estão divididas nas seguintes seções:

  • Métricas personalizadas com o OpenCensus descrevem como usar o OpenCensus, uma biblioteca de monitoramento e rastreamento de código aberto para criar métricas personalizadas, adicionar dados de métricas a elas e exportá-los para o Cloud Monitoring.

    Quando as métricas do OpenCensus são exportadas para o Cloud Monitoring, o Monitoring as trata como qualquer outra métrica personalizada.

  • Como criar métricas personalizadas descreve como usar a API Cloud Monitoring para criar métricas personalizadas e adicionar dados de série temporal a elas.

    A API Monitoring é ilustrada com exemplos usando as linguagens de programação API Explorer, C#, Go, Java, Node.js, PHP, Python e Ruby.

As informações a seguir se aplicam a métricas personalizadas e às métricas fornecidas pelo Cloud Monitoring:

  • Em Como procurar métricas, você verá como listar e examinar suas métricas personalizadas e as mais de 900 métricas integradas.
  • Em Como ler métricas, você verá como recuperar dados de série temporal de métricas personalizadas e integradas usando a API Monitoring. Também é possível usar dados de métricas em gráficos e alertas.

Todas essas operações de métricas exigem a API Cloud Monitoring v3. Consulte Introdução à API Cloud Monitoring para obter a documentação de referência.

Para uma discussão dos conceitos subjacentes às métricas no Cloud Monitoring, consulte Métricas, série temporal e recursos.

Antes de começar

As métricas personalizadas estão em projetos do Google Cloud que fazem parte de um espaço de trabalho. Mesmo que esteja apenas procurando métricas integradas, precisará trabalhar a partir de um projeto:

  1. Crie ou selecione um projeto do Console do Google Cloud com os dados de monitoramento que você quer acessar. Neste guia, o ID do seu projeto é chamado {your-project-id}.
  2. Ative o projeto para o Monitoring.

Se quiser configurar métricas com base nos registros dos projetos do Google Cloud, use métricas com base em registros.

Sobre métricas personalizadas

As métricas personalizadas são iguais às métricas integradas do Monitoring, mas apresentam algumas exceções:

  • É possível criar métricas personalizadas nos projetos do Google Cloud.
  • No geral, o nome das métricas personalizadas começa com custom.googleapis.com/, o que as diferencia das integradas.
  • É possível gravar dados da série temporal nas métricas personalizadas.
  • É possível excluir as métricas personalizadas.

Consulte a lista de métricas para ver detalhes sobre as métricas integradas.

A seguinte tabela mostra quais métodos na API Monitoring podem ser usados com métricas personalizadas e integradas:

Método da API Monitoring Usar com
métricas personalizadas
Usar com
métricas integradas
monitoredResourceDescriptors.get sim sim
monitoredResourceDescriptors.list sim sim
metricDescriptors.get sim sim
metricDescriptors.list sim sim
timeSeries.list sim sim
timeSeries.create sim
metricDescriptors.create sim
metricDescriptors.delete sim

Limites e latências

Consulte Cotas e limites para limites relacionados a métricas personalizadas e retenção de dados. Se quiser estender o período de armazenamento dos dados de métrica, basta copiá-los manualmente para outro local como o Cloud Storage ou o BigQuery.

Para informações sobre latências associadas à gravação de dados em métricas personalizadas, consulte Latência dos dados de métricas.