Simple Log Service:Configuración de eventos

Configuración predeterminada de eventos

Requisitos previos

Esta función solo está disponible para datos recopilados mediante Logtail. No aplica a datos recopilados a través de una API o SDK.

Procedimiento

La configuración predeterminada de eventos permite agregar condiciones rápidamente a una sentencia de consulta mediante los operadores and y not, o bien crear una nueva sentencia de consulta.

Configuración avanzada de eventos

Es posible agregar distintos tipos de eventos a un campo de registro para realizar análisis detallados. Las acciones de evento disponibles incluyen abrir un logstore, una búsqueda guardada, un panel o un enlace HTTP personalizado.

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. En la pestaña Raw Logs, vaya a la subpestaña Table o Raw Data, haga clic en el icono y seleccione Event Settings.

5. En el cuadro de diálogo Advanced Event Settings, busque el campo objetivo en la lista de campos y haga clic en Add Event.

6. En la sección Event Settings, configure el evento avanzado.

   Las acciones de evento incluyen abrir un logstore, una búsqueda guardada, un panel o un enlace HTTP personalizado. La configuración de cada acción se describe a continuación.

   Nota

   • Para configurar un evento que abra un logstore, primero debe crear el logstore de destino. Para obtener más información, consulte Create a Logstore.

   • Para configurar un evento que abra una búsqueda guardada, primero debe crear la búsqueda guardada de destino. Para obtener más información, consulte Saved search.

     Para configurar variables, debe definir variables de marcador de posición en la sentencia de consulta de la búsqueda guardada de destino. Para obtener más información, consulte Set placeholder variables.

   • Para configurar un evento que abra un panel, primero debe crear el panel de destino. Para obtener más información, consulte Create a dashboard.

     Para configurar variables, debe definir variables de marcador de posición para las gráficas del panel de destino. Para obtener más información, consulte Set placeholder variables.

   • Para configurar un evento que abra un enlace HTTP personalizado, debe tener lista la URL de destino.

   • Open Logstore

     La siguiente tabla describe los parámetros para configurar un evento que abre un logstore.

     Parámetro	Descripción
     Configuration Name	Nombre de la configuración del evento.
     Event Action	Seleccione Open Logstore.
     Open New Window	Si habilita esta opción, la página de consulta del logstore de destino se abre en una nueva pestaña del navegador cuando se activa el evento.
     Time Range	Intervalo de tiempo de consulta para el logstore de destino. Puede establecerlo en uno de los siguientes valores: Default: Al hacer clic en un valor de campo y navegar al logstore de destino, la consulta utiliza el intervalo de tiempo predeterminado de Simple Log Service, que es 15 Minutes (Relative). Use Query Time: Al hacer clic en un valor de campo y navegar al logstore de destino, la consulta utiliza el mismo intervalo de tiempo que la consulta original de los registros sin procesar. Relative Time: Al hacer clic en un valor de campo y navegar al logstore de destino, la consulta utiliza el intervalo de tiempo relativo que usted especifique. Time Frame: Al hacer clic en un valor de campo y navegar al logstore de destino, la consulta utiliza el marco de tiempo específico que usted especifique.
     Select Logstore	Seleccione el logstore de destino. Cuando se active el evento, se le redirigirá a la página de consulta de este logstore.
     Inherit Filter Condition	Active el interruptor Inherit Filter Condition para sincronizar las condiciones de filtro existentes de la consulta actual con la página de consulta del logstore objetivo, y agréguelas al inicio de la sentencia de consulta y análisis mediante AND.
     Filter	Al introducir una sentencia de filtro en la pestaña Filter, la sentencia se sincroniza con la página de consulta del logstore de destino tras la redirección y se antepone a la sentencia de consulta y análisis mediante el operador AND. Puede insertar Optional Parameter Fields en una sentencia de filtro para usar los valores de los campos correspondientes como condiciones de filtro. Por ejemplo, si introduce ${__topic__}, se agrega un operador AND a la sentencia de consulta en el logstore de destino.
     Variable	No se admite la configuración de variables para esta acción de evento.

   • Open Saved Search

     Configure un evento para abrir una búsqueda guardada. La siguiente tabla describe los parámetros.

     Parámetro	Descripción
     Configuration Name	Nombre de la configuración del evento.
     Event Action	Seleccione Open Saved Search.
     Open New Window	Si habilita esta opción, la búsqueda guardada se abre en una nueva pestaña del navegador cuando se activa el evento.
     Time Range	Intervalo de tiempo de consulta para la búsqueda guardada de destino. Puede establecerlo en uno de los siguientes valores: Default: Al hacer clic en un valor de campo y navegar a la búsqueda guardada de destino, la consulta utiliza el intervalo de tiempo predeterminado de Simple Log Service, que es 15 Minutes (Relative). Use Query Time: Al hacer clic en un valor de campo y navegar a la búsqueda guardada de destino, la consulta utiliza el mismo intervalo de tiempo que la consulta original de los registros sin procesar. Relative Time: Al hacer clic en un valor de campo y navegar a la búsqueda guardada de destino, la consulta utiliza el intervalo de tiempo relativo que usted especifique. Time Frame: Al hacer clic en un valor de campo y navegar a la búsqueda guardada de destino, la consulta utiliza el marco de tiempo específico que usted especifique.
     Select Saved Query	Seleccione la búsqueda guardada de destino. Cuando se active el evento, se le redirigirá a dicha búsqueda guardada.
     Inherit Filter Condition	Active el interruptor Inherit Filter Condition para aplicar las condiciones de filtro existentes de la consulta actual a la página de Quick Query de destino, y agréguelas al inicio de la sentencia de consulta y análisis mediante AND.
     Filter	Si introduce una sentencia de filtro en la pestaña Filter, la sentencia se sincroniza con la página de consulta de Quick Query de destino y se antepone a la sentencia de consulta y análisis mediante AND. Puede insertar Optional Parameter Fields en una sentencia de filtro para usar el valor del campo correspondiente como condición de filtro. Por ejemplo, si hace clic para introducir ${__topic__}, la condición se agrega a la sentencia de consulta de la quick query resultante con un operador AND.
     Variable	Puede usar variables para modificar dinámicamente la sentencia de consulta de la búsqueda guardada de destino. Cuando una variable definida aquí coincide con una variable de marcador de posición en la búsqueda guardada de destino, el marcador se reemplaza por un valor al activarse el evento. Configure las variables en la pestaña Variable. Nota Para configurar variables, primero debe definir variables de marcador de posición en la sentencia de consulta de la búsqueda guardada de destino. Para obtener más información, consulte Set placeholder variables. Puede agregar hasta cinco variables dinámicas y cinco variables estáticas. Variable dinámica: El valor de esta variable se recupera dinámicamente de un campo específico en la entrada de registro que activa el evento. Dynamic Variable Name: Nombre de una variable de marcador de posición definida en Quick Query, como dynamic_ip. Column for Dynamic Variable Value: Los valores de la columna seleccionada se utilizan para reemplazar dinámicamente las variables en las sentencias de consulta y análisis de la quick query objetivo. Por ejemplo, seleccione __source__. Reemplaza la variable de marcador de posición definida en la quick query con el valor de __source__ y ejecuta la consulta. Variable estática: El valor de esta variable es un valor fijo predefinido. Static Variable Name: Nombre de una variable de marcador de posición definida en Quick Query. Por ejemplo: static_ip. Static Value: Reemplaza las variables en las sentencias de consulta y análisis de la quick query objetivo con un valor fijo. Por ejemplo, 203.0.113.1. Esto indica que el valor 203.0.113.1 de static_ip reemplaza la variable de marcador de posición definida en la quick query, y se realiza una consulta. Se recuperan todos los registros donde la variable de marcador de posición tiene un valor de 203.0.113.1.

   • Open Dashboard

     Configure un evento para abrir un panel. La siguiente tabla describe los parámetros.

     Parámetro	Descripción
     Configuration Name	Nombre de la configuración del evento.
     Event Action	Seleccione Open Dashboard.
     Open New Window	Si habilita esta opción, el panel se abre en una nueva pestaña del navegador cuando se activa el evento.
     Time Range	Intervalo de tiempo de consulta para el panel de destino. Puede establecerlo en uno de los siguientes valores: Default: Al hacer clic en un valor de campo y navegar al panel de destino, la consulta utiliza el intervalo de tiempo predeterminado de Simple Log Service, que es 15 Minutes (Relative). Inherit Chart Time: Al hacer clic en un valor de campo y navegar al panel de destino, la consulta utiliza el intervalo de tiempo de la gráfica que activó el evento de profundización. Relative Time: Al hacer clic en un valor de campo y navegar al panel de destino, la consulta utiliza el intervalo de tiempo relativo que usted especifique. Time Frame: Al hacer clic en un valor de campo y navegar al panel de destino, la consulta utiliza el marco de tiempo específico que usted especifique.
     Select Dashboard	Seleccione el panel de destino. Cuando se active el evento, se le redirigirá a dicho panel.
     Inherit Filter Condition	Si activa el interruptor Inherit Filter Condition, las condiciones de filtro existentes del panel actual se transfieren al panel de destino.
     Filter	En la pestaña Filter, introduzca una sentencia de filtro. Esta sentencia se transfiere al panel de destino. Puede insertar un Optional Parameter Fields en una sentencia de filtro para usar el valor del campo correspondiente como condición de filtro. Por ejemplo, si hace clic para insertar ${__source__}, el panel de destino mostrará solo los registros con un valor que coincida con ${__source__}.
     Variable	Puede pasar variables al panel de destino. Configure las variables en la pestaña Variable. Nota Para configurar variables, primero debe definir variables de marcador de posición para las gráficas del panel de destino. Para obtener más información, consulte Set placeholder variables. Puede agregar hasta cinco variables dinámicas y cinco variables estáticas. Variable dinámica: El valor de esta variable se recupera dinámicamente de un campo específico en la entrada de registro donde se activó el evento. Dynamic Variable Name: Especifique una variable de marcador de posición definida en Quick Query, como dynamic_ip. Column for Dynamic Variable Value: Los valores de la columna especificada se sincronizan dinámicamente con el panel objetivo. Por ejemplo, seleccione __source__. Reemplaza la variable de marcador de posición definida en la consulta del panel con el valor de __source__ y ejecuta la consulta. Variable estática: El valor de esta variable es un valor fijo predefinido. Static Variable Name: Nombre de la variable estática. Por ejemplo, introduzca la variable de marcador de posición static_ip que definió en el origen de datos del panel. Static Value: Un valor fijo se sincroniza con el panel objetivo. Por ejemplo, 203.0.113.1. Esto indica que la variable de marcador de posición predefinida en el panel se reemplaza con el valor de static_ip (203.0.113.1), y se realiza una consulta. Se recuperan todos los registros donde la variable de marcador de posición está establecida en 203.0.113.1.

   • Enlace HTTP personalizado

     Configure un evento para abrir un enlace HTTP personalizado.

     • La ruta en el enlace HTTP especifica la ubicación del archivo de destino.

     • Puede agregar campos de parámetros opcionales (variables) a la ruta de la URL. Al activar el evento desde un registro sin procesar, el valor del campo correspondiente reemplaza al parámetro y se le redirige a la nueva URL.

     Parámetro	Descripción
     Configuration Name	Nombre de la configuración del evento.
     Event Action	Seleccione Create Custom HTTP URL.
     Protocol	Protocolo para el enlace personalizado. Los tipos compatibles incluyen HTTP y Custom.
     Enter a URL	URL de destino. Por ejemplo, www.example.com/s?wd=${sls_project} es la URL de destino. Después de activarse un evento, ${sls_project} se reemplaza con el nombre de su Project.
     Use System Variable	Si activa el interruptor Use System Variable, puede insertar variables del sistema de Simple Log Service en la URL. Las variables compatibles incluyen ${sls_project}, ${sls_dashboard_title}, ${sls_chart_name}, ${sls_chart_title}, ${sls_region}, ${sls_start_time}, ${sls_end_time}, ${sls_realUid} y ${sls_aliUid}.
     Transcode	Si activa el interruptor Transcode, el contenido de la URL se codifica.
     Optional Parameter Fields	Puede reemplazar partes de la URL con el valor de un campo del registro que activa el evento. El reemplazo ocurre automáticamente al activarse el evento.

