Como configurar uma métrica de destino

Nesta página, descrevemos como usar a ferramenta de seleção de métricas para especificar uma métrica de destino para uma política de alertas. Com o gráfico ao lado da região Destino, você tem um feedback visual sobre os dados capturados pelo destino.

A região Destino usa o mesmo seletor de métricas utilizado no Metrics Explorer e para criar gráficos. Se você já estiver familiarizado com isso, pule esta página.

Como selecionar uma métrica

Para selecionar uma métrica, use o campo Encontrar métrica e tipo de recurso para escolher um tipo de recurso e um de métrica. É possível especificá-los em qualquer ordem. Para começar, clique no campo. Isso trará uma ou duas listas, com base em qualquer seleção anterior. As listas são indicadas por cabeçalhos, Tipos de recursos e Métricas, como mostra a captura de tela a seguir:

Listas de pesquisa para selecionar métricas e recursos.

Há duas maneiras de selecionar uma entrada:

  • ao selecionar entradas das listas;

  • ao inserir um filtro de métrica. Para inserir um filtro de métrica, faça o seguinte:

    1. Ao lado de Encontrar métrica e tipo de recurso, clique em Ajuda
    2. Clique em Modo de filtro direto no painel de ajuda.

      Quando o Modo de filtro direto está ativado, a opção Encontrar métrica e tipo de recurso é substituída por uma caixa de texto editável chamada Tipo de recurso, métrica e filtro:

      O

      Se você escolheu um tipo de recurso, uma métrica ou um filtro antes de selecionar Modo de filtro direto, essas configurações serão usadas para preencher a caixa de texto Tipo de recurso, métrica e filtro.

    3. Insira um filtro de métrica na caixa de texto Tipo de recurso, métrica e filtro. O filtro precisa incluir um tipo de métrica e um de recurso. Também é possível incluir filtros de rótulo. Para saber mais sobre a gramática de filtros, consulte Filtros do Monitoring.

      Por exemplo, para exibir as entradas de registro de todas as instâncias de VM do Google Cloud na zona us-east1-b, insira:

      metric.type="logging.googleapis.com/log_entry_count" resource.type="gce_instance" resource.label."zone"="us-east1-b"
      

      Se você usou o modo de filtro direto para configurar gráficos ou políticas de alertas e nenhum dado estiver disponível, uma mensagem de erro aparecerá no gráfico. A mensagem de erro exata depende do filtro inserido. Por exemplo, uma mensagem comum é Chart definition invalid. Você também pode ver a mensagem No data is available for the selected time frame.

Passar o cursor do mouse sobre um item em uma das listas carrega uma dica que exibe as informações no descritor do item. Para mais informações sobre descritores de tipos de métricas ou recursos monitorados, consulte a lista de métricas ou a de recursos monitorados.

Quando pelo menos um tipo de recurso e um par de métricas são selecionados, o gráfico mostra todas as séries temporais disponíveis. Itens adicionais aparecem abaixo da métrica especificada na guia Métrica. A captura de tela abaixo mostra a guia Métrica depois que uma métrica é especificada:

Exibe mais opções de seleção.

Filtro

É possível reduzir o volume de dados retornados de uma métrica ao especificar critérios de filtro. Assim, somente séries temporais que atendam a algum conjunto de critérios serão usadas. Se você aplicar filtros, haverá menos linhas no gráfico, e isso pode melhorar o desempenho dele.

Você pode fornecer vários critérios de filtragem. O gráfico correspondente mostra apenas as séries temporais que atendem a todos os critérios, um AND lógico.

No Console do Google Cloud, para adicionar um filtro, clique no campo Filtrar. Isso abre um painel que contém listas de critérios que podem ser usados para a filtragem. Por exemplo, é possível filtrar por grupo de recursos, por nome, por rótulo de recurso, por zona e por rótulo de métrica.

A captura de tela abaixo mostra os rótulos de filtro conhecidos de um projeto:

Listas de rótulos de filtro preenchidos previamente

É possível selecionar das listas ou digitar para encontrar as correspondências. Além disso, você pode criar filtros para dados que ainda não apareceram. Esses critérios de filtro não aparecerão na lista de seleção, mas é possível especificar manualmente os filtros que você sabe que serão válidos no futuro.

Depois de escolher um rótulo para filtrar, especifique o restante do filtro: um valor ou intervalo de valores e uma comparação.

