Ver e gerenciar o uso de métricas

Neste documento, descrevemos a página Gerenciamento de métricas do Cloud Monitoring, que fornece informações para ajudar você a controlar o valor gasto em métricas faturáveis, sem afetar a observabilidade. Você pode usar a página Gerenciamento de métricas para fazer o seguinte:

  • Determine quais métricas faturáveis você está coletando ativamente em seu projeto.
  • Determine quais projetos estão enviando mais dados.
  • Entenda os custos associados às métricas faturáveis usadas no seu projeto do Google Cloud.
  • Configure alertas para receber notificações caso seus padrões de uso mudem. É possível configurar alertas para a ingestão geral de dados de métricas e sobre o comportamento de qualquer métrica.
  • Veja como suas métricas faturáveis estão sendo usadas em painéis personalizados e políticas de alertas. Quando você não usa uma métrica em nenhum painel ou política de alertas, ela não oferece benefícios de observabilidade.
  • Crie gráficos e políticas de alertas para métricas que não tenham políticas ou painéis de alertas associados.
  • Identificar possíveis problemas com a cardinalidade das métricas faturáveis.
  • Resolver erros na gravação de dados de métricas.
  • Acessar os registros de auditoria associados à coleção de métricas faturáveis. Para informações gerais sobre registros de auditoria, consulte Visão geral dos registros de auditoria do Cloud.

A página Gerenciamento de métricas exibe informações sobre as métricas faturáveis que podem ser acessadas pelo seu projeto do Google Cloud. Seu projeto do Google Cloud tem acesso a todas as métricas visíveis para o escopo de métricas dele.

A página Gerenciamento de métricas também fornece links para políticas de alertas e painéis personalizados definidos no projeto atual do Google Cloud. Para visualizar políticas de alertas ou painéis personalizados de uma métrica no escopo, mas definida em outro projeto, use o seletor de projetos para escolher o projeto do Google Cloud que armazena a métrica.

Você também pode ver registros de auditoria relacionados a erros das suas métricas na página Gerenciamento de métricas. Esses registros podem ajudar a determinar a causa dos erros.

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. As métricas faturáveis são cobradas pelo número de bytes ou de amostras ingeridas. Nesta seção, descrevemos a ingestão baseada em bytes e amostras.

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

Faturamento por bytes ou amostras ingeridas

As métricas faturáveis são cobradas pelo número de bytes ou pelo número de amostras ingeridas. Sempre 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 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.

A frequência com que a métrica é gravada (a taxa de amostragem) e 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 ingeridas.

  • "Bytes ingeridos" significa que as cobranças são baseadas no volume de dados ingeridos, medido em bytes. Para determinar os preços, 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 que tem 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 preços é 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 amostra considera os dados na distribuição. As distribuições com histogramas esparsos (alguns buckets de histograma com valores diferentes de zero) contam como menos amostras do que as 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 informa as métricas faturáveis por domínio. O domínio fornece informações sobre como e de onde a métrica foi coletada.

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 acessar as listas dessas métricas, consulte Métricas do agente de operações e Métricas legadas do Monitoring e do Logging. As métricas de integrações de terceiros coletadas pelo agente do Monitoring 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, a ingestão de 100 MiB de métricas de processo custa o mesmo que a ingestão de 5 MiB de outras métricas sujeitas a cobrança.

Os agentes também coletam métricas sobre si 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.

Definido pelo usuário e personalizado custom.googleapis.com Bytes Métricas que você define.
Serviço external.googleapis.com Bytes Métricas de algumas bibliotecas de código aberto ou provedores terceirizados. 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, 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 as seguintes categorias de métricas faturáveis:

  • Métricas com base em registros definidas pelo usuário. Essas métricas, que são derivadas da contagem de valores nas 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.
  • Métricas do AWS CloudWatch coletadas usando projetos do conector da AWS. Essas métricas têm o prefixo aws.googleapis.com e são cobradas por bytes ingeridos.

Antes de começar

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

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, peça ao administrador para conceder a você o papel do IAM Editor do Monitoring (roles/monitoring.editor) no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

    Também é possível receber as permissões necessárias com papéis personalizados ou 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 Visualizador de registros particulares (roles/logging.privateLogViewer) no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

    Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

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

  • É possível visualizar os registros de auditoria gerados por essas métricas na página Gerenciamento de métricas quando a geração de registros de auditoria está ativada. Para configurar seu projeto para gerar registros de auditoria quando os dados são lidos ou gravados, faça o seguinte:

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

      Acessar 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. Digite 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.

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 projeto. Se o projeto tiver apenas a si 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 incluirão as métricas de todos esses projetos. Pode ser que essa métrica que mais contribui para seu custo seja originada 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:

  • Principais do IAM com acesso ao projeto. O conjunto de principais inclui usuários, grupos e contas de serviço.
  • O número de métricas gratuitas e faturáveis 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 projetos que podem visualizar 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 suas métricas faturáveis

