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:

Observação: não é possível selecionar tipos de métrica com valores String no console. Os dados com esses valores não são exibidos em gráficos nem usados em políticas de alertas. Para recuperar os dados desses tipos de métrica, é preciso usar um método na API, como timeSeries.list.

Há duas maneiras de selecionar uma entrada:

• ao selecionar entradas das listas;

  Como há menos tipos de recursos do que métricas, selecione Tipo de recurso primeiro. Se o tipo de recurso não for exibido na lista abreviada, clique em Ver tudo. Depois de selecionar o tipo de recurso, a lista de métricas é filtrada automaticamente para exibir somente as métricas relevantes.

• 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:

     

     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:

Filtro

É possível reduzir a quantidade de dados a serem representados. Para isso, especifique os critérios de filtro, aplique a agregação ou use o modo de valores atípicos. Os filtros garantem que somente séries temporais que atendam a algum conjunto de critérios sejam usadas. Se você aplicar filtros, haverá menos linhas no gráfico e isso poderá melhorar o desempenho dele.

Se você fornecer vários critérios de filtragem, o gráfico correspondente mostrará apenas as séries temporais que atendem 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 a seguir mostra os rótulos de filtro conhecidos para uma métrica específica:

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.

Observação: se um recurso monitorado não estiver gerando dados para a métrica selecionada, o menu Valores de um filtro não conterá informações para esse recurso monitorado. Por exemplo, suponha que seu projeto contenha uma instância de VM interrompida. Suponha que você crie um gráfico para o uso da CPU de uma instância de VM. Em seguida, adicione um filtro e selecione instance_id. Nesse caso, o menu Valores, que lista todas as instâncias disponíveis, está vazio. No entanto, é possível inserir o valor manualmente e selecionar Aplicar.

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, =.

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:

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:

  

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

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

  

  Observação: não é possível usar expressões regulares para filtrar o rótulo de recurso project_id.

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

  

É 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:

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

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:

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:

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 por valores de rótulo. A função define como todas as séries temporais de um grupo são combinadas em uma nova série temporal.

Para adicionar um agrupamento, clique no texto da caixa de texto Agrupar por e faça uma seleção no menu. O menu é criado dinamicamente com base nos dados da série temporal do recurso e da métrica selecionados. Agrupar e filtrar usam o mesmo conjunto de rótulos.

Quando você adiciona o primeiro rótulo, ocorre 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 determina como as séries temporais que têm o mesmo valor do rótulo são combinadas em uma única série temporal.
• O gráfico exibe uma série temporal para cada valor do rótulo listado na caixa de texto Agrupar por.

Se você agrupar por vários rótulos, o agregador combinará as séries temporais que têm o mesmo valor para os rótulos especificados.

Se você não especificar uma opção de agrupamento e especificar um agregador, essa função será aplicada a todas as séries temporais selecionadas e resultará em uma única série temporal.

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

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:

Agrupe por vários rótulos. Se você tiver várias opções de agrupamento, as séries temporais serão agrupadas por cada combinação de valores de rótulo e o agregador será 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:

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.

Quando você especifica o agrupamento ou seleciona um agregador, a série temporal representada em gráfico contém apenas os rótulos necessários, como o identificador do projeto e os 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.

Observação: se você excluir apenas os rótulos de agrupamento por, o gráfico exibirá uma única linha que representa todos os dados após a aplicação do agregador. Para desfazer o agrupamento, remova os rótulos "agrupar por" e redefina o agregador para 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:

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, 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.

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.

Você pode inserir texto e modelos simples no campo Modelo de legenda. Ao adicionar um modelo, você adiciona uma expressão que é avaliada quando a legenda é exibida.

Para adicionar um modelo, faça o seguinte:

• Clique em Inserir um modelo.
• Selecione uma entrada no menu. Depois de selecionar uma entrada, um modelo é adicionado automaticamente. Por exemplo, se você selecionar response_code, o modelo ${resource.labels.zone} será adicionado.

Por exemplo, a captura de tela a seguir mostra um modelo de legenda que contém texto simples e a expressão ${resource.labels.zone}:

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:

É possível configurar o modelo de legenda para incluir várias strings de texto e modelos. No entanto, o espaço de exibição disponível no cartão de informações é limitado.