Application Real-Time Monitoring Service:Configurar eventos de interacción personalizados

Los eventos de interacción son una función esencial para el análisis de datos. Al modificar las dimensiones de los datos y la granularidad del análisis, es posible obtener información más profunda. El análisis de traces permite establecer eventos de interacción para los campos y atributos de un span. Los tipos de eventos de interacción disponibles incluyen:

• Open Logstore: Redirige a una página de logstore de destino en Simple Log Service (SLS).

• Custom HTTP Link: Redirige a una URL HTTP de destino.

• Open in Editor: Muestra el valor del campo en formato de texto o JSON dentro de una ventana emergente.

• Open Saved Search: Redirige a una página de búsqueda guardada de destino en Simple Log Service (SLS).

Agregar un evento de interacción personalizado

1. En la página Trace Explorer, haga clic en el TraceID de un trace.

2. Seleccione un span de destino y, en el panel Span Details de la derecha, haga clic en Event Config.

3. En el panel Drilldown Config, seleccione el alcance del evento de interacción.

   Los eventos personalizados tienen dos alcances: service event configuration y global event configuration. La configuración de eventos de servicio aplica únicamente a los traces de la current application, mientras que la configuración de eventos globales aplica a todos los traces de la current region.

   En la pestaña service event configuration, haga clic en Add Field para agregar los campos SpanId y TraceID.

4. Haga clic en Add Field, seleccione el campo que desea configurar para el evento y luego haga clic en OK.

5. Haga clic en Add Event y seleccione un evento de interacción de la lista desplegable.

   Los eventos de interacción disponibles incluyen Open Logstore, Custom HTTP Link, Open in Editor y Open Saved Search.

6. Configure los parámetros del evento y haga clic en OK.

   Para obtener detalles sobre los parámetros, consulte Interaction event parameters.

   En la pestaña service event configuration, agregue un evento para el campo SpanId. Configure el Custom Name y seleccione el Text Type. Puede hacer clic en Add Event para agregar más eventos de interacción.

Activar un evento personalizado

En el panel Span Details, pase el cursor sobre un campo resaltado en azul. Aparecerá una descripción emergente que muestra los eventos personalizados configurados. Haga clic en el nombre de un evento para activar el evento de interacción.

Por ejemplo, al pasar el cursor sobre el valor del campo SpanId, la sección Custom Events del menú emergente muestra los eventos configurados, como Open in Editor y Query Associated Logs.

Parámetros de eventos de interacción

Open Logstore

Al activar el evento de interacción Open Logstore, la consola lo redirige a la página del logstore de SLS de destino.

• Requisitos previos

  El logstore de destino ya debe estar creado. Para obtener más información, consulte Manage Logstores.

• Parámetros

  Parameter	Required	Description
  Custom name	Sí	Nombre del evento de interacción personalizado. Este nombre se muestra en la descripción emergente del evento personalizado.
  Select region	Sí	Región donde se encuentra el proyecto de SLS de destino.
  Select project	Sí	Nombre del proyecto de SLS de destino.
  Select logstore	Sí	Nombre del logstore de destino. Al activar el evento de interacción, la consola redirige a este logstore.
  Open in new window	No	Si habilita esta opción, el logstore de destino se abre en una nueva ventana del navegador al activar el evento de interacción.
  Time range	No	Especifica el intervalo de tiempo de consulta para el logstore de destino. Opciones: Preset: Al abrir el logstore de destino, SLS utiliza el intervalo de tiempo de consulta predeterminado, que es de 15 minutos (relativo). Inherit current query time: Al abrir el logstore de destino, el intervalo de tiempo de consulta se hereda de la página Trace Analysis en el momento en que se activa el evento de interacción. Inherit data point time: Al abrir el logstore de destino, la hora de inicio de la consulta corresponde al valor de Time Range Field menos el Time Range Offset, y la hora de finalización corresponde al valor de Time Range Field más el Time Range Offset. Relative Time: Al abrir el logstore de destino, el tiempo de consulta corresponde al intervalo de tiempo relativo especificado. Time Frame: Al abrir el logstore de destino, el tiempo de consulta corresponde al marco de tiempo especificado.
  Filter statement	No	Introduzca una instrucción de filtro. El sistema la sincroniza con el logstore de destino y la antepone a la instrucción de consulta mediante el operador AND. Haga clic en Add Variable dentro de la instrucción de filtro para insertar valores de campo como condiciones de filtrado. Ejemplo: traceId=${{TraceID}} AND spanId=${{SpanId}}

Custom HTTP Link

Al activar el evento de interacción Custom HTTP Link, la consola lo redirige a la URL HTTP de destino.

• Requisitos previos

  Debe contar con una URL HTTP disponible.

• Parámetros

  Parameter	Required	Description
  Custom name	Sí	Nombre del evento de interacción personalizado. Este nombre se muestra en la descripción emergente del evento personalizado.
  Protocol	Sí	Protocolo de la URL HTTP, como HTTP o HTTPS.
  URL	Sí	URL de destino. La ruta en la URL HTTP representa la jerarquía hacia el recurso de destino. Puede hacer clic en Add Variable para insertar variables en la ruta de la URL. Al hacer clic en el enlace, el sistema reemplaza las variables con los valores de campo correspondientes y redirige a la URL actualizada.
  Encode URL	No	Si habilita Encode URL, el contenido del enlace se codifica como URL.
  Open in new window	No	Si habilita esta opción, la URL HTTP de destino se abre en una nueva ventana del navegador al activar el evento de interacción.

