Conferir e gerenciar o uso de métricas

Este documento descreve a página Gerenciamento de métricas do Cloud Monitoring, que ajuda você a aproveitar ao máximo as métricas faturáveis. Seu projeto do Google Cloud tem acesso a todas as métricas visíveis no escopo de métricas. Use a página Gerenciamento de métricas para fazer o seguinte:

• Conferir o uso de métricas rapidamente: veja como suas métricas estão sendo usadas em consultas, painéis personalizados ou políticas de alerta.

  • As métricas não usadas e faturáveis são métricas ativas que não foram consultadas nos últimos 30 dias e não são usadas em um painel personalizado ou política de alerta.
  • Para conferir políticas de alerta ou painéis personalizados de uma métrica no seu escopo de métricas, mas definida em um projeto diferente, use o seletor de projetos para selecionar o projeto do Google Cloud que armazena a métrica.

• Identifique métricas de alto custo e baixo valor: filtre e classifique as métricas para saber quais métricas faturáveis não utilizadas estão contribuindo mais para sua fatura. Confira quais projetos e namespaces são responsáveis por métricas custosas.

  • Conferir tendências ao longo do tempo para entender os custos relativos das métricas faturáveis.
  • Configure alertas para receber notificações se os padrões de uso mudarem.
  • Para informações sobre como as métricas faturáveis são cobradas, consulte Modelos de preços para métricas faturáveis.

• Gerenciar custos: crie regras para excluir métricas desnecessárias do processamento no Cloud Monitoring. As métricas excluídas não são faturadas. As regras de exclusão se aplicam a todas as fontes da métrica.

  • Excluir métricas individuais usando o nome delas.
  • Excluir grupos de métricas usando uma expressão regular.

• Usar métricas valiosas: crie políticas de alertas e painéis para métricas faturáveis não usadas.

• Resolver problemas de ingestão de métricas

  • Resolva erros na gravação de dados de métricas.
  • Identifique possíveis problemas com a cardinalidade das métricas faturáveis.
  • Confira os registros de auditoria associados à coleta de métricas faturáveis. Para informações gerais sobre registros de auditoria, consulte a Visão geral dos registros de auditoria do Cloud.

A página Gerenciamento de métricas não informa métricas com base em registros definidas pelo usuário. Essas métricas, que são derivadas da contagem de valores em entradas de registro, têm o prefixo logging.googleapis.com/user.

Antes de começar

Para visualizar os gráficos e registros incluídos na página Gerenciamento de métricas, criar políticas de alertas e criar regras de exclusão de métricas, você precisa ter a autorização correta.

O Gerenciamento de métricas analisa as métricas em termos de coleta e uso de dados. Para mais informações sobre essas categorias, consulte Terminologia.

Autorização

• Para ter as permissões necessárias para visualizar painéis e criar políticas de alertas usando o console do Google Cloud ou para criar, editar e excluir regras de exclusão de métricas, peça ao administrador para conceder a você o papel do IAM de Editor do Monitoring (roles/monitoring.editor) no seu projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

  Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

• Para receber as permissões necessárias para visualizar os registros de auditoria, peça ao administrador para conceder a você o papel do IAM de Leitor de registros particulares (roles/logging.privateLogViewer) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

  Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

  Para mais informações sobre papéis, consulte Controlar o acesso com o Identity and Access Management.

• Para conferir os registros de auditoria gerados pelas métricas na página Gerenciamento de métricas, é necessário ativar o registro de auditoria no seu projeto do Google Cloud. Para permitir que seu projeto gere registros de auditoria quando os dados forem lidos ou gravados, faça o seguinte:

  1. No console do Google Cloud, acesse a página Registros de auditoria:

     Acesse Registros de auditoria

     Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo IAM e administrador.

  2. Insira API Stackdriver Monitoring na barra de filtro.
  3. Selecione API Stackdriver Monitoring.
  4. Na guia Tipo de registro, selecione Gravação de dados e Leitura de dados e clique em Salvar.

  Para mais informações, veja Como configurar os registros de auditoria de acesso a dados.

Terminologia

A página Gerenciamento de métricas usa a seguinte terminologia para descrever o status das métricas e como você as está usando:

• Status das métricas
  • As métricas ativas são métricas faturáveis que seu projeto processou nas últimas 25 horas. Essas métricas geram custos.
  • As métricas inativas são métricas faturáveis que seu projeto não consumiu dados nas últimas 25 horas. Essas métricas não geram custos.

• Uso das métricas

  • As métricas usadas são aquelas que foram consultadas nos últimos 30 dias pela API Cloud Monitoring ou outras ferramentas ou que são usadas em um painel personalizado ou política de alerta.

    É possível ter políticas de gráficos e alertas que se referem a métricas sem dados (métricas inativas) e consultar essas métricas. Na página Gerenciamento de métricas, elas são consideradas usadas, mesmo que as operações de leitura não retornem dados.

  • As métricas faturáveis não usadas são métricas ativas que não foram consultadas nos últimos 30 dias e não são usadas em um painel personalizado ou política de alertas. Essas métricas geram custos de transferência, mas não oferecem benefícios de observabilidade. Se essas métricas representarem lacunas de observabilidade, você poderá criar gráficos ou políticas de alertas para elas. Se essas métricas não representarem lacunas de observabilidade, você poderá excluí-las e eliminar o custo de ingestão delas.

  • As métricas inativas são métricas inativas que não foram consultadas nos últimos 30 dias e não são usadas em um painel personalizado ou política de alerta. Essas métricas não geram custos.

