Cloud Monitor:Configurar un evento de interacción personalizado para una traza

Los eventos de interacción permiten cambiar entre dimensiones o niveles de granularidad para obtener información más detallada. Trace Explorer admite la configuración de eventos de interacción para campos y atributos de span. A continuación se describen los tipos de eventos disponibles:

• Open the log library: redirige al Logstore de Simple Log Service (SLS) especificado.

• Customize HTTP Link: redirige a la URL HTTP especificada.

• Open from the edit box: muestra el valor del campo en formato de texto o JSON dentro de una ventana emergente.

• Open Quick Search: redirige a la búsqueda guardada en SLS.

Configurar un evento de interacción personalizado

1. En la página Trace Explorer, haga clic en un ID de traza.

2. Haga clic en una interfaz y luego en Event Config dentro de la sección Span Details.

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

   Los eventos de interacción personalizados admiten dos modos: Service event configuration y Global event configuration. En el modo Service event configuration, el evento se aplica a todas las trazas de la aplicación actual. En el modo Global event configuration, el evento se aplica a todas las trazas de la región actual.

   De forma predeterminada, los campos spanID y traceID ya están configurados. Puede hacer clic en Add fields para agregar nuevos campos o en el icono de eliminación para quitar los existentes.

4. Haga clic en Add fields, seleccione un campo y luego en OK.

   Por ejemplo, en la pestaña Service Event Config del cuadro de diálogo Drilldown Config, seleccione el campo spanID en la lista desplegable.

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

   Los eventos disponibles son Open Logstore, Custom HTTP Link, Open in Editor y Open Quick Search.

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

   Para obtener más información sobre los parámetros, consulte la sección Interaction event parameters.

   El panel de configuración cuenta con dos pestañas: Service Event Config y Global Event Config. Seleccione un elemento para expandir su formulario de configuración, donde podrá especificar parámetros como Custom Name y Text type. Para agregar más eventos, haga clic en el botón Add event situado en la parte inferior.

Activar un evento de interacción personalizado

En la sección Span Details, pase el puntero sobre un campo azul. Aparecerá una información emergente que muestra los eventos de interacción personalizados configurados para dicho campo. Haga clic en el nombre de un evento para activarlo.

Por ejemplo, si pasa el puntero sobre el valor del campo spanID, aparecerá una información emergente. La sección CUSTOM EVENT muestra los eventos configurados, como Open in Editor y Query Associated Logs.

Parámetros de eventos de interacción

Open the log library

Al activarse, el evento Open the log library redirige al Logstore especificado.

• Requisitos previos

  Debe haber creado un Logstore. Para obtener más información, consulte Manage a logstore.

• Parámetros

  Parámetro	Obligatorio	Descripción
  Custom Name	Sí	Introduzca el nombre del evento de interacción personalizado. Este nombre se muestra en la información emergente.
  Please select region	Sí	Seleccione la región donde reside el proyecto de SLS.
  Please select the project	Sí	Seleccione el nombre del proyecto de SLS.
  Please select a log repository	Sí	Seleccione el nombre del Logstore de SLS. Al activarse el evento, la página redirige al Logstore.
  Open a new window	No	Especifique si desea abrir el Logstore en una ventana emergente al activarse el evento.
  Time range	No	Seleccione el intervalo de tiempo de los datos que se consultarán en el Logstore. Valores válidos: Default: se utiliza el intervalo de tiempo predeterminado, que es de 15 minutos (relativo). Use Query Time: se utiliza el intervalo de tiempo especificado en Trace Explorer al momento de activar el evento. Data Point Time: la hora de inicio del intervalo corresponde al valor del parámetro Time Range Field menos el valor del parámetro Time range field difference. La hora de finalización del intervalo corresponde al valor del parámetro Time Range Field más el valor del parámetro Time range field difference. Relative time range: se utiliza el intervalo de tiempo relativo especificado. Time frame: se utilizan los puntos horarios dentro del marco de tiempo especificado.
  Filter statement	No	Introduzca una instrucción de filtro para sincronizarla con el Logstore; esta se agregará antes de la instrucción de consulta mediante el operador AND. Haga clic en Add variables para agregar campos como variables a la instrucción de filtro y utilizar sus valores como condiciones de filtrado. Ejemplo: traceId=${{traceID}} AND spanId=${{spanID}}

Customize HTTP Link

Al activarse, el evento Customize HTTP Link redirige a la URL HTTP especificada.

• Requisitos previos

  Debe contar con una URL HTTP disponible.

