Selecionar e configurar métricas

Neste documento, descrevemos os campos que você define ao configurar a condição de uma política de alertas. Normalmente, você cria uma política de alertas quando quer receber notificações quando os dados de séries temporais, como o uso da CPU de uma máquina virtual, atenderem a determinadas condições. Este conteúdo não se aplica a políticas de alertas baseadas em registros. Para informações sobre políticas de alertas com base em registros, que informam quando uma mensagem específica aparece nos registros, consulte Como monitorar os registros.

Selecionar os dados a serem exibidos

Para especificar as métricas a serem exibidas ao criar uma política de alertas, especifique os valores de uma métrica e um tipo de recurso:

• O campo metric identifica as medidas a serem coletadas de um recurso monitorado. Ele inclui uma descrição do que está sendo medido e como as medições são interpretadas. Métrica é uma forma abreviada de tipo de métrica. Para informações conceituais, consulte Tipos de métricas.

• O campo type type especifica de qual recurso os dados de métricas são capturados. ostipo de recurso às vezes é chamado detipo de recurso monitorado ou orecurso de dados. Para informações conceituais, consulte Recursos monitorados.

O Monitoring tem muitos tipos de métricas e recursos monitorados predefinidos disponíveis, e também é possível criar métricas personalizadas:

• Para informações sobre os tipos de métricas predefinidas, consulte a lista de métricas. Cada documento lista métricas por tipo de serviço. Por exemplo, a página Métricas do Google Cloud contém uma série de tabelas, uma para cada serviço do Google Cloud.

• Para mais informações sobre os tipos de recursos monitorados disponíveis, consulte Lista de recursos monitorados.

• Para mais informações sobre como definir suas próprias métricas, consulte Como usar métricas personalizadas.

O Cloud Monitoring está atualizando a interface para criar uma política de alertas. Selecione a guia que corresponde à interface que você está usando.

Interface legada

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

• inserindo um filtro do Monitoring; Um filtro do Monitoring é uma expressão que o Monitoring usa para identificar a série temporal a ser monitorada. O filtro "Monitoramento" a seguir resulta no gráfico que exibe a contagem de entradas de registro de todas as instâncias de máquina virtual do Google Cloud na zona us-east1-b:

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

  Para inserir um filtro de Monitoramento, 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. Digite um filtro do Monitoring 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:

Interface na prévia

Para configurar a condição de uma política de alertas, use a API Cloud Monitoring ou o Console do Google Cloud. Se você optar por usar o Console do Cloud, selecione como especificar a série temporal a ser monitorada:

• Modo básico

  Use o modo básico se você quiser configurar uma condição que monitore uma métrica de um recurso específico e não quiser usar a MQL. Por padrão, os menus listam somente as métricas para as quais os dados foram recebidos. É possível ativar a exibição de todas as métricas do Google Cloud.

  Depois de selecionar o recurso e a métrica, a próxima etapa é especificar os filtros.

• Modo MQL

  Use o modo MQL quando quiser usar MQL para descrever a condição ou monitorar uma proporção de métricas.

  Para informações sobre como usar a MQL, consulte Como usar a linguagem de consulta do Monitoring.

  A próxima etapa é configurar o acionador de condição.

• Modo de filtro direto

  Use o modo de filtro direto quando tiver interesse em algum dos seguintes itens:

  • Monitorar objetivos de nível de serviço (SLO).
  • Configurar um alerta para métricas personalizadas que você ainda não tem dados
  • Monitorar a contagem de processos em execução em máquinas virtuais (VMs).
  • Verificar a sintaxe de uma instrução de filtro a ser incluída em um comando da API.

  Ao usar o modo de filtro direto, para selecionar a série temporal, insira um filtro do Monitoring. Por exemplo, o seguinte filtro do Monitoring no gráfico que exibe uma contagem de processos com nome que inclui nginx:

  select_process_count("monitoring.regex.full_match(\".*nginx.*\")")
  resource.type="gce_instance"
  

  O próximo filtro seleciona a série temporal Disk write bytes para as VMs do Compute Engine localizadas na zona us-central1-a:

  metric.type="compute.googleapis.com/instance/disk/write_bytes_count"
  resource.type="gce_instance"
  resource.label."zone"="us-central1-a"
  

  Para informações sobre sintaxe, consulte os documentos a seguir:

  • Filtros de monitoramento
  • Como recuperar dados do SLO
  • Filtros de integridade do processo

  Depois de especificar um filtro do Monitoring, a próxima etapa é especificar as opções de transformação de dados.

No restante desta página, usamos a terminologia usada pela interface baseada em menus do Console do Cloud. No entanto, as informações conceituais são aplicáveis a todas as abordagens que podem ser usadas para criar uma política de alertas.

Filtrar os dados selecionados

Interface legada

É possível reduzir a quantidade de dados monitorados especificando os critérios de filtro ou aplicando a agregação. Os filtros garantem que somente séries temporais que atendam a algum conjunto de critérios sejam usadas. Se você aplicar filtros, haverá menos séries temporais para avaliar e isso poderá melhorar o desempenho do alerta.

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. No momento, 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:

Interface na prévia

É possível reduzir a quantidade de dados monitorados especificando os critérios de filtro ou aplicando a agregação. Os filtros garantem que somente séries temporais que atendam a algum conjunto de critérios sejam usadas. Se você aplicar filtros, haverá menos séries temporais para avaliar e isso poderá melhorar o desempenho do alerta.

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.