O status de uso das métricas é calculado a cada 24 horas para refletir o histórico de consulta mais recente e as alterações nos painéis e nas políticas de alerta.

Conferir resumos do uso de métricas

Para conferir resumos do número de métricas faturáveis, taxas de ingestão de métricas e taxa de erro, faça o seguinte:

1. No console do Google Cloud, acesse a página  Gerenciamento de métricas:

   Acesse os Gerenciamento de métricas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Na barra de ferramentas, selecione a janela de tempo. Por padrão, a página Gerenciamento de métricas mostra informações sobre as métricas coletadas no dia anterior. A captura de tela a seguir mostra um exemplo:

   

   • Para conferir um resumo de quantas métricas faturáveis estão ativas nos projetos no seu escopo de métricas, consulte a Métricas ativas. Uma métrica é ativa se dados foram gravados nela nas últimas 25 horas.

   • Para determinar quantas das métricas faturáveis ativas estão sendo consultadas ou usadas em gráficos ou políticas de alerta, consulte a visão geral Uso da métrica. Métricas faturáveis não utilizadas representam possíveis lacunas de observabilidade que podem ser preenchidas com a criação de painéis personalizados ou políticas de alertas, ou oportunidades para reduzir custos excluindo a métrica inteiramente.

   • Para determinar o que está contribuindo para seus custos, use as visões gerais Bytes faturáveis ingeridos e Amostras faturáveis incluídas. Para mais informações, consulte Conferir tendências gerais na ingestão de métricas.

   • Para encontrar informações que possam ajudar a identificar problemas com o design ou o uso das métricas faturáveis, use a visão geral Erros de gravação de métricas. Para mais informações, consulte Investigar problemas com suas métricas.

A página Gerenciamento de métricas mostra a quantidade de dados que você está ingerindo, não os custos reais. Para conferir as informações de faturamento atuais, clique em Conferir faturamento na barra de ferramentas.

Conferir informações sobre o escopo das métricas

O conjunto de métricas exibido na página Gerenciamento de métricas depende do escopo de métricas do seu projeto. Se o projeto tiver apenas ele mesmo no escopo de métricas, as métricas na página Gerenciamento de métricas serão do projeto atual. Se o projeto tiver vários projetos no escopo de métricas, as métricas mostradas na página Gerenciamento de métricas vão incluir as métricas de todos esses projetos. Talvez a métrica que mais contribui para o custo tenha origem em um projeto diferente.

Para conferir um resumo das informações de escopo do seu projeto, clique em Escopo de métricas. Este resumo inclui o seguinte:

• Participantes do IAM com acesso ao projeto. O conjunto de participantes inclui usuários, grupos e contas de serviço.
• O número de métricas gratuitas e faturáveis que são visíveis para o escopo de métricas.
• Uma lista dos projetos monitorados pelo projeto atual. As métricas faturáveis de todos esses projetos estão disponíveis na página Gerenciamento de métricas.
• Informações sobre os projetos que podem acessar as métricas do projeto atual.

Para mais informações sobre escopos de métricas, consulte Configurar uma visualização de vários projetos.

Investigar as métricas faturáveis

A página Gerenciamento de métricas inclui uma tabela com cada métrica faturável no seu escopo. Use esta tabela para:

• Determine a contribuição de qualquer métrica para o volume faturável.
• Determine com que frequência uma métrica foi lida nos últimos 30 dias. As leituras de métricas incluem solicitações de leitura de API e solicitações geradas por gráficos.
• Identifique as métricas que são coletadas, mas não usadas em nenhuma política de alertas ou painel. Os dados de métrica que não são usados podem representar uma lacuna na observabilidade ou uma oportunidade de economia de custos com a exclusão da métrica.
• Crie uma política de alertas ou um gráfico para métricas que não têm uma política de alertas ou um painel personalizado associado.
• Identifique o projeto em que os dados de métrica foram originados. A tabela inclui métricas de todos os projetos no seu escopo de métricas, e talvez seja necessário saber em qual projeto uma métrica específica é coletada.
• Revise o rótulo e as informações de cardinalidade de cada métrica. Essas informações podem ajudar quando você investiga problemas com o design ou o uso de métricas.

Para conferir a tabela de dados de uso de cada métrica faturável, faça o seguinte:

1. No console do Google Cloud, acesse a página  Gerenciamento de métricas:

   Acesse os Gerenciamento de métricas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Na barra de ferramentas, selecione a janela de tempo. Por padrão, a página Gerenciamento de métricas mostra informações sobre as métricas coletadas no dia anterior. A captura de tela a seguir mostra um exemplo da tabela de métricas:

   

