Um histograma visualiza a distribuição de dados contínuos ao agrupar valores em intervalos e exibir sua frequência. Este tópico aborda as 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 na frequência, contagem ou outras estatísticas ao longo do eixo x. Diferentemente do gráfico de colunas, o foco é a análise estatística. Principais diferenças:
O histograma ilustra a distribuição dos dados; 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 têm pouco ou nenhum espaçamento entre si, pois os dados são contínuos. As barras do gráfico de colunas possuem espaços para separar as categorias.
Para adicionar um gráfico a um painel, siga as etapas em Add a chart to a dashboard.
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, configure as opções nos painéis Chart Type e Query and Analysis Configurations. À esquerda, defina 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 Time Series Mode. 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 configurações nos painéis Histogram Settings e Query and Analysis Configurations. À esquerda, defina 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 em 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 a configuração global de tempo do painel o afete.
-
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 Time Series Mode.
Time Scale
Escala de tempo. Aplicável apenas no Time Series Mode.
Select Time Range
Intervalo de tempo. Aplicável apenas no Time Series Mode.
Buckets
Número de intervalos (buckets).
Fora do Time Series Mode, se você definir a Coordinate Scale, o número de buckets não será obrigatório.
Rotation angle
Ângulo de rotação do texto no eixo x.
Parâmetro necessário quando Direction estiver 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 da 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 do eixo x.
Padrão: selecionado automaticamente pelo SLS.
Axis Y Field
Campo do 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 exibição dos itens da legenda no gráfico. Valores válidos: No Sorting, Ascending e Descending.
Legend Position
Posição da legenda.
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 dos dados na dica de ferramenta exibida ao passar o mouse sobre uma barra.
Valores válidos: No Sorting, Ascending e Descending.
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 Time Series Mode.
Axis X Height
Altura do eixo x.
Padrão: definido automaticamente pelo SLS.
Drag and Zoom
No Time Series Mode, 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. Vigente somente quando todos os valores do eixo y forem inferiores a este valor.
Padrão: definido automaticamente pelo SLS.
Elastic Minimum Value
Valor mínimo elástico do eixo y. Vigente somente quando todos os valores do eixo y forem superiores a 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. Example 2: Set variable substitution.
-
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 General configurations.
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 ocorrências 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. Add interaction occurrences to a dashboard for drill-down analysis.
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, você será direcionado ao Logstore especificado.