Ejemplo

Este ejemplo muestra cómo realizar un análisis de profundización mediante una búsqueda guardada. En este escenario, recopila registros de acceso en un logstore llamado accesslog. Cree una búsqueda guardada llamada PV Distribution of IP Addresses and method. Luego, configure un evento avanzado para el campo remote_addr en sus registros sin procesar para abrir esta búsqueda guardada. Tras la configuración, al hacer clic en un valor del campo remote_addr, accederá a la búsqueda guardada para ver la tendencia de PV correspondiente.

__source__:127.0.0.1
__tag__:__receive_time__:1613759995
__topic__:nginx_access_log
body_bytes_sent:5077
host:www.example.com
http_referer:www.example.com
http_user_agent:Mozilla/5.0 (X11; CrOS i686 12.0.742.91) AppleWebKit/534.30 (KHTML, like Gecko) Chrome/192.0.2.2 Safari/534.30
http_x_forwarded_for:192.0.2.1
remote_addr:192.0.2.0
remote_user:gp_02
request_length:3932
request_method:POST
request_time:35
request_uri:/request/path-2/file-4
status:200
time_local:19/Feb/2021:18:39:50
upstream_response_time:0.09

Procedimiento:

1. Cree una búsqueda guardada llamada PV Distribution of IP Addresses and method para consultar la distribución de PV de las solicitudes donde el método de solicitud es POST y el código de estado es 200. La sentencia de consulta y los resultados se muestran a continuación:

   * and request_method: POST and status: 200 | select count(*) as pv, remote_addr as ip,request_method as method group by ip,method order by ip desc