Por exemplo, veja na captura de tela a seguir um filtro no rótulo de recurso zone. O campo Filtro é compatível com um par de operadores de comparação para igualdade, = e =~, e um para desigualdade, != e !=~. O segundo item em cada par recebe uma expressão regular como um valor. O padrão é o operador de igualdade simples, =.

Comparadores de filtro

Abaixo da lista de operadores de comparação, há uma lista dos valores disponíveis. A captura de tela a seguir mostra os nomes das zonas no projeto:

Alguns valores de filtro preenchidos previamente

Para o campo Valor, é possível selecionar um dos itens na lista suspensa ou inserir uma expressão que corresponda a vários itens:

  • Se você usar uma comparação direta, = ou !=, crie uma string de filtro como starts_with. Por exemplo, a string de filtro starts_with("us-central") corresponde a qualquer zona us-central:

    Como usar uma string de filtro

    Consulte Como monitorar filtros para saber mais sobre strings de filtros.

  • Se você selecionar =~ ou !=~, poderá usar uma expressão regular RE2 no valor. Por exemplo, a expressão regular us-central1-.* corresponde a qualquer zona us-central1:

    Como filtrar com regexps

    A expressão regular ^us.*.a$ corresponde a qualquer zona dos EUA que termine com “a”:

    Como filtrar com mais regexps

É possível especificar vários critérios de filtro e usar o mesmo rótulo várias vezes. Isso permite que você especifique um filtro para um intervalo de valores. Para adicionar mais filtros, clique na opção Adicionar um filtro próxima à parte inferior do campo de filtro. Atualmente, todos os critérios de filtro precisam ser atendidos. Eles constituem um AND lógico. Por exemplo, use as strings de filtro starts_with e ends_with para mostrar apenas as zonas “a” nos EUA:

Como usar vários filtros

Agregação

Depois de selecionar a série temporal, o próximo passo é especificar as opções de agregação. A agregação consiste no alinhamento de séries temporais individuais e na combinação das séries alinhadas. Para uma explicação detalhada sobre agregação, consulte Filtragem e agregação: como manipular séries temporais.

Como alinhar dados

O alinhamento é o processo de conversão dos dados de série temporal recebidos pelo Monitoring em uma nova série temporal com pontos de dados espaçados por um comprimento fixo. O processo de alinhamento consiste em coletar todos os pontos de dados recebidos em um intervalo de comprimento fixo, aplicando uma função para combinar esses pontos e dados e atribuindo o carimbo de data/hora ao resultado. Essa função de combinação pode calcular a média de todas as amostras ou extrair o máximo de todas as amostras. Para uma discussão geral sobre alinhamento, consulte Alinhamento: regularização na série.

Ao criar uma condição em uma política de alertas, especifique os parâmetros de alinhamento. Se estiver usando o Console do Google Cloud, depois de selecionar o tipo de recurso e a métrica na condição de alerta, vários campos adicionais e um botão chamado Mostrar opções avançadas são exibidos:

Exibição do campo Período.

Período: o período é um intervalo de retrospectiva de um determinado momento. Por exemplo, se o período for cinco minutos, então, às 13h, as amostras recebidas entre 12h55 e 13h serão alinhadas. às 13h01, as amostras recebidas entre 12h56 e 13h01 precisam ser alinhadas. No contexto das políticas de alertas, o período de alinhamento pode ser visto como uma janela deslizante que olha para o passado. Para uma discussão mais envolvida sobre esse campo, consulte O período de alinhamento e a duração.

Para visualizar as opções de agregação restantes, clique em Mostrar opções avançadas:

Exibição das opções avançadas.

Alinhador: o campo de alinhador especifica a função usada para combinar todos os pontos de dados em um período de alinhamento. Para mais informações sobre os alinhadores disponíveis, consulte Aligner na referência da API. Alguns alinhadores alinham os dados e os convertem de um tipo de métrica para outro. Para uma explicação detalhada, consulte Tipos e conversões.

Como combinar séries temporais

É possível reduzir a quantidade de dados retornados para uma métrica combinando diferentes séries temporais. Para combinar várias séries temporais, você geralmente especifica um agrupamento e uma função. O agrupamento é feito com base nos rótulos. A função, chamada de Agregador no Console do Google Cloud, é usada para combinar as séries temporais do grupo em uma única série temporal. Os agregadores típicos incluem os valores de desvio médio, máximo, mínimo e padrão e também percentis variados.

