Como filtrar painéis adicionando filtros e gráficos usando substituição de variáveis - Simple Log Service: Central de Documentação do Alibaba Cloud

As variáveis permitem filtrar gráficos individuais ou painéis inteiros sem modificar as instruções de consulta subjacentes. Elas usam a sintaxe ${{variable_name|default_value}} ou ${{variable_name|default_value|prefix}} para ajustar dinamicamente os placeholders nas suas instruções de consulta. É possível filtrar dados em todo um painel ou dentro de um único gráfico.

Filtrar um painel inteiro

Tipos de filtro

Cada gráfico é alimentado por uma instrução de consulta. Os filtros modificam as condições da consulta ou substituem variáveis de placeholder para todos os gráficos em um painel. O Simple Log Service (SLS) oferece suporte a três tipos de filtros:

Filter: Utiliza pares chave-valor de campos de log para filtrar dados. Esse tipo pesquisa nos resultados da consulta por logs que contêm ou não contêm um par Key:Value específico. Por exemplo, ao visualizar page views (PVs) para diferentes métodos de requisição, adicione um filtro para alternar entre os métodos usando itens de lista dinâmica.
Variable Replacement: Primeiro, defina uma variável na instrução de consulta do seu gráfico e, em seguida, adicione um filtro para substituí-la dinamicamente por um valor selecionado. Por exemplo, visualize PVs por intervalos de 10, 60 ou 600 segundos.
Metric Filter: Refina as métricas ingeridas com base em seus rótulos e valores correspondentes. Caso você especifique múltiplas condições de filtro, elas serão combinadas com um operador lógico AND.

Tipo de filtro

Etapa 1: Adicionar um gráfico a um painel

Criar um painel.
No painel, entre no modo de edição e clique em Add > Add Chart.
À esquerda, configure o intervalo de tempo da consulta, o Logstore e a instrução de consulta. À direita, selecione um tipo de gráfico, como uma tabela. Clique em Apply para visualizar o gráfico e, depois, clique em OK para salvá-lo.

A seguinte instrução de consulta recupera o número de PVs por minuto:
```
* | SELECT date_format(__time__ - __time__ % 60, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time
```

Etapa 2: Adicionar um filtro do tipo Filter

No painel, entre no modo de edição e clique no ícone no canto superior direito.

No painel Filter, configure as definições e clique em OK.

Abaixo está um exemplo de instrução de consulta usada para a visualização do item de lista dinâmica:

*|select distinct request_method

Neste exemplo, defina Key como request_method, selecione website_log como Logstore e defina o intervalo de tempo como 15min (Last 15 minutes). A visualização do item de lista dinâmica mostra GET, POST, DELETE e PUT.

Parâmetros para um filtro do tipo Filter

Parâmetro	Descrição
Name	O nome do filtro.
Type	Filter: Usa um campo e seu valor para filtrar dados. Essa condição é prefixada à instrução de consulta usando o operador AND ou NOT. O operador padrão é AND. AND: `Value AND [search query] \| [sql query]` NOT: `Value NOT [search query] \| [sql query]` É possível adicionar vários valores na seção Static List Items.
Global Filtering	Se você ativar o Global Filtering, o filtro buscará o valor especificado em todos os campos, sem exigir uma chave. Se você desativar o Global Filtering, o filtro buscará o valor especificado apenas na chave definida.
Key Value	Em Key Value, configure o nome do campo de destino.
Alias	O alias do filtro.
Automatic Filtering	Ao ativar o Automatic Filtering, o filtro oculta automaticamente da lista de seleção os valores que não existem na fonte de dados.
Display Configuration	Configura a aparência do filtro. Ative Display Title para adicionar um título ao filtro. Ative Display Border para adicionar uma borda ao filtro. Ative Display Background para adicionar um fundo branco ao filtro.
Query Method	O operador usado para unir a condição do filtro. Use o AND Operator ou o NOT Operator.
Static List Items	Especifica os valores estáticos para o Key Value definido. Clique em + para adicionar vários valores. Se você ativar Select by Default para um valor, esse valor será usado para filtragem por padrão sempre que você abrir o painel.
Add Dynamic List Item	Ative Add Dynamic List Item para preencher dinamicamente o filtro com valores para o Key Value especificado. Esses itens são resultados de uma instrução de consulta, que podem mudar conforme o intervalo de tempo selecionado. Após ativar Add Dynamic List Item, configure os seguintes parâmetros. Select Project: Selecione o projeto que deseja consultar. Select Logstore: Selecione o Logstore que deseja consultar. Inherit Filter Condition: Ao ativar a opção Inherit Filter Condition, a filtragem herda as condições de filtro existentes no painel. Query and Analysis: Insira uma instrução de consulta e defina um intervalo de tempo para buscar os valores dinâmicos. Dynamic List Item Preview: Visualize os resultados da consulta.