• Parámetros

  Parámetro	Obligatorio	Descripción
  Custom Name	Sí	Introduzca el nombre del evento de interacción personalizado. Este nombre se muestra en la información emergente.
  agreement	Sí	Seleccione el protocolo de la URL HTTP.
  Link address	Sí	Introduzca la URL HTTP. La ruta en la URL HTTP especifica la ruta jerárquica hacia el recurso destino. Haga clic en Add variables para agregar campos como variables dentro de la ruta. Al activarse el evento, los valores de los campos reemplazan a las variables en la URL.
  Whether to transcode	No	Especifique si se debe codificar la URL HTTP.
  Open a new window	No	Especifique si desea navegar a la URL HTTP en una ventana emergente al activarse el evento.

Open from the edit box

Al activarse, el evento Open from the edit box muestra el valor del campo en formato de texto o JSON dentro de una ventana emergente.

Open Quick Search

Al activarse, el evento Open Quick Search redirige a la búsqueda guardada en SLS.

• Requisitos previos

  Debe haber creado una búsqueda guardada en SLS. Para obtener más información, consulte Saved search.

  Si desea configurar una variable para el evento de interacción, asegúrese de que dicha variable ya esté configurada en la instrucción de consulta de la búsqueda guardada. Para obtener más información, consulte Use variables to dynamically modify the parameters of a query statement.

• Parámetros

  Parámetro	Obligatorio	Descripción
  Custom Name	Sí	Introduzca el nombre del evento de interacción personalizado. Este nombre se muestra en la información emergente.
  Please select region	Sí	Seleccione la región donde reside el proyecto de SLS.
  Please select the project	Sí	Seleccione el nombre del proyecto de SLS.
  Please select Quick Search	Sí	Seleccione la búsqueda guardada. Al activarse el evento, la página redirige a dicha búsqueda.
  Open a new window	No	Especifique si desea abrir la búsqueda guardada en una ventana emergente al activarse el evento.
  Time range	No	Seleccione el intervalo de tiempo de consulta para la búsqueda guardada. Valores válidos: Default: se utiliza el intervalo de tiempo predeterminado, que es de 15 minutos (relativo). Use Query Time: se utiliza el intervalo de tiempo especificado en Trace Explorer al momento de activar el evento. Data Point Time: la hora de inicio del intervalo corresponde al valor del parámetro Time Range Field menos el valor del parámetro Time range field difference. La hora de finalización del intervalo corresponde al valor del parámetro Time Range Field más el valor del parámetro Time range field difference. Relative time range: se utiliza el intervalo de tiempo relativo especificado. Relative time range: se utiliza el intervalo de tiempo relativo especificado.
  Filter statement	No	Introduzca una instrucción de filtro para sincronizarla con el Logstore; esta se agregará antes de la instrucción de consulta mediante el operador AND. Haga clic en Add variables para agregar campos como variables a la instrucción de filtro y utilizar sus valores como condiciones de filtrado.
  Dynamic variables	No	SLS permite modificar la instrucción de consulta de la búsqueda guardada mediante variables. Si una variable que especifique aquí coincide con alguna definida en la instrucción de consulta, prevalecerá la especificada en este campo. Nota Puede agregar hasta cinco variables dinámicas y cinco variables estáticas. Variables dinámicas Variable: nombre de la variable. Variable Value Column: columna donde se encuentran los valores de la variable. Estos valores se utilizan para reemplazar dinámicamente la variable en la búsqueda guardada. Variables estáticas Variable: nombre de la variable. Value: valor de la variable estática, el cual se utiliza para reemplazar la variable de marcador de posición en la búsqueda guardada.
  Static variables	No

Eventos de interacción predefinidos (configuración avanzada)

Trace Explorer proporciona los siguientes eventos de interacción predefinidos.

Al hacer clic en el valor de un campo dentro del panel Span Details, se abre un menú emergente. La sección Advanced Settings contiene los eventos de interacción predefinidos, mientras que la sección CUSTOM EVENT incluye los eventos definidos por el usuario. Para gestionar estos eventos, haga clic en Event Config en la parte inferior.

Notas de uso

Si accede a Trace Explorer mediante un nombre de dominio virtual (por ejemplo, al integrar una página de la consola ARMS en una aplicación web autogestionada), la activación de los eventos Open the log library u Open Quick Search lo redirigirá a la página de inicio de sesión de SLS en lugar de a la consola de SLS. Si no utiliza un nombre de dominio virtual, puede emplear el evento Customize HTTP Link para configurar dos redirecciones. Siga estos pasos:

1. Configure el evento Customize HTTP Link.

2. Seleccione el protocolo HTTPS e introduzca la URL de una página de la consola SLS en el campo Link Address.

3. Prepare la URL destino de SLS. 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 shareable URLs.

4. Si desea incluir parámetros de consulta al acceder al Logstore, haga clic en Add variables para agregarlos como variables.

   La siguiente URL abre un Logstore llamado test-logstore, perteneciente al proyecto test-project, y busca la traza actual.

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