Como selecionar métricas

Você define um gráfico especificando quais dados serão exibidos e como eles serão mostrados. Caso queira especificar métricas para exibição, clique na guia Métrica na página de definição de gráfico.

A captura de tela abaixo mostra a guia do seletor de métricas:

Definição do gráfico: guia de seleção de métricas

A métrica é especificada no campo Find resource type and metric.

Como escolher uma métrica

Para preencher o gráfico, é preciso especificar pelo menos um par de valores, o tipo de métrica (também chamado de descritor de métrica ou apenas métrica) e um tipo de recurso monitorado (ou recurso monitorado, ou apenas recurso). Um recurso monitorado especifica efetivamente um subconjunto dos dados da série temporal de um tipo de métrica.

O Monitoring tem muitos tipos de métricas e recursos predefinidos disponíveis, e você também pode especificar métricas personalizadas. Para saber mais sobre os tipos de métricas predefinidas e recursos monitorados, consulte as listas de métricas e recursos monitorados. Você também pode definir suas próprias métricas e selecioná-las para uso em gráficos. Consulte Como usar métricas personalizadas para mais informações.

Ao especificar uma métrica, a IU restringe os tipos de métricas e os recursos que você pode escolher para quem tem dados de métrica em qualquer projeto no seu espaço de trabalho. A grande maioria das métricas e dos recursos não tem dados no projeto e não aparece como opção.

Você pode especificar mais de uma métrica para um gráfico usando a opção Add metric.

O campo de especificação de métricas

Para selecionar uma métrica, use o campo Find resource type and metric para escolher um tipo de recurso e um tipo 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 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:

Opções adicionais de seleção

Com base na métrica e no recurso selecionados, sem outra configuração, a captura de tela abaixo mostra o gráfico resultante:

Gráfico com uma métrica selecionada

Este gráfico contém mais dados do que pode ser exibido, estando limitado a 300 linhas. Nessa situação, ele mostrará um aviso de que há excesso de dados a serem exibidos e recomendará o uso do modo outlier (uma das alternativas na guia Opções de exibição), o que reduz bastante o volume de dados para exibição.

No entanto, você também pode usar as outras opções de configuração de métricas para aumentar o gerenciamento do conjunto de dados. Essas técnicas tornam os gráficos mais úteis para diagnósticos e análises e aumentam o desempenho e a capacidade de resposta da própria interface de usuário.

Configurações adicionais

No restante desta seção, abordaremos configurações de métricas adicionais.

Como usar filtros

É possível reduzir o volume de dados retornados de uma métrica ao especificar critérios de filtro. Assim, serão usadas somente séries temporais que atendam a algum conjunto de critérios. 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, é 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 para um projeto:

Listas de rótulos de filtros 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 =~, além de 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 filtros 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

Com um filtro zone="starts_with("asia-east1")" ou zone=~"asia-east1.*" aplicado, é exibida apenas a série temporal com dados de uma das zonas asia-east1:

Como exibir séries temporais filtradas

Agrupamento

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

Assim como a filtragem, o agrupamento é uma maneira de reduzir a quantidade de dados manipulados. A filtragem funciona excluindo-se algumas séries temporais e agrupando-se as tarefas . 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. Quando você clica no campo Agrupar por, 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 valor de "agrupar por", 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, colocar 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 dados que está sendo agrupado, mas é possível alterar essa seleção. Consulte Agregação para ver 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 rótulos não importa.

A captura de tela abaixo mostra o gráfico resultante do agrupamento das séries temporais por zona:

Como exibir séries temporais agrupadas

Agrupe por vários rótulos. Por exemplo, se alterar a escolha por grupo de zone para severity, você verá uma série temporal para cada nível de gravidade da geração de registros. A seguinte captura de tela mostra todas as séries temporais resultantes:

Séries temporais para gravidade de registro

Se você agrupar por zone e severity, terá uma série temporal para cada par de valores de nível e gravidade e de zona. A captura de tela abaixo exibe amostra de uma dessas séries temporais:

Série temporais para zona e gravidade de registro

O fato de você ter uma série temporal para cada combinação de rótulos significa que esta técnica pode facilmente criar mais dados do que você pode colocar em um gráfico de uma só vez. Neste exemplo, o agrupamento por zone ou severity produz quantidades de dados tratáveis, mas o agrupamento por ambos resulta em mais dados do que o gráfico pode manipular, conforme visto na captura de tela a seguir:

Gráfico que mostra "Agrupar por" para dois rótulos

Como remover condições de "Group By"

Para remover uma condição de "Group By", 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 escolhas como média, máximo ou mínimo, desvio padrão, valores percentis 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 a 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 o 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 dados que está sendo agrupado, mas é possível alterar essa seleção.

Também é possível 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 para uma que reflita a função de agregação escolhida, a menos que você também use o agrupamento.

A captura de tela a seguir mostra o resultado da filtragem para essas séries temporais originadas em um contêiner do Google Kubernetes Engine e com um nome que começa com d:

Exemplo com filtragem

Se você simplesmente agregar esses dados, digamos por sum, eles serão reduzidos a uma única série temporal, que representa a soma dos valores em cada série temporal somada. A captura de tela abaixo mostra o resultado:

Exemplo com filtragem e agregação

Existem várias séries temporais originadas de contêineres com nomes que começam com d. Também podemos agrupar essas séries temporais pelo valor de um ou mais rótulos e, em seguida, agregar esses grupos resultantes. Isso resulta em uma série temporal para cada grupo. A captura de tela a seguir mostra o resultado do agrupamento da série temporal filtrada por imagem da máquina, usando a agregação de sum padrão para agrupamento:

Exemplo com filtragem

Existem opções adicionais para selecionar uma métrica. Essas opções têm valores padrão, mas você pode expor essas 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 cronológica. 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 precisam 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: 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: é uma função que determina como resumir os dados em cada período de alinhamento. Alinhadores incluem soma, média e assim por diante. As escolhas de alinhadores válidos dependem do tipo dos 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 agem sobre os dados e os convertem de um tipo de métrica para outro. Para saber mais 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á-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 para uma única série temporal.

A captura de tela a seguir mostra várias séries temporais resultantes do agrupamento de um conjunto filtrado de dados. O uso de agrupamento requer agregação: cada grupo de linhas é agregado em uma. A captura de tela a seguir mostra séries temporais agrupadas por zona:

Séries temporais filtradas, agrupadas por zona

A captura de tela a seguir mostra o resultado do uso da agregação secundária para encontrar o valor médio na série temporal agrupada:

Agregação secundária aplicada ao exemplo anterior

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 são mostradas 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 nas suas séries temporais. Como o sistema seleciona os rótulos, os resultados podem não ser úteis. 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 na 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ê solicite 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. Também é possível selecionar variáveis para os 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.

Como ocultar as opções adicionais

Para ocultar as opções Agregação secundária e Alinhador, clique em Ocultar opções avançadas na parte inferior do painel. Isso não limpa as opções selecionadas. Se você alterar ou remover o agrupamento, por exemplo, as escolhas esquecidas para essas opções ocultas poderão causar efeitos inesperados.

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.