Ajuste o layout da página, clique em Save e, na caixa de diálogo Save Dashboard, clique em Confirm.

Etapa 3: Verificar os resultados

No painel, selecione GET e PUT na lista suspensa request_method para consultar os PVs dos métodos GET e PUT. Essa ação executa a seguinte instrução de consulta:

(*)and (request_method: GET OR request_method: PUT)| SELECT date_format(__time__ - __time__ % 60, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time

Tipo Variable replacement

Etapa 1: Definir uma variável na consulta do gráfico

Criar um painel.
No painel, entre no modo de edição e clique em Add > Add Chart.
À esquerda, configure o intervalo de tempo da consulta, o Logstore e uma instrução de consulta que inclua uma variável. À direita, selecione um tipo de gráfico. Clique em Apply para visualizar o gráfico e, depois, clique em OK para salvá-lo.

A seguinte instrução de consulta recupera o número de PVs em diferentes intervalos de tempo. A sintaxe ${{interval|60}} define uma variável chamada interval com um valor padrão de 60.
```
* | SELECT date_format(__time__ - __time__ % ${{interval|60}}, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time
```

Etapa 2: Adicionar um filtro de substituição de variável

No painel, entre no modo de edição e clique no ícone no canto superior direito.

No painel Filter, configure as definições e clique em OK.

Nota

O Key Value deve corresponder ao nome da variável definida na instrução de consulta. Neste exemplo, o valor é interval.
Use Static List Items para configurar os valores da variável.

Neste exemplo, defina Name como PV Filter. Para Static list item, adicione os valores de variável 10, 60 e 600, que representam segundos. Em seguida, clique em OK.

Parâmetros para um filtro do tipo Variable Replacement

Parâmetro	Descrição
Name	O nome do filtro.
Type	Variable Replacement: Define uma variável e seus possíveis valores para um filtro. Se um gráfico no painel contiver um placeholder para essa variável, o filtro substituirá automaticamente o placeholder pelo valor selecionado. Configure vários valores na seção Static List Items.
Key Value	Configure uma variável em Key Value. Nota O nome da variável deve corresponder ao placeholder na instrução de consulta do gráfico.
Alias	O alias do filtro.
Display Configuration	Configura a aparência do filtro. Ative Display Title para adicionar um título ao filtro. Ative Display Border para adicionar uma borda ao filtro. Ative Display Background para adicionar um fundo branco ao filtro.
Show Component Types	O tipo de controle de entrada para o filtro: Enter a value: Uma caixa de texto que permite aos usuários inserir qualquer valor. Drop-down List: Uma lista de opções predefinidas.
Static List Items	Especifica os valores estáticos para o Key Value definido. Clique em + para adicionar vários valores. Se você ativar Select by Default para um valor, esse valor será usado para filtragem por padrão sempre que você abrir o painel.
Add Dynamic List Item	Ative Add Dynamic List Item para preencher dinamicamente o filtro com valores para o Key Value especificado. Esses itens são resultados de uma instrução de consulta, que podem mudar conforme o intervalo de tempo selecionado. Após ativar Add Dynamic List Item, configure os seguintes parâmetros. Select Project: Selecione o projeto que deseja consultar. Select Logstore: Selecione o Logstore que deseja consultar. Inherit Filter Condition: Ao ativar a opção Inherit Filter Condition, a filtragem herda as condições de filtro existentes no painel. Query and Analysis: Insira uma instrução de consulta e defina um intervalo de tempo para buscar os valores dinâmicos. Dynamic List Item Preview: Visualize os resultados da consulta.

Ajuste o layout da página, clique em Save e, na caixa de diálogo Save Dashboard, clique em Confirm.

Etapa 3: Verificar os resultados

No painel, em PV Filter, defina interval como 10 para consultar os PVs a cada 10 segundos.
Essa ação executa a seguinte instrução de consulta:
```
* | SELECT date_format(__time__ - __time__ % 10, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time
```
No painel, em PV Filter, defina interval como 60 para consultar os PVs a cada 60 segundos.
Essa ação executa a seguinte instrução de consulta:
```
* | SELECT date_format(__time__ - __time__ % 60, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time
```

Filtro de métrica

Ingira métricas. Por exemplo, colete dados de monitoramento de host.

Adicione um filtro. Após ingerir dados do host, o SLS cria automaticamente um painel chamado Host Monitoring. No painel Host Monitoring, entre no modo de edição e clique no ícone 仪表盘过滤器-过滤器图标 no canto superior direito. No painel Filter, configure as definições e clique em OK.

Para Key, selecione Host.

Parâmetros para um Metric Filter

Parâmetro	Descrição
Name	O nome do filtro.
Type	Metric Filter: Adiciona dinamicamente um rótulo e um valor para filtragem. Após adicionar um Metric Filter, filtre manualmente as métricas em um Metricstore por rótulo e valor.
Key Value	Um identificador exclusivo para o filtro.
Alias	O alias do filtro.
Display Configuration	Configura a aparência do filtro. Ative Display Title para adicionar um título ao filtro. Ative Display Border para adicionar uma borda ao filtro. Ative Display Background para adicionar um fundo branco ao filtro.
Select Project	Selecione o projeto que deseja consultar.
Select Metricstore	Selecione o Metricstore que deseja consultar.

Filtre o painel. Na parte superior da página do painel, selecione um rótulo e um valor na lista suspensa.

Filtrar um único gráfico com substituição de variável

Configure a Variable Replacement para um único gráfico. O SLS adiciona um filtro no canto superior esquerdo desse gráfico, permitindo refinar seus dados de forma independente. O exemplo a seguir configura uma tabela para visualizar PVs em diferentes intervalos de tempo.

Etapa 1: Configurar a substituição de variável

No lado esquerdo da página de edição do gráfico, configure o intervalo de tempo da consulta, o Logstore e uma instrução de consulta que inclua uma variável.

A seguinte instrução de consulta recupera os PVs para diferentes intervalos de tempo. A sintaxe ${{date|60}} define uma variável chamada date com um valor padrão de 60.
```
* | select __time__ - __time__ % ${{date | 60}} as time, COUNT(*) as pv, avg(request_time) as duration, request_method GROUP BY time, request_method order by time limit 1000
```
Após executar a consulta, defina o Logstore como website_log e o intervalo de tempo como 15 Minutes(Relative). O resultado da consulta exibe o PV e o tempo médio de requisição agrupados por tempo e método de requisição em uma tabela.
Configure a substituição de variável.
1. No lado direito da página de edição do gráfico, selecione Table como tipo de gráfico e clique em Variable Replacement > Add Variable Replacement.
2. Na caixa de diálogo Variable Replacement, defina Variable Key como date e Display Name como time. Para os valores da variável, defina o Display Name como min e hour, com valores de substituição correspondentes de 60 e 3600.
No canto superior direito da página, clique em OK. Em seguida, clique em Save. Na caixa de diálogo Save Dashboard, clique em Confirm.

Etapa 2: Filtrar o gráfico

Após salvar as configurações, um filtro aparece no canto superior esquerdo do gráfico. Ao selecionar um valor no filtro, o SLS reexecuta a consulta com o novo valor. Por exemplo, se você selecionar hour, o SLS executa a seguinte instrução de consulta:

(*)| select __time__ - __time__ % 3600 as time, COUNT(*) as pv, avg(request_time) as duration, request_method GROUP BY time, request_method order by time limit 1000

Usar variáveis com eventos de interação

Ao configurar Interaction Occurrences para um gráfico, também é possível definir uma variável. Quando a interação é acionada, o sistema atualiza automaticamente a variável com o valor proveniente da interação. Isso vincula dinamicamente os gráficos para análise detalhada (drill-down). Para um exemplo detalhado, consulte Exemplos de configuração.

Na janela de configuração Open Logstore, selecione o Logstore de destino, como website_log. Na caixa de entrada Filter query, clique em Add Variable para referenciar uma variável. Por exemplo, na consulta * | SELECT date_format(__time__ - __time__ % 60, '%H:%i:%s') as "${time}", ${time} é a variável definida na ocorrência de interação.

Uso avançado: Usar variáveis com prefixo

Importante

Melhore a filtragem incluindo um prefixo nas suas variáveis, usando a sintaxe ${{variable_name|default_value|prefix}}.

Se nenhum valor for selecionado para a variável, a consulta será executada usando o valor padrão.
Se um valor for selecionado, a consulta combinará o prefixo e o valor selecionado.

Filtrar um painel: Filtragem por método HTTP

Variável

Formato da variável: ${{method_filter|http_method in ('GET','POST')|http_method =}}
Instrução de consulta: (*)|select status, count(1) as err_count where ${{method_filter|request_method in ('GET','POST')|request_method =}} and status>=400 group by status
- Se nenhum valor for selecionado: A consulta analisa por padrão a distribuição de erros (código de status 400 ou superior) para requisições GET e POST. A consulta efetiva é:
  
  (*)|select status, count(1) as err_count where request_method in ('GET','POST') and status>=400 group by status
- Se 'DELETE' for selecionado: A consulta passa a analisar erros para o método DELETE. A consulta efetiva é:
  
  (*)| select status, count(1) as err_count where request_method ='DELETE' and status>=400 group by status

Procedimento

Configure o gráfico. Na página de edição do gráfico, configure o intervalo de tempo, o Logstore e uma instrução de consulta que inclua a variável. Selecione Table como tipo de gráfico. Clique em Apply para visualizar e, em seguida, clique em OK para salvar.

A instrução de consulta de exemplo é * | select status, count(1) as err_count where ${{method_filter|request_method in ('GET','POST')|request_method =}} and status>=400 group by status, onde ${{method_filter|...|...}} é a sintaxe da variável. Defina a fonte de dados como website_log.
Configure o filtro de variável. No painel Filter, adicione valores à lista suspensa para a variável method_filter.

Defina Type como Variable Replacement. Na seção de itens de lista estática, adicione 'GET', 'POST', 'PUT' e 'DELETE'. Em seguida, clique em OK.
Filtre o painel. Clique no filtro e selecione 'DELETE'. O painel é atualizado e exibe estatísticas baseadas na instrução de consulta (*)| select status, count(1) as err_count where request_method ='DELETE' and status>=400 group by status.

Filtrar um gráfico: Filtragem por limiar de tempo de requisição

Variável

Formato da variável: ${{slow_query|request_time>50|request_time>}}
Instrução de consulta: (*)| select request_uri, avg(request_time) as avg_time where ${{slow_query|request_time>50|request_time>}} group by request_uri order by avg_time desc
- Se nenhum valor for selecionado: A consulta busca por padrão APIs com tempo de requisição superior a 50 ms, ordenadas pelo tempo médio. A consulta efetiva é:
  
  (*)| select request_uri, avg(request_time) as avg_time where request_time>50 group by request_uri order by avg_time desc
- Se 1000 for selecionado: A consulta é ajustada para analisar APIs lentas que levam mais de 1.000 ms. A consulta efetiva é: (*)| select request_uri, avg(request_time) as avg_time where request_time>1000 group by request_uri order by avg_time desc

Procedimento

Configure o gráfico. Na página de edição do gráfico, configure o intervalo de tempo, o Logstore e uma instrução de consulta que inclua a variável.

À direita, selecione Table como tipo de gráfico. No painel inferior esquerdo, edite a instrução de consulta para incluir a variável. Na seção Variable Replacement à direita, configure a chave da variável e o nome de exibição. Ao terminar, clique em OK.
Configure a substituição de variável. No lado direito da página de edição do gráfico, clique em Variable Replacement. Na caixa de diálogo Variable Replacement, adicione valores para a variável slow_query.

Na lista de valores da variável, adicione os seguintes itens: nome de exibição 50ms (valor de substituição 50, definido como padrão), 100ms (valor de substituição 100), 200ms (valor de substituição 200), 300ms (valor de substituição 300), 400ms (valor de substituição 400), 500ms (valor de substituição 500) e 1000ms (valor de substituição 1000). Em seguida, clique em OK.
Filtre o gráfico. Clique no filtro no canto superior esquerdo do gráfico. Ao selecionar 1000ms, o gráfico é atualizado e exibe estatísticas baseadas na instrução de consulta (*)| select request_uri, avg(request_time) as avg_time where request_time>1000 group by request_uri order by avg_time desc.