Simple Log Service:Pesquisa salva

Pré-requisitos

Crie um índice. Para mais informações, consulte Criar índices.

Criar uma pesquisa salva

1. Faça login no console do Simple Log Service.

2. Na seção Projects, clique em no projeto desejado.

   

3. Na aba Log Storage > Logstores, clique em no logstore desejado.

   

4. Insira uma instrução de consulta na caixa de pesquisa e clique em Last 15 Minutes para especificar o intervalo de tempo da consulta.

   Para mais informações, consulte Etapa 1: Configurar índices.

5. No canto superior direito da página, clique em no ícone .

   Este é o ícone Add to Saved Search (estrela), localizado na barra de ferramentas no canto superior direito da página Search & Analysis.

6. No painel Saved Query Details, defina o Saved Query Name.

7. Clique em OK.

   Após criar uma pesquisa salva, execute-a na página Search & Analysis do Logstore. Clique em no ícone antes da caixa de entrada e, em seguida, clique em no nome da pesquisa salva desejada.

Modificar uma pesquisa salva

1. No painel de navegação à esquerda, escolha Resources > Saved Search.

2. Na lista Saved Search, clique em na pesquisa salva desejada.

3. Insira uma nova instrução de consulta e análise e clique em no ícone .

4. No canto superior direito da página, clique em no ícone .

5. No painel Saved Query Details, modifique as informações da pesquisa salva e clique em OK.

Obter um ID de pesquisa salva

Use um ID de pesquisa salva para incorporar a página da pesquisa salva em uma página web personalizada. Para mais informações, consulte Configurar parâmetros de incorporação do console.

1. No painel de navegação à esquerda, escolha Resources > Saved Search.

2. Na lista Saved Search, clique em na pesquisa salva desejada.

3. Obtenha o ID da pesquisa salva na URL da barra de endereços do navegador.

   A URL na barra de endereços do console do Log Service segue o formato https://sls.console.alibabacloud.com/lognext/project/{ProjectName}/savedsearch/{savedSearchID}?slsRegion={region}. O campo entre /savedsearch/ e ?slsRegion= corresponde ao ID da pesquisa salva.

Passar variáveis com parâmetros de URL

Ao incorporar o console do Log Service em um iframe ou vincular a uma pesquisa salva a partir de um sistema externo, anexe parâmetros de URL para substituir dinamicamente os espaços reservados de variáveis na instrução de consulta.

Pré-requisitos

• Tenha uma pesquisa salva cuja instrução de consulta contenha um espaço reservado para variável, como ${variable_name}.

• Ative o recurso de token (modo tokenQuery) para a pesquisa salva.

A URL padrão para uma página de pesquisa salva é:

/lognext/project/{ProjectName}/savedsearch/{savedSearchName}

Anexe parâmetros de consulta a esta URL para passar valores de variáveis ou adicionar condições de filtro. A tabela a seguir descreve os parâmetros disponíveis.

Parâmetro token

O parâmetro token é um array JSON em que cada elemento é um objeto no formato {"key": "variable_name", "value": "replacement_value"}.

[{"key": "variable_name1", "value": "value1"}, {"key": "variable_name2", "value": "value2"}]

Exemplo: Suponha que a instrução de consulta da pesquisa salva my-search seja | WHERE status = ${testParam}. Após passar os parâmetros usando a URL abaixo, a instrução de consulta será substituída por | WHERE status = '200':

/lognext/project/my-project/savedsearch/my-search?token=[{"key":"testParam","value":"200"}]

Parâmetro tokenInherit

O tokenInherit tem o mesmo formato que o token. Geralmente, ele é passado automaticamente durante um drill-down de painel para permitir que uma pesquisa salva herde valores de variáveis do painel. Quando ambos estão presentes, o token tem prioridade. Para variáveis com a mesma chave, o valor do token prevalece.

Parâmetro filters

O parâmetro filters adiciona uma condição de filtro antes da instrução de consulta com um operador AND. Exemplo:

/lognext/project/my-project/savedsearch/my-search?filters=level%3D"ERROR"

A instrução de consulta resultante é:

(level="ERROR") AND <Original query statement>

Prioridade e ordem de aplicação dos parâmetros

Quando há múltiplos parâmetros, o Log Service constrói a instrução de consulta final na seguinte ordem:

1. Começa com a instrução original da pesquisa salva.

2. Se o parâmetro token ou tokenInherit existir, substitui os espaços reservados ${variable_name} na instrução.

3. Se o parâmetro filters existir, insere a condição de filtro antes da instrução usando um operador AND.

Exemplo completo

O nome do Project é my-project, o Saved Search Name é error-query e a instrução de consulta é * | WHERE status = ${statusCode} AND host = ${hostName}. Passe os parâmetros statusCode=500 e hostName=web-server-01 e adicione a condição de filtro level="ERROR". A URL é construída da seguinte forma:

/lognext/project/my-project/savedsearch/error-query?token=[{"key":"statusCode","value":"500"},{"key":"hostName","value":"web-server-01"}]&filters=level%3D"ERROR"

A instrução de consulta resultante é:

(level="ERROR") AND * | WHERE status = '500' AND host = 'web-server-01'

Uso de parâmetros em um iframe

Se você incorporar a página de pesquisa salva em uma página web personalizada usando um iframe, concatene parâmetros dinamicamente ao construir a URL src do iframe:

<iframe
  src="/lognext/project/my-project/savedsearch/error-query?token=[{&quot;key&quot;:&quot;statusCode&quot;,&quot;value&quot;:&quot;500&quot;}]"
  width="100%"
  height="800px"
  frameborder="0"
/>

Alternativamente, construa a URL dinamicamente em JavaScript:

const params = encodeURIComponent(JSON.stringify([
  { key: 'statusCode', value: '500' },
  { key: 'hostName', value: 'web-server-01' }
]))
const iframeSrc = `/lognext/project/my-project/savedsearch/error-query?token=${params}`
document.getElementById('sls-iframe').src = iframeSrc

Notas de uso

• O valor do parâmetro token é um array JSON e deve ser codificado como URL (encodeURIComponent) na URL.

• O nome da variável (key) deve corresponder exatamente ao nome da variável de token definido na instrução da pesquisa salva. O nome diferencia maiúsculas de minúsculas.

• Se o recurso Token não estiver ativado para uma pesquisa salva (parâmetro tokenQuery vazio), os parâmetros token e tokenInherit não terão efeito e a instrução de consulta não será substituída.

• O filters funciona independentemente de o recurso Token estar ativado para as pesquisas salvas.

Excluir uma pesquisa salva

No painel de navegação à esquerda, escolha Resources > Saved Search. Na lista de pesquisas salvas, passe o mouse sobre a pesquisa salva desejada, clique em no ícone e, em seguida, clique em Delete.