Open in Editor

Al activar el evento de interacción Open in Editor, la consola muestra el valor del campo en formato de texto o JSON dentro de una ventana emergente.

Open Saved Search

Al activar el evento de interacción Open Saved Search, la consola lo redirige a la página de búsqueda guardada de SLS de destino.

• Requisitos previos

  La búsqueda guardada de destino ya debe estar creada en SLS. Para obtener más información, consulte Saved searches.

  Para utilizar variables, configúrelas en la instrucción de consulta de la búsqueda guardada de destino. Para obtener más información, consulte Dynamically adjust query statement parameters by using variables.

• Parámetros

  Parameter	Required	Description
  Custom name	Sí	Nombre del evento de interacción personalizado. Este nombre se muestra en la descripción emergente del evento personalizado.
  Select region	Sí	Región donde se encuentra el proyecto de SLS de destino.
  Select project	Sí	Nombre del proyecto de SLS de destino.
  Select saved search	Sí	Búsqueda guardada de destino en SLS. Después de activar el evento de interacción, la consola abre la página correspondiente a esta búsqueda guardada.
  Open in new window	No	Si habilita esta opción, la página de búsqueda guardada de destino se abre en una nueva ventana del navegador al activar el evento de interacción.
  Time range	No	Especifica el intervalo de tiempo de consulta para la búsqueda guardada de destino. Opciones: Preset: Al abrir la página de búsqueda guardada de destino, SLS utiliza el intervalo de tiempo de consulta predeterminado, que es de 15 minutos (relativo). Inherit current query time: Al abrir la página de búsqueda guardada de destino, el intervalo de tiempo de consulta se hereda de la página Trace Analysis en el momento en que se activa el evento de interacción. Inherit data point time: Al abrir la página de búsqueda guardada de destino, la hora de inicio de la consulta corresponde al valor de Time Range Field menos el Time Range Offset, y la hora de finalización corresponde al valor de Time Range Field más el Time Range Offset. Relative Time: Al abrir la página de búsqueda guardada de destino, el tiempo de consulta corresponde al intervalo de tiempo relativo especificado. Time Frame: Al abrir la página de búsqueda guardada de destino, el tiempo de consulta corresponde al marco de tiempo especificado.
  Filter statement	No	Introduzca una instrucción de filtro. El sistema la sincroniza con la página de búsqueda guardada de destino y la antepone a la instrucción de consulta mediante el operador AND. Haga clic en Add Variable dentro de la instrucción de filtro para insertar valores de campo como condiciones de filtrado.
  Dynamic variables	No	SLS permite usar variables para modificar flexiblemente la instrucción de consulta en la búsqueda guardada de destino. Si una variable agregada aquí tiene el mismo nombre que una variable en la consulta de la búsqueda guardada de destino, el valor del campo que activa el evento de interacción reemplaza a la variable en la instrucción de consulta. Nota Puede agregar hasta cinco variables dinámicas y cinco variables estáticas. Variables dinámicas Variable name: Nombre de la variable. Variable value column: Columna cuyo valor reemplaza dinámicamente a la variable en la consulta de la búsqueda guardada. Variables estáticas Variable name: Nombre de la variable. Static value: Valor fijo que reemplaza a la variable en la consulta de la búsqueda guardada.
  Static variables	No

Eventos de interacción predefinidos

Trace Analysis incluye los siguientes eventos de interacción predefinidos:

Al hacer clic derecho sobre el valor de un campo de span, aparece un menú contextual. Este menú se divide en las secciones Advanced Configuration y Custom Events. La sección Advanced Configuration muestra eventos integrados, como Query Trace with Current Condition y View Application Details. La sección Custom Events muestra los eventos configurados por el usuario. La opción Event Config, situada en la parte inferior del menú, permite gestionar los eventos personalizados.

Preguntas frecuentes

Si accede a la página Trace Analysis mediante un nombre de dominio virtual (por ejemplo, si la página de ARMS está incrustada en una página web autogestionada), activar los eventos Open Logstore u Open Saved Search podría redirigirlo a una página de inicio de sesión en lugar de a la consola de SLS. Para solucionar este problema, utilice un evento de interacción Custom HTTP Link para lograr el mismo efecto. Siga estos pasos:

1. Cree un evento de interacción Custom HTTP Link.

2. Seleccione https como Protocol e introduzca la URL de destino en el campo URL.

3. Prepare la URL de SLS de destino. Reemplace el nombre de dominio estándar (sls.console.alibabacloud.com) por el nombre de dominio virtual de SLS (sls4service.console.alibabacloud.com). Para obtener más información, consulte Prepare a shareable link. Deshabilite Encode URL y habilite Open in new window.

4. Si desea pasar parámetros de consulta al redirigir al logstore, haga clic en Add Variable y seleccione las variables que desea agregar.

   La siguiente URL de ejemplo abre el logstore llamado test-logstore en el proyecto test-project y filtra los registros donde traceId coincide con el TraceID del trace actual.

   https://sls4service.console.alibabacloud.com/lognext/project/test-project/logsearch/test-logstore?queryString=traceId=${{TraceID}}