Para adicionar um filtro, clique em Adicionar filtro, conclua a caixa de diálogo e clique em Concluído. Na caixa de diálogo, use o campo Filtro para selecionar o critério de 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. Depois de selecionar o critério de filtro, conclua o filtro selecionando o operador de comparação e o valor. Cada linha na tabela a seguir lista um operador de comparação, o respectivo significado e um exemplo:

Operador	Significado	Exemplo
=	Igualdade	resource.labels.zone = "us-central1-a
!=	Desigualdade	resource.labels.zone != "us-central1-a"
=~	Igualdade da regular expression2	monitoring.regex.full_match("^us.*")
!=~	Desigualdade da expressão regular2	monitoring.regex.full_match("^us.*")
starts_with	O valor começa com	resource.labels.zone = starts_with("us")
ends_with	O valor termina com	resource.labels.zone = ends_with("b")
has_substring	O valor contém	resource.labels.zone = has_substring("east")
one_of	Uma	resource.labels.zone = one_of("asia-east1-b", "europe-north1-a")
!starts_with	O valor não começa com	resource.labels.zone != starts_with("us")
!ends_with	O valor não termina com	resource.labels.zone != ends_with("b")
!has_substring	O valor não contém	resource.labels.zone != has_substring("east")
!one_of	O valor não é um de	resource.labels.zone != one_of("asia-east1-b", "europe-north1-a")

Transformar dados

Depois que a série temporal é selecionada, as próximas etapas são especificar como cada série temporal é processada, também conhecida como alinhamento, e como as séries temporais alinhadas são combinadas. Se você usar a interface legada ou a API Cloud Monitoring, use os campos de agregação para especificar como as séries temporais serão transformadas.

O restante desta página descreve brevemente essas opções. Para ver uma explicação detalhada, consulte Como manipular séries temporais.

Alinhar série temporal

O alinhamento é o processo de conversão de uma série temporal recebida pelo Monitoring em uma nova série temporal com pontos de dados espaçados por um período fixo de tempo. O processo de alinhamento consiste nas seguintes etapas:

1. Divisão de uma série temporal em um conjunto de intervalos de comprimento fixo.
2. Coletar todos os pontos de dados recebidos em cada intervalo e aplicar uma função para combinar esses pontos de dados. Por exemplo, é possível selecionar essa função para calcular a média de todas as amostras.
3. associação de um carimbo de data/hora com o valor computado na etapa anterior e, em seguida, adicionar o par à série temporal alinhada.

Para ver uma discussão geral sobre alinhamento, consulte Alinhamento: regularização dentro da série.

Interface legada

Ao criar uma condição em uma política de alertas, especifique os parâmetros de alinhamento. Se você usar o Console do Google Cloud, serão fornecidos valores padrão para esses parâmetros:

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

Interface na prévia

Ao criar uma condição em uma política de alertas, especifique os parâmetros de alinhamento. Se você usar o Console do Google Cloud, serão fornecidos valores padrão para esses parâmetros:

• Janela de rolagem: este campo é um intervalo de lookback de um determinado momento. Por exemplo, se esse valor for de cinco minutos, então, às 13h, as amostras recebidas entre 12h55 e 13h precisarão ser alinhadas. Ats 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 visualizado como uma janela deslizante que parece estar no passado. Para uma discussão mais envolvida sobre esse campo, consulte O período de alinhamento e a duração.

• Função de janela contínua: o campo especifica a função usada para combinar todos os pontos de dados no intervalo de lookback. Na API Cloud Monitoring, esse campo é chamado de alinhador. Para mais informações sobre as funções disponíveis, consulte Aligner na referência da API. Algumas das funções do alinhador alinham os dados e convertem de um tipo ou tipo de métrica para outro. Para uma explicação detalhada, consulte Tipos, tipos e conversões.

Combinar série temporal

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

Interface legada

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. O tipo de dados que está sendo exibido determina o agregador padrão; No entanto, é possível alterar essa função.
• 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 do rótulo 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:

Interface na prévia

Para acessar as opções para combinar séries temporais, clique em Mostrar mais na seção Na série temporal.

Para combinar séries temporais por valor de rótulo, clique no texto Agrupar por série temporal por e faça uma seleção no menu. O menu é construído dinamicamente com base na série temporal que você selecionou.

Quando você adiciona o primeiro rótulo, ocorre o seguinte:

• Um erro é exibido porque o campo Agregação da série temporal está definido como nenhum. Para resolver o erro, selecione uma função que seja usada para combinar as séries temporais com o mesmo valor de rótulo.

• O gráfico exibe uma série temporal para cada valor do rótulo listado no campo Agrupar por série temporal por.

Se você não especificar uma opção de agrupamento e especificar uma função de agregação, essa função será aplicada à série temporal selecionada e resultará em uma única série temporal.

Agrupe por vários rótulos. Quando você tem várias opções de agrupamento, o agregador é aplicado ao conjunto de séries temporais que têm os mesmos valores dos rótulos selecionados.

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

Interface legada

Quando você tem várias séries temporais que já representam agregações, é possível reduzir todas as séries temporais no gráfico para uma única série temporal escolhendo um Agregador secundário. Por exemplo, se você agrupar os dados por zona, o gráfico mostrará uma série temporal para cada zona. Para criar um gráfico com uma única série temporal, use os campos de agregação secundários.

Interface na prévia

Se você tiver várias séries temporais exibidas após o Transformação de dados principal Se você quiser que a política de alertas monitore uma única série temporal, use o seguinte:Transformação de dados secundários.