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. Essa mensagem de erro 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. A filtragem remove alguns dados do gráfico excluindo séries temporais que não atendem aos critérios de filtragem. O resultado será menos linhas no gráfico que exibe essa métrica, melhorando 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.

Quando você clica no campo Filtro, é exibido um painel contendo listas de critérios. Esses critérios podem ser usados para filtrar. Em geral, você pode filtrar por grupo de recursos, por nome, por rótulo de recurso 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

Você pode 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 !=~, será possível usar uma expressão regular 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

Agrupamento

É possível reduzir a quantidade de dados retornados para uma métrica combinando dados de séries temporais semelhantes.

Como a filtragem, o agrupamento é uma maneira de reduzir a quantidade de dados que você está manipulando. A filtragem funciona excluindo algumas séries temporais e agrupando trabalhos. Para isso, é preciso identificar conjuntos de séries temporais que atendem a algum critério e, em seguida, combinar ou agregar os membros dos conjuntos.

O agrupamento é feito com base nos rótulos. Ao clicar no campo Agrupar por, você recebe os mesmos rótulos que estão disponíveis para filtragem.

A opção Agrupar por permite agrupar séries temporais por rótulos de recursos e métricas e, em seguida, combinar os dados nesses grupos. Isso cria uma nova série temporal única para cada combinação de valores agrupados e a nova série temporal representa todos os membros do grupo.

Suponhamos, por exemplo, que você queira examinar a carga de geração de registros, mas somente em nível regional. Ou seja, sem se preocupar com o número de entradas de servidores específicos. É possível agrupar séries temporais por zona e, em seguida, pôr em gráficos o total, a média ou outra medida para cada zona.

Com Agrupar por, você escolhe uma função de agregação padrão com base no tipo dos dados que estão sendo agrupados. No entanto, é possível alterar essa seleção. Consulte Agregação para mais informações sobre outras opções.

A captura de tela abaixo mostra um agrupamento por zona. O padrão é a opção sum em Agregador.

Como agrupar séries temporais

Isso cria uma nova série temporal para cada zona, com valores computados da soma de todos os valores de séries temporais individuais nessa zona.

Você também pode agrupar por vários rótulos. Ao agrupar por vários rótulos, você terá uma série temporal para cada combinação de rótulos. A ordem de especificação dos rótulos não importa.

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

  1. Exclua os rótulos de "Agrupar por".
  2. Defina o método de agregação novamente como none.

Agregação

A opção Agregador permite combinar séries temporais usando funções comuns. O resultado será menos linhas no gráfico que exibe a métrica, melhorando o desempenho dele.

Clique no campo Agregador para ver uma lista das opções de agregação disponíveis. Estas são as funções, ou redutores, que podem ser usadas para combinar as séries temporais.

As funções de redução disponíveis dependem do tipo de valores que a métrica captura, mas geralmente incluem opções como média, máximo ou mínimo, desvio padrão, valores percentuais variados e assim por diante. Para mais informações sobre essas dependências, consulte Métricas, séries temporais e recursos.

Quando usada sem agrupamento, a função de redução é aplicada em todas as séries temporais selecionadas, combinando-as em uma única série temporal que consiste na média, soma ou outra medida calculada em todas as séries temporais. Quando usada com agrupamento, a função é aplicada à série temporal dentro de cada grupo.

Para mais informações sobre agregação, consulte Aggregation na referência da API.

A opção Agrupar por aplica a agregação automaticamente para calcular estatísticas em cada grupo. As linhas em um gráfico de Agrupar por já representam agregações. Com Agrupar por, você escolhe uma função de agregação padrão com base no tipo dos dados que estão sendo agrupados. No entanto, é possível alterar essa seleção.

É possível também aplicar a agregação a um conjunto de séries temporais que você filtrou. Como na série temporal não filtrada, a agregação de séries temporais filtradas reduzirá todas as linhas a uma que reflita a função de agregação escolhida, a menos que você também use o agrupamento.

Há mais opções para selecionar uma métrica. Essas opções têm valores padrão, mas é possível expor as opções e substituir os padrões. Para ver as opções adicionais, clique em Mostrar opções avançadas.

Alinhamento

Uma série temporal é um conjunto de pontos de dados em ordem temporal. Alinhar uma série temporal é quebrar os pontos de dados em intervalos regulares de tempo, o período de alinhamento. Várias séries temporais devem ser alinhadas antes de serem combinadas.

O alinhamento é um pré-requisito para a agregação em séries temporais e é aplicado a cada série temporal individualmente. Como o alinhamento é um pré-requisito para o mapeamento dos dados, o Monitoring faz isso automaticamente, usando valores padrão. É possível modificar esses padrões usando as opções de alinhamento, Alinhador e Período de alinhamento:

Campos de opção de alinhamento

Período de alinhamento: o período de alinhamento determina o intervalo de tempo para subdividir a série temporal. Por exemplo, você pode dividir uma série temporal em blocos de um minuto ou de uma hora. Os dados em cada período são resumidos para que um único valor represente esse período. O período de alinhamento padrão é de um minuto.

Embora seja possível definir o intervalo de alinhamento para seus dados, as séries temporais podem ser realinhadas quando o intervalo de tempo exibido em um gráfico ou o nível de zoom são alterados.

Alinhador: o alinhador é uma função que determina como resumir os dados em cada período de alinhamento. Alinhadores incluem a soma, a média e assim por diante. As escolhas válidas do alinhador dependem do tipo dos dados de métrica armazenados por uma série temporal. Ou seja, a escolha do alinhador depende do MetricKind e do ValueType da série temporal.

Alguns alinhadores alinham os dados e os convertem de um tipo de métrica para outro. Para mais informações sobre os alinhadores disponíveis, consulte Aligner na referência da API.

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á-los 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

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, essas descrições são criadas para você a partir dos valores de diferentes rótulos em suas séries temporais. 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:

  • Texto simples.
  • Variáveis que representam rótulos em sua série temporal. Os rótulos disponíveis dependem da série temporal que você está representando, mas a sintaxe da variável geralmente é semelhante a esta: ${resource.labels.project_id}. A notação ${} faz com que a variável seja avaliada na descrição.

Se você fornecer apenas texto, as descrições da série temporal no gráfico serão idênticas. O uso de variáveis permite que você puxe valores de rótulos na série temporal para a descrição.

Se você souber os nomes das variáveis, poderá digitá-los manualmente no campo de modelo. É possível também selecionar variáveis dos rótulos disponíveis usando o widget + Adicionar um filtro no campo. Essa abordagem garante que a sintaxe da variável esteja correta.

A captura de tela a seguir mostra um modelo que consiste em uma string e uma única variável:

Um modelo para uma descrição simples

Na legenda do gráfico, os valores gerados a partir do modelo são mostrados em uma coluna com o cabeçalho Nome. Os valores também aparecem no cartão de informações.

A captura de tela a seguir mostra os valores de Nome e o cartão de informações resultantes do modelo.

Descrições geradas a partir de um modelo

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