Selecione as métricas que você quer visualizar

Para gerenciar seus custos, você precisa entender quais métricas faturáveis estão gerando mais tráfego. Não basta saber, por exemplo, que 60 MiB de dados estão sendo ingeridos a cada hora. No entanto, quando você sabe que a maioria dos seus dados faturáveis é devido a uma ou duas métricas, é possível investigar o uso dessas métricas.

Para listar as métricas faturáveis, faça o seguinte:

1. No console do Google Cloud, acesse a página  Gerenciamento de métricas:

   Acesse os Gerenciamento de métricas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Na barra de ferramentas, selecione a janela de tempo. Por padrão, essa guia mostra informações sobre as métricas coletadas no dia anterior.
3. Para limitar a exibição a grupos específicos de métricas, use os filtros rápidos ou filtre a tabela diretamente. Analisar categorias de métricas pode revelar padrões difíceis de detectar quando todas as métricas na tabela são analisadas.

A tabela de métricas lista as métricas faturáveis que estão no escopo de métricas do projeto atual do Google Cloud. Para cada métrica, a tabela mostra a contribuição dela para o volume faturável e fornece links para as políticas de alerta e os painéis personalizados associados à métrica, conforme mostrado na captura de tela a seguir. Se não houver uma política de alertas ou um painel associado a uma métrica, a tabela vai incluir um botão para criar uma.

Para classificar as métricas pela contribuição no volume faturável, clique no cabeçalho da coluna Bytes faturáveis/Total e Volume faturável de amostras/Total.

A tabela de métricas também mostra o domínio da métrica, o conjunto de identificadores, o projeto de onde a métrica foi ingerida e a cardinalidade dela. A captura de tela a seguir mostra um exemplo dessas colunas.

As informações de rótulo e cardinalidade podem ser úteis para identificar a causa do aumento no volume faturável. No Cloud Monitoring, a cardinalidade se refere ao número de séries temporais associadas a uma métrica e a um recurso e está relacionada aos rótulos e aos valores deles. Há uma série temporal para cada combinação de valores de rótulo. Para mais informações, consulte Cardinalidade.

As mudanças no volume faturável significam que você está ingerindo mais dados. Se as mudanças forem repentinas ou inesperadas, a causa pode ser uma alteração no número de rótulos associados a uma métrica ou na forma como os valores dos rótulos são definidos. Qualquer uma delas pode aumentar a cardinalidade de uma métrica, resultando em um volume faturável maior. Para saber como usar o Gerenciamento de métricas para identificar problemas com métricas, consulte Investigar problemas com suas métricas.

Usar filtros rápidos

Para ver apenas as métricas dos grupos a seguir, selecione uma entrada no painel Filtros rápidos:

• O status da métrica inclui métricas ativas e inativas. As métricas ativas têm dados de série temporal ingeridos nas últimas 25 horas. Para mais informações sobre esses status, consulte a terminologia.

• Uso da métrica. Esta categoria classifica as métricas da seguinte forma:

  • Métricas usadas, não usadas e inativas.

    • As métricas usadas foram acessadas por uma leitura de métrica ou são usadas em um painel personalizado ou política de alertas.
    • As métricas faturáveis não utilizadas não foram acessadas por uma leitura de métrica ou são usadas em um painel personalizado ou política de alerta.
    • As métricas inativas são "inativas" e "não usadas".

    Para mais informações sobre essas categorias de uso, consulte Terminologia.

  • Métricas usadas ou não em uma política de alerta no projeto atual do Google Cloud.

  • Métricas usadas ou não em um painel personalizado no projeto atual do Google Cloud.Esses filtros não incluem métricas usadas em painéis predefinidos fornecidos pelo Cloud Monitoring.

  O status de uso das métricas é calculado a cada 24 horas para refletir o histórico de consulta mais recente e as alterações nos painéis e nas políticas de alerta.

• Conjuntos de métricas por domínio, conforme descrito em resumo das métricas faturáveis.

Se você tiver métricas que não são usadas em uma política de alertas ou em um painel personalizado e que nunca são consultadas, talvez esteja pagando por métricas sem receber nenhum benefício de observabilidade delas. É possível listar métricas que aparecem em nenhuma política de alerta ou em nenhum painel personalizado definido no projeto atual do Google Cloud selecionando o filtro rápido Nenhuma política de alerta ou Nenhum painel personalizado.

Observação: a página Gerenciamento de métricas lista apenas políticas de alerta e painéis personalizados definidos no projeto atual. As métricas listadas sem políticas de alerta ou painéis personalizados podem ter políticas de alerta ou painéis personalizados em outro projeto no escopo de métricas. A tabela de métricas inclui o ID do projeto de cada métrica para que você possa identificar esses projetos. Para conferir políticas de alerta ou painéis personalizados definidos em um projeto diferente, use o seletor de projetos para selecionar o projeto do Google Cloud que armazena a métrica.

Filtrar a tabela diretamente