A página Gerenciamento de métricas oferece uma tabela que inclui cada métrica faturável no escopo delas. Você pode usar essa tabela para fazer o seguinte:

  • Filtre suas métricas faturáveis por categorias que compartilham alguns recursos. A análise das categorias de métricas pode revelar padrões difíceis de detectar ao analisar todas as métricas na tabela.
  • Determinar a contribuição de qualquer métrica para o volume faturável.
  • Identificar métricas que são coletadas, mas não usadas em nenhuma política de alertas ou painel. Os dados de métricas que não são usados podem representar uma lacuna na observabilidade ou uma oportunidade de economia de custos.
  • Crie uma política ou um gráfico de alertas para métricas que não têm uma política de alertas associada ou um painel personalizado.
  • Identifique o projeto de origem dos dados de métricas. A tabela inclui métricas de todos os projetos no escopo, e talvez seja necessário saber no projeto que uma métrica específica foi coletada.
  • Revise as informações de rótulo e cardinalidade de cada métrica. Essas informações podem ser úteis quando você está investigando problemas com o design ou o uso de métricas.

Para visualizar 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 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 exibe informações sobre as métricas coletadas no dia anterior. A captura de tela abaixo mostra um exemplo da tabela de métricas:

    A tabela mostra informações sobre cada métrica nos projetos no escopo.

Selecione as métricas para visualização

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 se deve a uma ou duas métricas, investigue o uso delas.

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 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 exibe 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.

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 exibe a atribuição dela ao volume faturável e fornece links para as políticas de alertas e os painéis personalizados associados à métrica, conforme mostrado na captura de tela a seguir. Se não houver um painel ou política de alertas associado a uma métrica, a tabela incluirá um botão em que você poderá clicar para criar um.

A tabela mostra informações sobre cada métrica nos projetos no escopo.

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

A tabela de métricas também mostra o domínio da métrica, o conjunto de rótulos dela, o projeto do qual a métrica foi ingerida e a cardinalidade da métrica. A captura de tela abaixo mostra um exemplo dessas colunas.

A tabela informa o domínio, os rótulos, o ID do projeto e a cardinalidade das métricas no escopo.

As informações de rótulo e cardinalidade podem ser úteis para identificar a causa dos aumentos no volume faturável. No Cloud Monitoring, cardinalidade se refere ao número de séries temporais associadas a uma métrica e 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.

Alterações no volume faturável significam que você está ingerindo mais dados e, se as alterações forem repentinas ou inesperadas, a causa poderá ser uma alteração no número de rótulos associados a uma métrica ou uma mudança na maneira como os valores dos rótulos são definidos. Qualquer um deles pode aumentar a cardinalidade de uma métrica, com o resultado de um volume faturável maior. Para informações sobre como usar o Gerenciamento de métricas para ajudar a identificar problemas com elas, consulte Investigar problemas com suas métricas.

Usar filtros rápidos

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

  • Métricas ativas e inativas: métricas que gravaram ou não dados de série temporal nas últimas 25 horas.
  • Métricas que são usadas (ou não) em políticas de alertas no projeto atual do Google Cloud.
  • Métricas usadas ou não em painéis personalizados no projeto atual do Google Cloud. Esses filtros não incluem métricas usadas em painéis predefinidos fornecidos pelo Cloud Monitoring.
  • Categorias de métricas, conforme descrito no Resumo de métricas faturáveis.

Use o painel de filtros para selecionar métricas pelas características filtráveis.

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

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 correspondam a combinações de filtros. Só é possível selecionar um filtro rápido por vez. Portanto, não é possível usar filtros rápidos para listar apenas métricas ativas que não aparecem em uma política de alertas nem em um painel personalizado. Para pesquisar métricas que correspondam a uma combinação de requisitos, adicione filtros à barra de filtro. Por exemplo, para listar métricas ativas que não aparecem em políticas de alertas nem em painéis personalizados, adicione os seguintes filtros à barra de filtro:

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

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

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 fornece um botão Criar alerta. Para criar uma política de alertas para uma métrica, clique em Criar alerta na linha correspondente.

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 seguida, em Criar alerta para métrica.

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

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 fornece 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 atual em que você quer salvar o gráfico ou selecione Novo painel para criar um novo painel para o gráfico.
    3. Clique em Salvar gráfico.

Trabalhar com métricas

Embora você possa usar a página Gerenciamento de métricas para ver algumas informações sobre uma métrica, é possível saber mais. Por exemplo, talvez você queira ver um gráfico de uma métrica específica ou criar uma política de alertas para receber notificações quando a taxa de ingestão 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 Gerenciamento de métricas

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

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

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

      O Metrics Explorer é aberto e pré-configurado para exibir a métrica selecionada. É possível modificar, descartar ou adicionar o gráfico 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.

    • Para ver os registros de auditoria associados à métrica, selecione Ver registros de auditoria da métrica.