Para adicionar um agrupamento, clique em Adicionar um rótulo na caixa de texto Agrupar por e, em seguida, faça uma seleção no menu. O menu é criado dinamicamente e exibe os rótulos disponíveis. Esses são os mesmos rótulos que podem ser usados para filtragem. Quando você adiciona a primeira opção de agrupamento, acontece o seguinte:

  • Um agregador é selecionado. A função selecionada é determinada pelo tipo de dado que está sendo exibido. No entanto, essa função pode ser alterada.
  • O agregador combina todas as séries temporais que têm o mesmo valor de rótulo em uma única série temporal.
  • O gráfico exibe uma série temporal para cada valor do rótulo "agrupar por".

A captura de tela a seguir mostra um agrupamento por user_labels.version com o Agregador definido como o valor padrão de sum:

Exemplo de configuração de agrupamento.

Essa seleção resulta em uma série temporal para cada valor de user_labels.version. Os pontos de dados em cada série temporal são calculados a partir da soma de todos os valores de séries temporais individuais para uma versão específica:

Exibição de séries temporais agrupadas por user_labels.version

Agrupe por vários rótulos. Quando você tem várias opções de agrupamento, as séries temporais são agrupadas pela combinação de valores dos rótulos e o agregador é aplicado a cada grupo. O gráfico resultante exibe uma série temporal para cada combinação de valores dos rótulos. A ordem de especificação dos rótulos não importa.

Por exemplo, a captura de tela a seguir ilustra o agrupamento por user_labels.version e system_labels.machine_image:

Como exibir séries temporais agrupadas por versão e imagem da máquina.

Conforme ilustrado, se agrupar por rótulos, você terá uma série temporal para cada par de valores. O fato de você ter uma série temporal para cada combinação de rótulos significa que essa técnica pode facilmente criar mais dados do que é possível colocar em um único gráfico.

Se você não especificar uma opção de agrupamento e especificar um agregador, o agregador será aplicado a todas as séries temporais selecionadas e resultará em uma única série temporal. Esse comportamento é ilustrado na captura de tela a seguir:

Exibição das séries temporais agregadas por soma, mas sem agrupamento

Quando você especifica o agrupamento ou se seleciona um agregador, a série temporal resultante contém apenas os rótulos obrigatórios, como o identificador do projeto e os rótulos especificados pelo agrupamento.

Para remover uma condição de "Group By", siga estas etapas:

  1. Exclua os rótulos de "Group By".
  2. Defina o agregador como none.

Agregação secundária

Quando você tem várias séries temporais que já representam agregações, como os exemplos que ilustram a opção Agrupar por, é possível agregá-las escolhendo um Agregador secundário:

Campo para agregação secundária

A agregação secundária reduz todas as séries temporais no gráfico a uma única série temporal.

Modelo de legenda

No Console do Cloud, se você expandir as opções de agregação clicando em Mostrar opções avançadas um Modelo de legenda será exibido, além de campos para o alinhador, o período de alinhamento e o agregador secundário.

Como exibir o local do campo do modelo de legenda.

O campo Modelo de legenda permite personalizar uma descrição para a série temporal no seu gráfico. Essas descrições aparecem no cartão de informações e na legenda do gráfico na coluna Nome.

Por padrão, as descrições na legenda são criadas para você a partir dos valores de diferentes rótulos na série temporal. Como o sistema seleciona os rótulos, os resultados podem não ser úteis para você. Você pode usar este campo para criar um modelo para as descrições.

O campo Modelo de legenda aceita o seguinte:

  • Filtros que se referem a rótulos na série temporal. Para ver todos os filtros disponíveis na série temporal, clique em Adicionar um filtro. Depois de selecionar um filtro, ele será adicionado à caixa de texto e representado como uma expressão como ${resource.labels.zone}. Quando a expressão é avaliada, o valor é extraído dos rótulos de uma série temporal e inserido na legenda.

  • Texto simples. Se você fornecer apenas texto, as descrições da série temporal no gráfico serão idênticas. No entanto, é possível combinar texto e filtros.

Por exemplo, a captura de tela a seguir mostra um modelo que consiste em uma string de texto simples e a expressão de filtro ${resource.labels.zone}:

Um modelo para uma descrição simples

Na legenda do gráfico, os valores gerados a partir do modelo aparecem em uma coluna com o cabeçalho Nome e no cartão de informações:

Descrições geradas a partir de um modelo

É possível criar modelos que usam várias strings e filtros, mas o espaço de exibição disponível no cartão de informações é limitado.