Antes de Iniciar

Um mapa de calor exibe a intensidade dos valores de dados usando cores. Cada célula representa o valor agregado dos dados na interseção de duas dimensões, como tempo - serviço, ponto de extremidade - latência ou região - código de status. Isso facilita a identificação de picos e padrões que podem ser difíceis de ver em um gráfico de linha ou de barras.

Considere as seguintes informações ao configurar o Heatmap:

• Mantenha abaixo de 2.000 linhas de dados o número total de combinações X×Y que são retornadas pela consulta.

• Se a sua consulta retornar mais de 2.000 registros, aumente o intervalo de tempo ou reduza o número de campos Group By.

• Não use mais do que 5 campos de agrupamento por widget. Campos adicionais podem afetar a legibilidade e o desempenho.

• Evite o agrupamento por rótulos de alta cardinalidade, como user_id.

• Limite os campos de agrupamento para evitar resultados de visualização superlotados.

Etapa 1: Digite o nome e a descrição

Conclua as etapas a seguir:

1. Em um Painel de controle personalizado, clique em Adicionar Widget e arraste e solte o widget Mapa de calor de sua barra lateral.

2. Substitua New heatmap pelo nome do widget.

3. Insira uma descrição.

   Clique em Ícone de ação . Em seguida, selecione Adicionar descrição.

Etapa 2: Configure a consulta para definir o conjunto de dados

Conclua as etapas a seguir:

1. Clique em Ícone de ação . Em seguida, selecione o modo Editar.

2. Para Query 1, conclua as etapas a seguir:

   Selecione o tipo de dados. Os valores válidos são: Logs, Metrics, e DataPrime.

   Selecione a fonte. As opções válidas são: Priority Insights e Analyze and Alert.

   Você pode renomear a consulta. Selecione o e clique em Renomear consulta.

3. Digite a consulta.

   Quando o tipo de dados for DataPrime, insira uma consulta Dataprime no campo Query (Consulta).

   Quando o tipo de dados for Logs, insira uma consulta Lucene no campo Query (Consulta). Você pode aplicar filtros e agregações.

   Quando o tipo de dados for Metrics, especifique a métrica ou o PromQL desejado no campo Query (Consulta). Você pode aplicar filtros e agregações.

4. [Opcional] Adicione um ou mais filtros específicos ao widget para restringir os dados que são exibidos em seu medidor.

   Selecione um rótulo e seu valor correspondente.

   Os filtros são aplicados no nível do widget e funcionam juntamente com os filtros do painel. Se houver um conflito, os filtros do painel terão precedência sobre os filtros do widget.

5. Adicione uma função para agrupar e agregar seus dados para o mapa de calor.

   Selecione uma função de agregação, como Count, Sum ou Average, para calcular o valor representado pela intensidade da cor.

   Selecione Agrupar por campos. Esses campos são usados para os eixos do mapa de calor. Esses campos devem ser do tipo cadeia de caracteres, registro de data e hora ou gravidade. Se um campo for numérico, como status_code, você poderá convertê-lo em uma string em uma consulta DataPrime antes de agrupar. Por exemplo, você pode usar em sua consulta: status_code:string

Etapa 3: Configurar o widget

Conclua as etapas a seguir:

1. Clique em Ícone de ação . Em seguida, selecione o modo Editar.

2. Na seção Visual Management (Gerenciamento visual ), selecione até 5 categorias ou campos que deseja que apareçam nos eixos X e Y.

   Para controlar qual campo aparece no eixo X e qual no eixo Y, arraste e solte os campos entre Y-axis e X-axis.

   Quando um campo de registro de data e hora aparecer no eixo X, selecione como os rótulos de data e hora serão exibidos. O padrão é Auto, que ajusta o formato com base no intervalo de tempo selecionado. Os seguintes formatos estão disponíveis:

   Formatos para campos de registro de data e hora

   Formato	Exemplo
   Automático	Ajusta-se automaticamente
   DD/MM	25/04
   dd/mm	04/25
   hh:mm	14:30
   DD/MM HH:mm	25/04 14:30
   HH:mm DD/MM	14:30 25/04
   MM/DD HH:mm	04/25 14:30
   HH:mm MM/DD	14:30 04/25

3. Mostrar valores de células. Alternar para sobrepor valores numéricos dentro de cada célula. Isso é útil quando as células são maiores e legíveis.

4. Selecione uma paleta de cores predefinida para representar a intensidade dos dados. Você pode inverter a ordem das cores (claro → escuro ou escuro → claro).

   Selecione o esquema de cores usando a configuração da legenda. Ele mapeia os valores de claro → escuro por padrão. Use os limites mínimo e máximo para controlar o intervalo da escala de cores e melhorar a legibilidade dos dados com distribuições amplas ou irregulares.

5. Escolha o tipo de escala. Os valores válidos são Linear (padrão), em que as cores mudam uniformemente entre os valores, ou Logarithmic, em que a cor se aplica globalmente ao acesso Z (barra de intensidade de cor) para conjuntos de dados com amplos intervalos de valores.

6. Na seção Tooltip management (Gerenciamento de dica de ferramenta ), personalize as informações que aparecem quando você passa o mouse sobre um ponto ou cluster no mapa. Adicione a mensagem e selecione os rótulos ou atributos a serem incluídos na dica de ferramenta.

   Adicione a mensagem ou o valor que é exibido ao passar o mouse sobre um ponto ou cluster. Você pode fazer referência a campos dinâmicos, como o valor agregado, usando a sintaxe {{ }}.

   Quando um campo referenciado é resolvido com vários valores distintos em um cluster, a dica de ferramenta exibe um rótulo genérico, como "múltiplo", em vez de um valor específico. Isso indica que o cluster contém valores mistos e incentiva a busca de mais detalhes.

   Selecione os rótulos ou atributos a serem incluídos na dica de ferramenta, como serviço, aplicativo ou país.

Etapa 5: Salvar o widget

Conclua as etapas a seguir:

1. [Opcional] Defina a hora do painel do widget se você quiser usar um intervalo de tempo diferente do selecionado no Dashboard.

2. Clique em Save (Salvar) para salvar o widget.

3. [Opcional] Adicione uma ação personalizada. Para obter mais informações, consulte Uso de ações para integração com serviços de terceiros.

Ações em um mapa

Use ações rápidas para investigar dados diretamente do hetamap.

Quando você seleciona um ponto ou cluster, um menu de contexto oferece as seguintes ações:

• Open Explore: Abre os logs na visualização Explore, pré-filtrados usando o local selecionado e o contexto do cluster.

• Filter in: Adiciona o local selecionado e o contexto do valor à consulta do painel.

• Filter out: Exclui o local selecionado e o contexto de valor da consulta do painel.

• Copy name: Copia o rótulo de localização ou o par chave=valor associado ao ponto ou cluster selecionado.