Como resolver problemas de métricas com base em registros

Para diagnosticar e resolver problemas com as métricas com base em registros no Cloud Logging, como dados ausentes, contagens atrasadas ou alertas de falsos positivos, use as orientações de solução de problemas nesta página.

O conteúdo desta página se aplica apenas aos dados de métricas derivados dos seus registros. Isso não se aplica aos dados de métricas gravados diretamente pelos serviços do Google Cloud ou pelos seus aplicativos.

Não é possível visualizar ou criar métricas

As métricas com base em registros se aplicam apenas a um único projeto do Google Cloud ou a um bucket do Logging em um projeto do Google Cloud . Não é possível criar métricas com base em registros para outros recursos do Google Cloud, como contas de faturamento ou organizações. As métricas com base em registros são calculadas para registros apenas no projeto ou bucket do Google Cloud em que são recebidas.

Para criar métricas com base em registros, você precisa das permissões corretas do Identity and Access Management. Para mais detalhes, consulte Controle de acesso com o IAM: métricas com base em registros.

Faltam dados de registros na métrica

Esta entrada se aplica apenas aos dados de métricas que o Google Cloud Observability deriva dos seus dados de registro (métricas com base em registros). Ele não se aplica aos dados de métricas gravados por Google Cloud serviços ou aplicativos.

Existem várias razões possíveis para a falta de dados nas métricas com base em registros:

  • Novas entradas de registro podem não corresponder ao filtro de registros da sua métrica. Uma métrica com base em registros aceita os dados das entradas de registro correspondentes recebidas após a criação da métrica. O Logging não preenche a métrica a partir de entradas de registro anteriores.

  • Novas entradas de registro podem não conter o campo correto ou os dados podem não estar no formato correto para serem extraídos pela métrica de distribuição. Verifique se os nomes dos campos e as expressões regulares estão corretos.

  • As contagens de métricas podem estar atrasadas. Mesmo que as entradas de registro contáveis apareçam na Análise de registros, pode levar até 10 minutos para atualizar as métricas com base em registros no Cloud Monitoring.

  • As entradas de registro exibidas podem ser contadas com atraso ou não ser contadas, porque têm carimbos de data/hora muito antigos ou futuros. Se uma entrada de registro for recebida pelo Cloud Logging mais de 24 horas no passado ou 10 minutos no futuro, ela não será contabilizada na métrica com base em registros.

    O número de entradas atrasadas é registrado na métrica com base em registros logging.googleapis.com/logs_based_metrics_error_count.

    Exemplo: uma entrada de registro que corresponde a uma métrica com base em registros chega atrasada. Ele tem um timestamp de 14h30 em 20 de fevereiro de 2020 e um receivedTimestamp de 14h45 em 21 de fevereiro de 2020. Essa entrada não será contabilizada na métrica com base em registros.

  • A métrica com base em registros foi criada após a chegada de entradas de registro que a métrica pode contar. As métricas com base em registros avaliam as entradas de registro conforme elas são armazenadas em buckets de registro. Essas métricas não avaliam as entradas de registro armazenadas no Logging.

  • A métrica com base em registros tem lacunas nos dados. Algumas lacunas de dados são esperadas, porque os sistemas que processam os dados de métricas com base em registros não garantem a persistência de todos os pontos de dados de métricas. Quando ocorrem, as lacunas costumam ser raras e de curta duração. No entanto, se você tiver uma política de alertas que monitora uma métrica com base em registros, as lacunas nos dados poderão causar uma notificação falsa. As configurações usadas na política de alertas podem reduzir essa possibilidade.

    Exemplo: uma entrada de registro de "heartbeat" é gravada a cada cinco minutos, e uma métrica com base em registros conta o número de entradas de registro de "heartbeat". Uma política de alertas soma as contagens em um intervalo de cinco minutos e notifica você quando o total é menor que um. Quando a série temporal não tem um ponto de dados, a política de alertas injeta um valor sintético, que é uma cópia da amostra mais recente e provavelmente é zero, e avalia a condição. Portanto, mesmo um único ponto de dados ausente pode resultar em um valor somado de zero, o que faz com que essa política de alertas envie uma notificação.

    Para reduzir o risco de uma notificação falsa, configure a política para contar várias entradas de registro de "heartbeat", não apenas uma.

O tipo de recurso é "indefinido" no Cloud Monitoring

Esta entrada se aplica apenas aos dados de métricas que o Google Cloud Observability deriva dos seus dados de registro (métricas com base em registros). Ele não se aplica aos dados de métricas gravados por Google Cloud serviços ou aplicativos.

Alguns tipos de recursos monitorados do Cloud Logging não são mapeados diretamente para os tipos de recursos monitorados do Cloud Monitoring. Por exemplo, ao criar uma política de alertas ou um gráfico com base em uma métrica com base em registros, talvez o tipo de recurso apareça como "indefinido".

