Simple Log Service:Búsqueda guardada

Requisitos previos

Debe haber creado un índice. Para obtener más información, consulte Create indexes.

Crear una búsqueda guardada

1. Inicie sesión en la consola de Simple Log Service.

2. En la sección Projects, haga clic en el proyecto deseado.

   

3. En la pestaña Log Storage > Logstores, haga clic en el logstore deseado.

   

4. Introduzca una instrucción de consulta en el cuadro de búsqueda y haga clic en Last 15 Minutes para especificar un intervalo de tiempo de consulta.

   Para obtener más información, consulte Step 1: Configure indexes.

5. En la esquina superior derecha de la página, haga clic en el icono .

   Este es el icono Add to Saved Search (estrella), ubicado en la barra de herramientas de la esquina superior derecha de la página Search & Analysis.

6. En el panel Saved Query Details, establezca el Saved Query Name.

7. Haga clic en OK.

   Después de crear una búsqueda guardada, puede ejecutarla desde la página Search & Analysis del logstore. Haga clic en el icono situado antes del cuadro de entrada y, a continuación, haga clic en el nombre de la búsqueda guardada de destino.

Modificar una búsqueda guardada

1. En el panel de navegación izquierdo, elija Resources > Saved Search.

2. En la lista Saved Search, haga clic en la búsqueda guardada de destino.

3. Introduzca una nueva instrucción de consulta y análisis, y luego haga clic en el icono .

4. En la esquina superior derecha de la página, haga clic en el icono .

5. En el panel Saved Query Details, modifique la información de la búsqueda guardada y, a continuación, haga clic en OK.

Obtener el ID de una búsqueda guardada

Utilice el ID de una búsqueda guardada para insertar la página de dicha búsqueda en una página web personalizada. Para obtener más información, consulte Configure console embedding parameters.

1. En el panel de navegación izquierdo, elija Resources > Saved Search.

2. En la lista Saved Search, haga clic en la búsqueda guardada de destino.

3. Obtenga el ID de la búsqueda guardada desde la URL en la barra de direcciones de su navegador.

   La URL en la barra de direcciones de la consola de Log Service tiene el formato https://sls.console.alibabacloud.com/lognext/project/{ProjectName}/savedsearch/{savedSearchID}?slsRegion={region}. El campo situado entre /savedsearch/ y ?slsRegion= corresponde al ID de la búsqueda guardada.

Pasar variables mediante parámetros de URL

Al insertar la consola de Log Service en un iframe o vincular a una búsqueda guardada desde un sistema externo, agregue parámetros de URL para reemplazar dinámicamente los marcadores de posición de variables en la instrucción de consulta.

Requisitos previos

• Debe contar con una búsqueda guardada cuya instrucción de consulta contenga un marcador de posición de variable, como ${variable_name}.

• La función de token (modo tokenQuery) debe estar habilitada para la búsqueda guardada.

La URL estándar para una página de búsqueda guardada es la siguiente:

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

Agregue parámetros de consulta a esta URL para pasar valores de variables o añadir condiciones de filtro. La siguiente tabla describe los parámetros disponibles.

Parámetro token

El parámetro token es una matriz JSON donde cada elemento es un objeto con el formato {"key": "variable_name", "value": "replacement_value"}.

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

Ejemplo: Suponga que la instrucción de consulta para la búsqueda guardada my-search es | WHERE status = ${testParam}. Después de pasar los parámetros mediante la siguiente URL, la instrucción de consulta se reemplaza por | WHERE status = '200':

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

Parámetro tokenInherit

tokenInherit tiene el mismo formato que token. Por lo general, se pasa automáticamente durante un drill-down de panel para permitir que una búsqueda guardada herede valores de variables del panel. Cuando están presentes tanto token como tokenInherit, token tiene prioridad. Para las variables con la misma clave, se utiliza el valor de token.

Parámetro filters

El parámetro filters antepone una condición de filtro a la instrucción de consulta con un operador AND. Ejemplo:

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

La instrucción de consulta resultante es:

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

Prioridad de parámetros y orden de aplicación

Cuando hay varios parámetros presentes, Log Service construye la instrucción de consulta final en el siguiente orden:

1. El sistema comienza con la instrucción original de la búsqueda guardada.

2. Si existe el parámetro token o tokenInherit, Log Service reemplaza los marcadores de posición ${variable_name} en la instrucción.

3. Si existe el parámetro filters, Log Service antepone la condición de filtro a la instrucción mediante un operador AND.

Ejemplo completo

El nombre del Project es my-project, el Saved Search Name es error-query y la instrucción de consulta es * | WHERE status = ${statusCode} AND host = ${hostName}. Debe pasar los parámetros statusCode=500 y hostName=web-server-01, y añadir la condición de filtro level="ERROR". La URL se construye de la siguiente manera:

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

La instrucción de consulta resultante es:

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

Uso de parámetros en un iframe

Si inserta la página de búsqueda guardada en una página web personalizada mediante un iframe, puede concatenar parámetros dinámicamente al construir la URL src del 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, puede construir la URL dinámicamente en 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

• El valor del parámetro token es una matriz JSON y debe codificarse en formato URL (encodeURIComponent) dentro de una URL.

• El nombre de la variable (key) debe coincidir exactamente con el nombre de la variable de token definido en la instrucción de búsqueda guardada. El nombre distingue entre mayúsculas y minúsculas.

• Si la función Token no está habilitada para una búsqueda guardada (el parámetro tokenQuery está vacío), los parámetros token y tokenInherit no surtirán efecto y la instrucción de consulta no se reemplazará.

• filters funciona independientemente de si la función Token está habilitada para las búsquedas guardadas.

Eliminar una búsqueda guardada

En el panel de navegación izquierdo, elija Resources > Saved Search. En la lista de búsquedas guardadas, pase el cursor sobre la búsqueda guardada de destino, haga clic en el icono y, a continuación, haga clic en Delete.