Use a barra  Filtro para pesquisar o conjunto de métricas quando não houver um filtro rápido adequado. Por exemplo, se você tiver um escopo de métricas de vários projetos e quiser listar apenas as métricas desse projeto, não será possível usar um filtro rápido. Para listar apenas as métricas de um projeto específico, selecione Project na lista de filtros e insira o identificador de um projeto.

Também é possível usar filtros explícitos para pesquisar métricas que correspondem a combinações de filtros. Só é possível selecionar um filtro rápido por vez. Portanto, não é possível listar apenas métricas ativas que não aparecem em uma política de alerta ou em um painel personalizado usando filtros rápidos. Para pesquisar métricas que correspondem a uma combinação de requisitos, adicione filtros à barra de filtro. Por exemplo, para listar métricas ativas que aparecem em nenhuma política de alerta e em nenhum painel personalizado, adicione os seguintes filtros à barra de filtros:

• Status: Active
• Alert Policies: (Empty)
• Custom Dashboards: (Empty)

Por padrão, quando você adiciona vários filtros, a tabela inclui uma linha quando ela atende a todos os filtros. No entanto, é possível inserir um filtro OR entre dois outros elementos de filtro.

Conferir informações sobre leituras de métricas

A linha de cada métrica na tabela inclui uma entrada para o número de leituras de métricas nos últimos 30 dias. É possível usar essa entrada para identificar como as consultas foram feitas. As origens de consulta são categorizadas como "console" ou "outro". As leituras do Metrics Explorer ou dos gráficos em painéis personalizados são "console", e as leituras da API de outras fontes são "outras".

• Para conferir um resumo compacto das origens das leituras de métricas, clique na  seta para baixo ao lado da entrada.
• Para conferir um gráfico mostrando as origens das leituras de métricas ao longo do tempo, clique no número de leituras de métricas. Esse valor também é um link para o gráfico.

Criar uma política de alertas para uma métrica não monitorada

Quando uma métrica na tabela não tem uma política de alertas associada, a tabela oferece um botão Criar alerta. Para criar uma política de alertas para uma métrica, clique em Criar alerta na linha da métrica.

A caixa de diálogo da política de alertas é aberta com os campos de condição preenchidos. Recomendamos que você analise todas as configurações e faça as seguintes modificações:

• Atualize o valor do limite da condição. O valor padrão pode não ser satisfatório.
• Adicione os canais de notificação à política.
• Nomeie a política.

Também é possível criar políticas de alertas para qualquer métrica clicando em  Ações e em Criar alerta para a métrica.

Para mais informações, consulte Criar uma política de alertas.

Para conferir as políticas de alerta de uma métrica no seu escopo, mas definida em um projeto diferente, use o seletor de projetos para selecionar o projeto do Google Cloud que armazena a métrica.

Criar um gráfico para uma métrica não monitorada

Quando uma métrica na tabela não tem um painel personalizado associado, a tabela oferece um botão Criar gráfico. Use esse botão para criar um gráfico e colocá-lo em um painel personalizado. Para criar um gráfico para uma métrica, faça o seguinte:

1. Clique em Criar gráfico na linha da métrica.

   O painel Explorer é aberto e pré-configurado para mostrar a métrica selecionada. É possível modificar a configuração do gráfico. Para mais informações sobre como usar o Metrics Explorer, consulte Criar gráficos com o Metrics Explorer.

2. Para salvar o gráfico em um painel personalizado, clique em Salvar no painel.

3. No painel Salvar gráfico, faça o seguinte:

   1. Aceite ou modifique o título padrão do gráfico.
   2. Selecione o painel personalizado em que você quer salvar o gráfico ou clique em Novo painel para criar um.
   3. Clique em Salvar gráfico.

Para conferir painéis personalizados de uma métrica no escopo de métricas, mas definida em um projeto diferente, use o seletor de projetos para selecionar o projeto do Google Cloud que armazena a métrica.

Trabalhar com métricas

Você pode usar a página Gerenciamento de métricas para conferir algumas informações sobre uma métrica, mas talvez queira mais detalhes. Por exemplo, você pode conferir um gráfico de uma métrica específica ou criar uma política de alertas para receber uma notificação quando a taxa de transferência dessa métrica for inesperada.

Para mais detalhes sobre uma métrica específica, faça o seguinte:

1. No console do Google Cloud, acesse a página  Gerenciamento de métricas:

   Acesse os Gerenciamento de métricas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Encontre a métrica na tabela e clique em  Ações para fazer uma das seguintes ações:

   • Para conferir um gráfico que mostra a métrica atual, selecione Ver no Metrics Explorer.

     O Metrics Explorer é aberto e pré-configurado para mostrar a métrica selecionada. Você pode modificar a configuração do gráfico, descartá-la ou adicioná-la a um painel personalizado.

   • Para criar uma política de alertas que monitore a métrica, selecione Criar alerta para a métrica.

     A caixa de diálogo da política de alertas é aberta com os campos de condição preenchidos. Recomendamos que você analise todas as configurações e faça as seguintes modificações:

     • Atualize o valor do limite da condição. O valor padrão pode não ser satisfatório.
     • Adicione os canais de notificação à política.
     • Nomeie a política.

     Para mais informações, consulte Criar uma política de alertas.

   • Excluir a métrica. Para mais informações sobre essa opção, consulte Excluir métricas desnecessárias.

   • Para conferir os registros de auditoria associados à métrica, selecione Acessar registros de auditoria da métrica.