O tipo de recurso é indefinido.

O tipo de recurso monitorado mapeia para global ou um outro tipo de recurso monitorado no Cloud Monitoring. Consulte Mapeamentos para recursos somente do Logging para determinar que tipo de recurso monitorado você precisa escolher.

Os rótulos em uma notificação não são resolvidos

Esta entrada se aplica apenas aos dados de métricas que o Google Cloud Observability deriva dos seus dados de registro (métricas com base em registros). Ele não se aplica aos dados de métricas gravados por Google Cloud serviços ou aplicativos.

Crie uma métrica com base em registros e, em seguida, uma política de alertas para monitorar essa métrica. No campo de documentação da política de alertas, você se refere aos rótulos extraídos usando uma variável do formato ${log.extracted_label.KEY}, em que KEY é o nome que você deu ao rótulo extraído. O rótulo não é resolvido na notificação.

Para resolver esse problema, siga um destes procedimentos:

  • Remova o conteúdo do rótulo extraído da documentação. As políticas de alertas que monitoram métricas com base em registros não podem extrair dados de entradas de registro.

  • Criar um alerta com base em registros. Essas políticas de alertas podem extrair dados da entrada de registro que faz com que a política de alertas seja acionada.

Os alertas não são criados ou são falsos positivos

Esta entrada se aplica apenas aos dados de métricas que o Google Cloud Observability deriva dos seus dados de registro (métricas com base em registros). Ele não se aplica aos dados de métricas gravados por Google Cloud serviços ou aplicativos.

Você pode receber alertas de falsos positivos ou situações em que o Monitoring não cria alertas de métricas com base em registros porque o período de alinhamento da política de alertas é muito curto. Você pode encontrar falsos positivos nos seguintes cenários:

  • Quando uma política de alertas usa a lógica menor que.
  • Quando uma política de alertas é baseada em uma condição de percentil para uma métrica de distribuição.
  • Quando há uma lacuna nos dados de métricas.

Os alertas de falsos positivos podem ocorrer porque as entradas de registro podem ser enviadas para o Logging com atraso. Por exemplo, os campos de registro timestamp e receiveTimestamp podem ter um delta de minutos em alguns casos. Além disso, quando o Logging armazena registros em buckets de registro, há um atraso inerente entre o momento em que as entradas de registro são geradas e o momento em que o Logging as recebe. Isso significa que o Logging pode não ter a contagem total de uma entrada de registro específica até algum momento posterior à geração das entradas de registro. É por isso que uma política de alertas que usa a lógica menor que ou que se baseia em uma condição de percentil para uma métrica de distribuição pode produzir um alerta falso positivo: nem todas as entradas de registro foram contabilizadas ainda.

No entanto, as métricas com base em registros têm consistência posterior porque uma entrada de registro que corresponde a uma métrica com base em registros pode ser enviada ao Logging com um timestamp significativamente mais antigo ou mais recente do que o receiveTimestamp do registro.

Isso significa que a métrica com base em registros pode receber entradas de registro com carimbos de data/hora mais antigos depois que as entradas de registro atuais com o mesmo carimbo de data/hora já tiverem sido recebidas pelo Logging. Portanto, o valor da métrica precisa ser atualizado.

Para que as notificações permaneçam precisas mesmo para dados pontuais, recomendamos que você defina o período de alinhamento para que a condição seja grande o suficiente para contar várias entradas de registro que correspondam ao seu filtro e para considerar o atraso de ingestão, que pode ser de até 10 minutos.

Por exemplo, se uma métrica com base em registros contar entradas de registro de "pulsação" esperadas a cada 7 minutos, defina o período de alinhamento como pelo menos 24 minutos. Esse valor considera o atraso de ingestão e duas amostras.

  • Se você usa o console do Google Cloud , use o menu Janela contínua para definir o período de alinhamento.

  • Se você usar a API, use o campo aggregations.alignmentPeriod da condição para definir o período de alinhamento.

A métrica com base em registros tem muitas série temporal

Esta entrada se aplica apenas aos dados de métricas que o Google Cloud Observability deriva dos seus dados de registro (métricas com base em registros). Ele não se aplica aos dados de métricas gravados por Google Cloud serviços ou aplicativos.

O número de séries temporais em uma métrica depende do número de diferentes combinações de valores de rótulo. O número de série temporal é chamado de cardinalidade da métrica. O número máximo de série temporal para uma métrica é 30.000.

Como você gera uma série temporal para cada combinação de valores de rótulo, se você tiver um ou mais rótulos com um número alto de valores, não será difícil exceder 30.000 séries temporais. Evite métricas com alta cardinalidade.

À medida que a cardinalidade de uma métrica aumenta, a métrica pode ser sobrecarregada e alguns pontos de dados podem não ser gravados nela. O carregamento dos gráficos que exibem a métrica pode demorar devido ao grande número de séries temporais que o gráfico precisa processar. Também podem ser gerados custos para chamadas de API para consultar dados de série temporal. Consulte as seções do Cloud Monitoring na página de preços do Google Cloud Observability.

