Um histograma visualiza a distribuição de dados contínuos ao agrupar valores em intervalos e exibir sua frequência. Este tópico aborda configurações básicas de histogramas e apresenta exemplos práticos.
Visão geral
O histograma utiliza barras verticais de alturas variadas para mostrar a distribuição dos dados com base em frequência, contagem ou outras estatísticas ao longo do eixo x. Diferentemente de um gráfico de colunas, o foco do histograma é a análise estatística. Principais diferenças:
O histograma ilustra a distribuição dos dados; já o gráfico de colunas compara valores entre categorias.
No histograma, o eixo x representa dados numéricos contínuos (comprimento, peso, tempo). No gráfico de colunas, o eixo x exibe dados categóricos (métodos de requisição).
As barras do histograma possuem pouco ou nenhum espaçamento entre si, pois os dados são contínuos. No gráfico de colunas, as barras têm espaços para separar as categorias.
Para adicionar um gráfico a um painel, siga as etapas em Adicionar um gráfico a um painel.
Exemplos de configuração
Histograma básico
-
Faça login no console do Simple Log Service. Na seção Projects, clique no projeto desejado.
No painel de navegação à esquerda, escolha . Na lista Dashboard, clique no painel desejado. No canto superior direito da página do painel, clique em Edit. No modo de edição, escolha .
-
À direita, defina as opções nos painéis Chart Type e Query and Analysis Configurations. À esquerda, configure o intervalo de tempo, selecione um Logstore, insira sua consulta e clique em Apply para visualizar o gráfico.
Na seção Query and Analysis Configurations, à direita, defina Axis X Field como
te Axis Y Field comoc.Se o eixo x representar tempo, ative o Modo de Série Temporal. Nesse modo, o Simple Log Service formata automaticamente os valores de tempo e exibe a distribuição dos dados ao longo do tempo. A instrução de consulta a seguir calcula o número de registros em intervalos de 30 minutos:
* | select __time__ - __time__ % 1800 as t, COUNT(*) as c group by t order by t asc limit 10000
Empilhamento multidimensional
-
Faça login no console do Simple Log Service. Na seção Projects, clique no projeto desejado.
No painel de navegação à esquerda, escolha . Na lista Dashboard, clique no painel desejado. No canto superior direito da página do painel, clique em Edit. No modo de edição, escolha .
-
À direita, ajuste as opções nos painéis Histogram Settings e Query and Analysis Configurations. À esquerda, configure o intervalo de tempo, selecione um Logstore, insira sua consulta e clique em Apply para visualizar o gráfico.
Ative o Time Series Mode e selecione charts-demo como Logstore. Na seção Histogram Settings, defina Direction como Vertical, Time Scale como Relative time, Time Selection como 1 Minute, Merge Columns como Stacked e Transparency como 85. Na seção Query and Analysis Configurations, configure Axis X Field como t e selecione GET e POST para Axis Y Field.
A instrução de consulta abaixo calcula a quantidade de requisições GET e POST por minuto:
* | select __time__ - __time__ % 60 as t, count_if(request_method = 'GET') as GET, count_if(request_method = 'POST') as POST group by t order by t asc limit 1000
Configurações gerais
Estas configurações aplicam-se a todo o histograma.
-
Configurações básicas
Parâmetro
Descrição
Title
Título do gráfico.
Display Title
Exibe o título do gráfico quando ativado.
Display Border
Mostra uma borda ao redor do gráfico quando ativado.
Display Background
Aplica uma cor de fundo ao gráfico quando ativado.
Display Time
Exibe o horário da consulta no gráfico quando ativado.
Fixed Time
Fixa o intervalo de tempo da consulta e análise, impedindo que seja afetado pelo tempo global do painel.
-
Configurações padrão
Parâmetro
Descrição
Format
Formato de exibição dos números.
Unit
Unidade de medida dos números.
Number of Digits after Decimal Point
Número de casas decimais.
Display Name
Nome de exibição do campo.
Este nome substitui todos os outros nomes de campo no gráfico. Para renomear um campo específico, use a configuração de campos.
Color Scheme
Esquema de cores do gráfico.
-
Built-in: Usa as cores predefinidas.
-
Solid: Usa uma única cor sólida.
-
Threshold: Colore o gráfico conforme os limiares configurados.
-
-
Configurações do histograma
Parâmetro
Descrição
Direction
Orientação do histograma. Valores válidos: Vertical e Horizontal.
Coordinate Scale
Intervalo do eixo x. Aplicável apenas fora do Modo de Série Temporal.
Time Scale
Escala de tempo. Aplicável apenas no Modo de Série Temporal.
Select Time Range
Intervalo de tempo. Aplicável apenas no Modo de Série Temporal.
Buckets
Número de intervalos (buckets).
Fora do Modo de Série Temporal, se você definir a Coordinate Scale, o número de buckets não é obrigatório.
Rotation angle
Ângulo de rotação do texto no eixo x.
Parâmetro necessário quando Direction está definido como Vertical.
Merge Columns
Com múltiplos campos no eixo Y, use a configuração Merge Columns para definir como as barras serão empilhadas.
-
No: Cada barra começa na base do gráfico.
-
Yes: As barras são mescladas em uma só.
-
Stacked: As barras são empilhadas sem sobreposição.
Line Width
Espessura das bordas das barras.
Transparency
Nível de transparência do histograma.
Gradient Mode
Modo de gradiente do histograma.
-
Transparency: Aplica um gradiente baseado na cor da barra e na configuração de Transparency.
-
No Gradient: Preenche as barras com uma cor sólida.
-
-
Configurações de consulta e análise
Parâmetro
Descrição
Axis X Field
Campo usado no eixo x.
Padrão: selecionado automaticamente pelo SLS.
Axis Y Field
Campo usado no eixo y. Especifique vários campos para gerar um histograma agrupado.
Padrão: selecionado automaticamente pelo SLS.
-
Configurações da legenda
Parâmetro
Descrição
Display Legend
Ative a chave Display Legend para exibir a legenda.
Sorting Method
Ordem de classificação dos itens da legenda.
Legend Position
Posição da legenda no gráfico.
Actions
Comportamento ao clicar em um item da legenda.
-
Single: Exibe apenas os dados do item clicado.
-
Switch: Alterna a visibilidade do item clicado.
Maximum width (height)%
Largura e altura máximas da legenda.
-
-
Configurações de dica de ferramenta
Parâmetro
Descrição
Sorting Method
Ordem de classificação dos dados na dica de ferramenta.
Aplicável ao passar o mouse sobre uma barra.
Display Mode
Modo de exibição dos dados na dica de ferramenta.
Aplicável ao passar o mouse sobre uma barra.
-
Eixo x
Parâmetro
Descrição
Display Axis X
Ative a chave Display Axis X para exibir o eixo x.
Axis X Title
Título do eixo x.
Format
Formato de hora para o eixo x. Aplicável apenas no Modo de Série Temporal.
Axis X Height
Altura do eixo x.
Padrão: definido automaticamente pelo SLS.
Drag and Zoom
No Modo de Série Temporal, após arrastar para ampliar, atualize o tempo global ou o tempo do gráfico atual.
-
Eixo y
Parâmetro
Descrição
Display Axis Y
Ative a chave Display Axis Y para exibir o eixo y.
Axis Y Title
Título do eixo y.
Axis Y Position
Posição do eixo y.
Axis Y Width
Largura do eixo y.
Padrão: definido automaticamente pelo SLS.
Maximum Value
Valor máximo do eixo y.
Padrão: definido automaticamente pelo SLS.
Minimum Value
Valor mínimo do eixo y.
Padrão: definido automaticamente pelo SLS.
Elastic Maximum Value
Valor máximo elástico do eixo y. Vigora somente quando todos os valores do eixo y forem menores que este valor.
Padrão: definido automaticamente pelo SLS.
Elastic Minimum Value
Valor mínimo elástico do eixo y. Vigora somente quando todos os valores do eixo y forem maiores que este valor.
Padrão: definido automaticamente pelo SLS.
Axis Y ID
ID do eixo Y. O valor pode ser qualquer string. Nas General Configurations, esse campo geralmente não tem efeito. Para definir múltiplos eixos Y, configure-os em Field Configuration. Eixos Y com IDs diferentes aparecem como eixos separados.
O ID do eixo Y tem precedência sobre a configuração de unidade nas Standard Configurations. Dois eixos Y com a mesma unidade são mesclados em um só. Dois eixos Y com a mesma unidade, mas IDs diferentes, são exibidos separadamente.
-
Substituição de variáveis
Parâmetro
Descrição
Variable substitution
Adiciona um filtro do tipo variável ao gráfico. Após a configuração nas General configurations, um filtro aparece no canto superior esquerdo do gráfico. Ao selecionar um valor, o Simple Log Service substitui a variável na instrução de consulta e reexecuta a análise. Exemplo 2: Definir substituição de variáveis.
-
Documentação
Parâmetro
Descrição
Add Documentation Link
Adiciona um link de documentação no canto superior direito do gráfico.
Configuração de campos
As configurações de campo aplicam definições personalizadas de visualização a um resultado de consulta ou coluna de dados específica. Para descrições dos parâmetros, consulte Configurações gerais.
Por exemplo, personalize a cor da barra para um campo específico do eixo y. A > GET indica a configuração do campo GET da consulta A. A > POST indica a configuração do campo POST da consulta A.
Interações
Configure eventos de interação para um resultado de consulta ou coluna de dados para habilitar a análise detalhada (drill-down). As interações suportadas incluem Open Logstore, Open Saved Search, Open Dashboard, Open Trace Analysis, Open Trace Details e Create Custom HTTP URL. Consulte Adicionar eventos de interação a um painel para análise detalhada.
Por exemplo, A > GET configura uma interação para o campo GET da consulta A. Se a interação para o campo GET estiver definida como Open Logstore, ao clicar em um valor GET no histograma e depois em Open Logstore, o sistema redireciona você ao Logstore especificado.