Excluir métricas desnecessárias

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

É possível criar uma regra de exclusão de métricas para evitar que as métricas selecionadas sejam processadas no Cloud Monitoring. Se, por exemplo, você tiver um conjunto de métricas faturáveis não utilizadas que não são necessárias, poderá excluir essas métricas para eliminar o custo de ingestão delas. Depois, você pode editar ou excluir as regras de exclusão se as necessidades mudarem.

Para criar uma regra de exclusão de métrica, faça o seguinte:

1. No console do Google Cloud, acesse a página  Gerenciamento de métricas:

   Acesse os Gerenciamento de métricas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Clique em  Excluir métrica. Também é possível criar exclusões na guia Métricas excluídas ou em  Ações na linha de cada métrica.
3. Selecione as métricas a serem excluídas.
   1. Para excluir uma única métrica, selecione-a na tabela Nome da métrica.
   2. Para excluir um grupo de métricas, faça o seguinte:
      1. Clique em Expressão regular.
      2. Insira uma expressão regular. Por exemplo, para excluir todas as métricas agent.googleapis.com/apache, insira agent.googleapis.com/apache.* ou agent.*/apache.*.
      3. Clique em Mostrar correspondências para verificar se a expressão corresponde às métricas pretendidas.
   3. Clique em Criar regra.

A regra leva cerca de cinco minutos para entrar em vigor.

A tabela a seguir inclui expressões regulares que podem ser úteis para excluir métricas de statsd ou métricas com nomes dinâmicos semelhantes:

Bloquear métricas com nomes que contenham	Regex
mais de um sublinhado em uma linha	.*_{2,}.*
mais de sete dígitos em sequência (provavelmente carimbo de data/hora)	.*\d{7,}.*
segmentos muito longos (provavelmente erros de análise de rótulos)	.*[a-zA-Z0-9]{20,}.*
substrings hexadecimais, incluindo GUIDs	.*[A-F0-9]{10,}.*
Subcadeias de endereços IP	.*\d{1,3}_\d{1,3}_\d{1,3}_\d{1,3}.*
qualquer dígito (pode ser útil para métricas do Prometheus)	.*\d+.*
Métricas do Prometheus com um tipo desconhecido	prometheus.googleapis.com/.+/unknown.*

Editar uma regra de exclusão de métrica

Para editar uma regra de exclusão de métrica, faça o seguinte:

1. No console do Google Cloud, acesse a página  Gerenciamento de métricas:

   Acesse os Gerenciamento de métricas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Clique na guia Métricas excluídas.
3. Na linha da regra que você quer excluir, clique em  Ações e selecione Editar regra.
4. Limpar a métrica ou a expressão regular selecionada
5. Selecione uma nova métrica ou crie uma nova expressão regular.
6. Clique em Atualizar regra.

Ao editar uma regra, a antiga é excluída e uma nova é criada.

Observação: se uma regra de exclusão usa uma expressão regular que faz com que uma série temporal seja excluída sem um descritor de métrica, a tabela Exclusões de métricas informa "undefined_metric" como o tipo de métrica.

Excluir uma regra de exclusão de métrica

Para excluir uma regra de exclusão de métrica, faça o seguinte:

1. No console do Google Cloud, acesse a página  Gerenciamento de métricas:

   Acesse os Gerenciamento de métricas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Clique na guia Métricas excluídas.
3. Na linha da regra que você quer excluir, clique em  Ações e selecione Excluir regra.

Conferir o volume de métricas excluídas

Para conferir o volume de bytes ou amostras excluídos como um gráfico no Metrics Explorer, faça o seguinte:

1. No console do Google Cloud, acesse a página  Gerenciamento de métricas:

   Acesse os Gerenciamento de métricas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Clique na guia Métricas excluídas.
3. Clique em histórico Linha do tempo de exclusão.

O gráfico é pré-configurado para mostrar os dados de exclusão de métricas. Também é possível salvar o gráfico em um painel personalizado clicando em Salvar no painel.

Conferir e receber alertas sobre tendências nas métricas faturáveis

O número de bytes e amostras faturáveis ingeridos determina a maioria dos custos. Para prever seus custos mensais devido ao uso de métricas faturáveis, você precisa saber a taxa de ingestão de dados. A página Gerenciamento de métricas mostra resumos do uso de métricas, que podem ajudar você a fazer o seguinte:

• Confira as tendências no uso de métricas faturáveis.
• Determine se um projeto no seu escopo de métricas está enviando mais ou menos dados de métricas do que o esperado.
• Identifique as métricas que estão gerando mais dados.
• Identifique os namespaces responsáveis por gerar a maioria dos dados do Prometheus.
• Confira a taxa de erros de gravação nas suas métricas. A taxa de erro é a porcentagem de gravações de métrica que retornam um status de erro em relação ao número total de gravações de métrica.