Devido ao limite de 1.000.000 de série temporal ativas por recurso monitorado, o sistema pode limitar os dados de métricas mesmo quando houver menos de 30.000 série temporal ativas. Para métricas com base em registros para envolvidos no projeto, o recurso é definido pelo recurso na entrada de registro. Para métricas com base em registros com escopo de bucket, o recurso é logging_bucket.

Para evitar a criação de métricas de alta cardinalidade:

  • verifique se os campos de rótulo e as expressões regulares do extrator correspondem aos valores que têm uma cardinalidade limitada;

    Por exemplo, não armazene tamanhos, contagens ou durações em rótulos. Além disso, não armazene campos como URLs, endereços IP ou IDs exclusivos, porque todos eles podem resultar em um grande número de série temporal.

  • evite extrair mensagens de texto que podem ser alteradas, sem limites, como valores de rótulo;

  • evite extrair valores numéricos com cardinalidade ilimitada;

  • Extraia apenas valores de rótulos de cardinalidade conhecida, por exemplo, códigos de status com um conjunto de valores conhecidos.

Essas duas métricas com base em registros do sistema podem ajudar a avaliar o efeito da adição ou remoção de rótulos na cardinalidade da métrica:

Ao inspecionar essas métricas, é possível filtrar ainda mais os resultados pelo nome da métrica. Para detalhes, consulte Como selecionar métricas: filtros.

O nome da métrica é inválido

Ao criar uma métrica de contador ou distribuição, escolha um nome exclusivo entre as métricas com base em registros no projeto do Google Cloud .

As strings de nome de métrica não podem exceder 100 caracteres e podem incluir apenas os seguintes caracteres:

  • A-Z
  • a-z
  • 0-9
  • Os caracteres especiais _-.,+!*',()%\/.

    O caractere de barra / denota uma hierarquia de partes dentro do nome da métrica e não pode ser o primeiro caractere do nome.

Os valores da métrica com base em registros estão incorretos

Esta entrada se aplica apenas aos dados de métricas que o Google Cloud Observability deriva dos seus dados de registro (métricas com base em registros). Ele não se aplica aos dados de métricas gravados por Google Cloud serviços ou aplicativos.

Você percebe que os valores informados para uma métrica com base em registros às vezes são diferentes do número de entradas de registro informadas pela Análise de Registros.

Para minimizar a discrepância, faça o seguinte:

  • Verifique se os aplicativos não estão enviando entradas de registro duplicadas. As entradas de registro são consideradas duplicadas quando têm os mesmos timestamp e insertId. A Análise de Registros suprime automaticamente as entradas de registro duplicadas. No entanto, as métricas com base em registros contam cada entrada de registro que corresponde ao filtro da métrica.

  • Verifique se uma entrada de registro é enviada ao Cloud Logging quando o carimbo de data/hora é inferior a 24 horas no passado ou inferior a 10 minutos no futuro. As entradas de registro com carimbos de data/hora fora desses limites não são contadas pelas métricas com base em registros.

Não é possível eliminar a possibilidade de registros duplicados. Se ocorrer um erro interno durante o processamento de uma entrada de registro, um processo de repetição será invocado pelo Cloud Logging. O processo de nova tentativa pode causar uma entrada de registro duplicada. Quando há entradas de registro duplicadas, o valor de uma métrica com base em registros pode ser muito grande, porque essas métricas contam cada entrada de registro que corresponde ao filtro da métrica.

Os valores de rótulo estão truncados

Esta entrada se aplica apenas aos dados de métricas que o Google Cloud Observability deriva dos seus dados de registro (métricas com base em registros). Ele não se aplica aos dados de métricas gravados por Google Cloud serviços ou aplicativos.

Os valores de rótulos definidos pelo usuário não podem exceder 1.024 bytes.

Não é possível excluir uma métrica com base em registros personalizada

Esta entrada se aplica apenas aos dados de métricas que o Google Cloud Observability deriva dos seus dados de registro (métricas com base em registros). Ele não se aplica aos dados de métricas gravados por Google Cloud serviços ou aplicativos.

Você tenta excluir uma métrica com base em registros personalizada usando o console do Google Cloud . A solicitação de exclusão falha, e a caixa de diálogo de exclusão exibe a mensagem de erro There is an unknown error while executing this operation.

Para resolver esse problema, tente o seguinte:

  • Atualize a página Métricas com base em registros no console do Google Cloud . A mensagem de erro pode ser mostrada devido a um problema de tempo interno.

  • Identifique e exclua todas as políticas de alertas que monitoram a métrica com base em registros. Depois de verificar que a métrica com base em registros não é monitorada por uma política de alertas, exclua-a. Não é possível excluir métricas com base em registros monitoradas por uma política de alertas.