Visualizar e alertar sobre a ingestão de métricas faturáveis

O número de bytes e amostras faturáveis ingeridas determina a maior parte dos custos. Para prever os 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 apresenta resumos do uso das métricas, que podem ajudar você a:

  • Veja as tendências de 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.
  • Identificar os namespaces responsáveis por gerar a maior parte dos dados do Prometheus.
  • Confira a taxa de erros de gravação nas métricas. A taxa de erro é a porcentagem de gravações de métricas que retornam um status de erro em relação ao número total de gravações de métricas.

Mostrar resumos de uso de métricas

Para visualizar 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 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 exibe informações sobre as métricas coletadas no dia anterior. A captura de tela a seguir mostra um exemplo:

    O painel de resumo informa sobre o uso de métricas em todos os projetos no seu escopo.

    • Para ver um resumo de quantas métricas faturáveis estão ativas atualmente nos projetos do seu escopo, consulte a visão geral Métricas ativas. Uma métrica estará ativa se os dados tiverem sido gravados nela.

    • Para determinar o que está contribuindo para os custos, use as visões gerais Bytes faturáveis ingeridos e Amostras faturáveis ingeridas. Para mais informações, consulte Visualizar 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 Métrica "Erros de gravação". Para mais informações, acesse Investigar problemas com suas métricas.

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

Conferir as 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, veja as taxas de coleta usando as visões gerais de ingestão. Ao alterar a janela de tempo para visualizar as métricas, você poderá ver quedas, picos ou tendências.

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

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

    Acesse 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 Exibir gráficos na visão geral para bytes ou amostras ingeridas. Essa discussão se refere a gráficos de amostras faturáveis, mas os gráficos de bytes faturáveis funcionam da mesma maneira. Você verá um conjunto de gráficos como este:

    Exemplo dos gráficos que resumem a ingestão de métricas.

    Por padrão, as legendas do gráfico ficam recolhidas. Para visualizar a lista de série temporal mostradas em um gráfico, clique em  Legenda. Para informações sobre como definir referências de tempo ou expandir o gráfico em uma janela de tempo específica, consulte Explorar dados nos gráficos.

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

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

  • Para visualizar as contribuições de cada projeto no seu escopo de métricas para o valor faturável total, use o gráfico Projetos por amostras faturáveis ingeridas. Esse gráfico informa quais projetos estão enviando mais dados e se algum projeto está enviando uma quantidade crescente ou decrescente de dados.

  • (Somente 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 volumes de namespaces.

  • Para ver as métricas no escopo com as maiores contribuições para os valores faturáveis, use o gráfico As 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 visualizar as contribuições para o valor faturável de todas as métricas no 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 coleta das suas métricas.

Para analisar qualquer um desses gráficos em 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 de namespace e usam o Metrics Explorer para realizar a atribuição de volume de ingestão, consulte:

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 comportamento do último mês, consulte Explorar dados em gráficos.

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

Para receber notificações sobre picos, quedas ou tendências nas taxas de coleta de métricas das métricas faturáveis, crie uma política de alertas. Por exemplo, uma queda no conjunto de métricas pode indicar que o aplicativo está com desempenho insatisfatório. Da mesma forma, um pico pode resultar em cobranças inesperadas. Por fim, uma tendência crescente 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. Assim, você resolve a situação.

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

Para criar uma política de alertas que monitore a 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 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 Exibir gráficos na visão geral para 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 do aumento da latência das consultas de uma métrica específica.
  • Erros na gravação de dados de métricas, que podem resultar do alcance dos limites na quantidade ou taxa de dados sendo 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 o aumento da latência da consulta. Por exemplo, uma alteração na configuração de uma métrica pode resultar em um problema de cardinalidade, o que afeta 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étricas

Na visão geral Erros de gravação de métrica, faça o seguinte:

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

Para ver 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 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 Visualizar erros na visão geral Erros de gravação de métrica.

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

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

      O gráfico de **Erros de gravação de métrica** mostra a taxa de erros para gravar dados de série temporal.

      Se você observar um aumento no número de solicitações de gravação de métricas, é provável que esteja tendo um problema de cardinalidade.

    • Se o gráfico exibir códigos de status para erros e se você tiver ativado registros de auditoria para seu projeto, será possível usá-los para investigar as causas dos erros. A consulta pré-configurada 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 fornecer mais informações 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 só vez ou exceder um limite no número de série temporal ativas. Para mais informações, consulte a seção Métricas definidas pelo usuário no documento de cotas do Monitoring.

Investigar erros de criação de métricas

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

Para ver 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 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 Ver registros de auditoria de métricas.

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

Os erros do método metricDescriptors.create podem ajudar a identificar possíveis problemas no design das métricas. Você poderá ver erros desse método se 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 de cotas do Monitoring.

A seguir