O painel de resumo do uso de métricas fornece links para informações mais detalhadas sobre tendências ao longo do tempo e links para políticas de alerta predefinidas e personalizáveis para tendências de uso.

O painel de resumo foi revisto.

Conferir tendências gerais na ingestão de métricas

Para determinar se os aplicativos estão gerando uma quantidade consistente de dados, que é o comportamento esperado para aplicativos estáveis, consulte as taxas de coleta usando os indicadores de ingestão. Ao mudar o período em que você visualiza as métricas, é possível encontrar quedas, picos ou tendências.

Para conferir as taxas de cobrança ao longo do tempo, faça o seguinte:

1. No console do Google Cloud, acesse a página  Gerenciamento de métricas:

   Acesse os Gerenciamento de métricas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Na barra de ferramentas, selecione a janela de tempo.

3. Clique em Ver gráficos na visão geral de bytes ou amostras ingeridas. Esta discussão se refere a gráficos para amostras faturáveis, mas os gráficos para bytes faturáveis funcionam da mesma maneira. Você vai encontrar um conjunto de gráficos como este:

   

   Por padrão, as legendas dos gráficos são recolhidas. Para conferir a lista de séries temporais exibidas em um gráfico, clique em  Legenda. Para saber como definir referências de tempo ou expandir o gráfico em uma janela de tempo específica, consulte Como analisar dados em gráficos.

   Observação: quando um projeto do Google Cloud não está processando nenhuma métrica faturável, esses gráficos não mostram dados. Em vez disso, os gráficos mostram a mensagem "Não há dados disponíveis para o período selecionado". Esta mensagem não é um erro.

Por exemplo, se você definir a janela de tempo como uma semana e notar um aumento constante, mas inesperado, nos dados ingeridos ao longo do tempo, verifique se o aumento é proveniente de uma métrica específica ou se é uma tendência geral em um grupo de métricas. Se uma métrica for responsável, você poderá investigar se a cardinalidade dela também está aumentando.

• Para conferir a taxa de amostras faturáveis ingeridas no escopo atual das métricas, use o gráfico Total de amostras faturáveis ingeridas.

• Para conferir as contribuições de cada projeto no escopo de métricas para o valor total faturável, use o gráfico Projects by billable samples ingested. Esse gráfico mostra quais projetos estão enviando mais dados e se algum projeto está enviando uma quantidade crescente ou decrescente de dados.

• (Apenas amostras faturáveis) Para encontrar os namespaces que estão enviando métricas com as maiores contribuições para os valores faturáveis, use o gráfico Ingestão de volume de namespace.

• Para conferir as métricas no escopo com as maiores contribuições para os valores faturáveis, use o gráfico 10 principais métricas por amostras faturáveis ingeridas. Você pode procurar picos, quedas ou tendências nas taxas de coleta ou uma métrica com uma linha muito diferente de todas as outras.

• Para conferir as contribuições para o valor faturável de todas as métricas no seu escopo, use o gráfico Todas as métricas por amostras faturáveis ingeridas. Esse gráfico inclui as métricas do gráfico Top 10 e pode mostrar a distribuição geral das taxas de cobrança das suas métricas.

Para analisar qualquer um desses gráficos com mais detalhes, clique em  Mais opções e selecione Ver no Metrics Explorer. Para exemplos que começam com o gráfico Ingestão de volume do namespace e usam o Metrics Explorer para realizar a atribuição de volume de ingestão, consulte:

• Identificar métricas de alto volume
• Identificar namespaces de alto volume

Para mais informações sobre como usar o Metrics Explorer para analisar dados, incluindo ações como comparar o comportamento do mês atual com o do mês anterior, consulte Analisar dados em gráficos.

Criar alertas com base na ingestão de métricas

Para receber notificações sobre um pico, uma queda ou uma tendência nas taxas de coleta de métricas faturáveis, crie uma política de alertas. Por exemplo, uma queda na coleção de métricas pode indicar que o aplicativo está com um desempenho ruim. Da mesma forma, um pico pode resultar em cobranças inesperadas. Por fim, uma tendência de alta pode indicar que uma métrica tem muitos rótulos ou está aumentando a cardinalidade. Em todas as situações, uma política de alertas pode notificar você sobre o comportamento incomum, e você pode resolver a situação.

Se você tiver métricas cobradas por bytes ingeridos e métricas cobradas por amostras ingeridas, vai precisar criar uma política de alertas para os dois valores de faturamento.

Para criar uma política de alertas que monitore uma taxa de coleta de métricas, faça o seguinte:

1. No console do Google Cloud, acesse a página  Gerenciamento de métricas:

   Acesse os Gerenciamento de métricas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Na barra de ferramentas, selecione a janela de tempo.
3. Clique em Ver gráficos na visão geral de bytes ou amostras ingeridas.

