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 de 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, Resource types e Metrics, como visto na captura de tela a seguir:

Listas de pesquisa para selecionar métricas e recursos

Você pode selecionar uma entrada de duas maneiras:

  • ao selecionar entradas das listas;
  • ao digitar diretamente para pesquisar as listas de candidatos correspondentes, incluindo as métricas personalizadas.

Para procurar métricas personalizadas, digite custom na caixa de pesquisa.

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 para tipos de métricas ou recursos monitorados, consulte a lista de métricas ou a lista 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:

Opções adicionais 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.

É possível 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, um painel contendo listas de critérios é exibido. 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 para 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, a captura de tela a seguir exibe um filtro no rótulo do recurso zone. O campo Filtro oferece suporte a um par de operadores de comparação para igualdade, = e =~, e um par 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 !=, poderá criar 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 sequências de filtros.

  • Se você selecionar =~ ou !=~, poderá 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 US 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. No momento, todos os critérios de filtro precisam ser atendidos. Eles constituem um AND lógico. Por exemplo, é possível usar tanto as strings de filtro starts_with e ends_with para mostrar apenas as zonas "a" na zona US:

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. Você pode 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.

Agrupar por escolhe uma função de agregação padrão com base no tipo de dado que está sendo agrupado, mas é 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. A opção sum em Agregador é o padrão.

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 marcadores. 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 marcadores não importa.

Para remover uma condição de "agrupar por", siga estas etapas:

  1. Exclua os rótulos de "Group By".
  2. Defina o método de agregação de volta para 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. Agrupar por escolhe uma função de agregação padrão com base no tipo de dado que está sendo agrupado, mas é 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.

Existem opções adicionais 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 Stackdriver faz isso automaticamente, usando valores padrão. É possível substituir 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 você altera o intervalo de tempo exibido em um gráfico ou altera o nível de zoom.

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 e do tipo de dados de métrica armazenados por uma série temporal. Ou seja, a escolha do alinhador depende de MetricKind e ValueType da série temporal.

Alguns alinhadores alinham os dados e os convertem de um tipo ou 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 em sua 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.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Stackdriver Monitoring
Precisa de ajuda? Acesse nossa página de suporte.