2. Establezca las variables method y status2 en Quick Query. Una vez generadas las variables, la sentencia cambia de la siguiente manera:

   * and request_method: ${method} and status: ${status2} | select count(*) as pv, remote_addr as ip,request_method as method group by ip,method order by ip desc

3. En la pestaña Raw Logs, configure un evento avanzado para el campo remote_addr. Establezca Event Action en Open Saved Search y configure los siguientes parámetros clave:

   • Select Saved Search: PV Distribution of IP Addresses and method

   • Filter: Déjelo vacío.

   • Variables: La variable estática es status2 y su valor es 400. La variable dinámica es method y su valor es request_method.

4. En la pestaña Raw Logs, haga clic en un valor de la columna remote_addr. En el menú que aparece, haga clic en el evento que creó: remote_addr > PV Distribution of IP Addresses and method.

   En este campo de registro, el request_method es GET y el status es 404.

5. Se abre una nueva ventana. La sentencia de consulta en el cuadro de búsqueda ahora es:

   * and request_method: GET and status: 400 | select count(*) as pv, remote_addr as ip,request_method as method group by ip,method order by ip desc

6. Consulte los resultados de la búsqueda guardada.

   En este ejemplo, la variable estática status2 está establecida en 400, que corresponde al campo status. El request_method del registro en el que hizo clic para activar el evento es GET, por lo que la variable dinámica method se establece en GET. El resultado de la quick query es la distribución de PV de direcciones IP para solicitudes GET con un estado de 400.

   De igual forma, al hacer clic en la entrada de registro del evento activador donde el request_method es PUT, la quick query muestra la distribución de PV de direcciones IP para solicitudes PUT con un estado de 400.