4. No gráfico com os dados que você quer monitorar, clique em Criar política de alertas.

   A caixa de diálogo da política de alertas é aberta com os campos de condição preenchidos. Recomendamos que você analise todas as configurações e faça as seguintes modificações:

   • Atualize o valor do limite da condição. O valor padrão pode não ser satisfatório.
   • Adicione os canais de notificação à política.
   • Nomeie a política.

   Para mais informações, consulte Criar uma política de alertas.

Investigar problemas com suas métricas

Use a página Gerenciamento de métricas para investigar problemas com a estrutura ou o uso das métricas faturáveis. Por exemplo, você pode estar enfrentando o seguinte:

• Um aumento no volume faturável que pode ser atribuído a uma métrica específica.
• Relatórios de aumento da latência das consultas para uma métrica específica.
• Erros na gravação de dados de métricas, que podem resultar do alcance de limites na quantidade ou taxa de dados gravados.

A ocorrência de erros na gravação de dados de métricas pode estar relacionada a outros problemas, como um aumento inesperado no volume faturável ou aumento da latência da consulta. Por exemplo, uma mudança na configuração de uma métrica pode resultar em um problema de cardinalidade, que pode afetar o volume de dados ingeridos e a latência da consulta, além de resultar em erros de gravação de métricas.

Conferir erros de gravação de métrica

Na visão geral Erros de gravação de métricas, você pode fazer o seguinte:

• Confira o status das solicitações de gravação de métricas.
• Crie uma política de alertas para receber uma notificação se a taxa de erros de gravação de métricas ultrapassar um valor de limite.
• Confira os registros de auditoria para erros de gravação de métricas, se você tiver ativado os registros de auditoria. Esses registros podem fornecer insights sobre as causas dos erros de gravação de métrica.

Para conferir informações sobre erros na gravação de dados de métricas, faça o seguinte:

1. No console do Google Cloud, acesse a página  Gerenciamento de métricas:

   Acesse os Gerenciamento de métricas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Na barra de ferramentas, selecione a janela de tempo.

3. Clique em Conferir erros na visão geral Erros de gravação de métrica.

   • Para conferir o status das solicitações de gravação de métricas na API Cloud Monitoring, use o gráfico API - Criar série temporal (códigos de status). Este gráfico mostra chamadas para o método timeSeries.create.

     Cada série temporal mostra a taxa de gravações para um código de status HTTP específico. Quando o gráfico mostra uma única linha para resultados de status 2xx, não há erros de gravação de métricas. A captura de tela a seguir mostra resultados de status 2xx e um pequeno número de resultados de status 4xx e 5xx:

     

     Se você notar um aumento no número de solicitações de gravação de métricas, talvez haja um problema de cardinalidade.

   • Se o gráfico mostrar códigos de status de erros e se você tiver ativado registros de auditoria para o projeto, use os registros para investigar as causas dos erros. A consulta predefinida para os registros procura erros associados ao método timeSeries.create da API Monitoring. Esse método é chamado sempre que uma métrica é gravada.

     Os registros de erros timeSeries.create podem informar mais sobre o motivo dos códigos de status de erro. O método pode falhar se, por exemplo, você tentar gravar muitos dados de uma vez ou se exceder um limite no número de séries temporais ativas. Para mais informações, consulte a seção Métricas definidas pelo usuário no documento Cotas de monitoramento.

     Observação:o aviso que começa com "Se você não encontrar nenhum registro abaixo" e o botão Ativar registros de auditoria estão sempre presentes, mesmo quando os registros de auditoria aparecem no painel de registros. O aviso é um lembrete de que, se você não encontrar registros, talvez seja necessário ativar o registro de auditoria. Se você não encontrar registros, é possível que não haja registros para mostrar.

Investigar erros de criação de métricas

Outro método relacionado a métricas que podem falhar é o metricDescriptors.create. O método metricDescriptors.create é chamado na primeira vez que você grava dados de série temporal para uma nova métrica ou se você mudar a estrutura dos dados da métrica, provavelmente adicionando novos identificadores. Os registros de auditoria de erros desse método estão disponíveis na entrada de cada métrica na tabela de métricas.

Para conferir os registros de auditoria de uma métrica específica, faça o seguinte:

1. No console do Google Cloud, acesse a página  Gerenciamento de métricas:

   Acesse os Gerenciamento de métricas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Na barra de ferramentas, selecione a janela de tempo.
3. Encontre a métrica na tabela e clique em  Ações.

4. Selecione Acessar registros de auditoria da métrica.

   A consulta predefinida para os registros procura erros associados ao método metricDescriptors.create da API Monitoring.

Erros do método metricDescriptors.create podem ajudar a identificar possíveis problemas no design das suas métricas. Erros desse método podem aparecer se você exceder o número permitido de descritores de métrica ou o número de rótulos em um descritor de métrica. Para mais informações, consulte a seção Métricas definidas pelo usuário no documento sobre cotas do Monitoring.

Modelos de preços para métricas faturáveis

Em geral, as métricas do sistema do Cloud Monitoring são gratuitas, e as métricas de sistemas ou aplicativos externos não são. As métricas faturáveis são faturadas pelo número de bytes ou de amostras ingeridas. Esta seção descreve a transferência baseada em bytes e amostras.

Para informações detalhadas sobre os recursos sujeitos a cobrança no Cloud Monitoring, consulte Cloud Monitoring no documento de preços. Para informações sobre preços, consulte Resumo de preços do Cloud Monitoring.

Faturamento por bytes ou amostras ingeridas

As métricas faturáveis são faturadas pelo número de bytes ou pelo número de amostras ingeridas. Toda vez que uma métrica é gravada, a operação de gravação inclui um valor de dados. O valor dos dados pode ser um escalar, como um número inteiro ou um número de ponto flutuante, ou pode ser uma distribuição, um tipo de dados complexo que inclui vários valores diferentes. Para mais informações sobre os tipos de valores que uma métrica pode gravar, consulte Tipo de valor.

Tanto a frequência com que a métrica é gravada (a taxa de amostragem) quanto o tipo de dados que ela grava (escalares ou distribuições) afetam a quantidade de dados ingeridos, independentemente de a ingestão ser cobrada por bytes ingeridos ou amostras ingeridos.

• "Bytes ingeridos" significa que as cobranças são baseadas no volume de dados ingeridos, medido em bytes. Para fins de precificação, cada valor escalar é contado como 8 bytes, e cada distribuição é contada como 80 bytes. Para mais informações e exemplos, consulte Métricas cobradas por bytes ingeridos.

• "Amostras ingeridas" significa que as cobranças são baseadas no número de medições ingeridas. Para fins de preços, cada valor escalar é contado como uma amostra, e cada distribuição é contada como duas amostras mais uma para cada bucket de histograma com uma contagem diferente de zero. Para mais informações e exemplos, consulte Métricas cobradas por amostras ingeridas.

A maior diferença entre os dois modelos de precificação é para os valores de distribuição. A ingestão baseada em bytes cobra uma taxa fixa para distribuições, mas a ingestão baseada em amostras leva em conta os dados na distribuição. As distribuições com histogramas esparsos (poucos buckets de histograma com valores diferentes de zero) são contadas como menos amostras do que distribuições com histogramas densos, em que a maioria dos buckets tem valores diferentes de zero.

Métricas faturáveis na página Gerenciamento de métricas

A página Gerenciamento de métricas mostra as métricas faturáveis por domínio. O domínio fornece informações sobre como a métrica foi coletada e de onde.

A tabela a seguir descreve as categorias de métricas faturáveis disponíveis na página Gerenciamento de métricas e se elas são medidas por bytes ou amostras ingeridas:

Domínio	Prefixo da métrica	Modelo de preços	Significado
Agente	agent.googleapis.com	Bytes	Métricas coletadas de recursos externos por agentes. Para listas dessas métricas, consulte Métricas do agente de operações e Métricas legadas de monitoramento e geração de registros. As métricas de integrações de terceiros coletadas pelo agente de monitoramento legado também são informadas como métricas do "agente". Consulte Métricas de aplicativos de terceiros. As métricas agent.googleapis.com/processes/ são cobradas a 5% da taxa de volume de outras métricas sujeitas a cobrança. Por exemplo, processar 100 MiB de métricas de processo custa o mesmo que processar 5 MiB de outras métricas sujeitas a cobrança. Os agentes também coletam métricas sobre eles mesmos. Essas métricas, identificadas pelo prefixo agent.googleapis.com/agent, não são faturáveis e não aparecem na página Gerenciamento de métricas.
Personalizado e definido pelo usuário	custom.googleapis.com	Bytes	Métricas definidas por você.
Externo	external.googleapis.com	Bytes	Métricas de algumas bibliotecas de código aberto ou provedores de terceiros. Para mais informações, consulte Métricas externas.
Carga de trabalho	workload.googleapis.com	Bytes	Métricas de integrações de terceiros gravadas pelo Agente de operações. Para uma lista dessas métricas, consulte Métricas de aplicativos de terceiros.
Prometheus	prometheus.googleapis.com	Amostras	Métricas coletadas usando o Google Cloud Managed Service para Prometheus ou o Agente de operações e o Receptor do Prometheus ou o Receptor do OTLP.

Outras métricas faturáveis

A página Gerenciamento de métricas não informa métricas com base em registros definidas pelo usuário. Essas métricas, que são derivadas da contagem de valores em entradas de registro, têm o prefixo logging.googleapis.com/user. As métricas com base em registros definidas pelo usuário são cobradas por bytes ingeridos.

A seguir

• Use o Agente de operações para coletar métricas:
  • Configurar o Agente de operações
  • Monitorar aplicativos de terceiros
  • Coletar métricas do Prometheus
  • Coletar telemetria OTLP
• Use o Google Cloud Managed Service para Prometheus para coletar métricas:
  • Usar a coleta gerenciada
  • Usar a coleta autoimplantada
  • Usar o coletor do OpenTelemetry
  • Usar métricas personalizadas no Cloud Run
• Coletar métricas locais e de nuvem híbrida usando o BindPlane
• Criar métricas definidas pelo usuário usando a API Monitoring
• Preços