Creación de un widget basado en consultas mediante rastreos

Puede crear un widget basado en consultas mediante rastreos de Application Performance Monitoring.

Puede utilizar las muchas funciones disponibles en el generador de widgets basado en consultas para crear un widget que muestre una expresión de lenguaje de consulta de rastreo (TQL). El generador de widgets basado en consultas le proporciona opciones y funcionalidades para visualizar y supervisar los datos de rastreo. Por ejemplo, puede mostrar transacciones con una puntuación baja en rendimiento cuando las utilizan muchos clientes, lo que hace que estas transacciones sean dignas de esfuerzos de mejora del rendimiento.

Para crear un widget basado en consulta que muestre datos de rastreo:

  1. Vaya a la página Paneles de control.
  2. Haga clic en Crear panel de control para crear un nuevo panel de control o abrir un panel de control existente en modo de edición.
  3. En el separador Widgets, haga clic en el icono Agregar grupo de widgets y widgets (Agregar grupo de widgets y widgets) y haga clic en Crear widget basado en consulta....
    Se muestra el generador de widgets basado en consultas.
  4. Opcionalmente, haga clic en el icono Abrir/cerrar panel de filtro (Abrir/cerrar panel de filtros) para ver los filtros ya agregados al panel de control y realizar cambios, si es necesario.

    Tenga en cuenta que al crear un widget basado en consulta para agregarlo a un nuevo panel de control, se agrega automáticamente un filtro Compartimento y la entrada de compartimento para el nuevo widget que se está creando se enlaza a este filtro recién agregado.

  5. En la esquina superior derecha, seleccione un período de tiempo para el que desea mostrar datos en el widget.
  6. Seleccione Rastreos en la lista desplegable Origen de datos.
    Si no se agrega un filtro de dominio de APM al panel de control, se agrega automáticamente cuando se selecciona Rastreos.
  7. Edite la consulta por defecto que se muestra en el campo Consulta o introduzca una nueva consulta y haga clic en Ejecutar.

    Utilice la sintaxis TQL para crear consultas y recuperar datos de rastreo de Application Performance Monitoring. Para obtener información sobre TQL, consulte Trabajo con consultas.

    Los datos de rastreo se muestran en formato tabular con el nombre del servicio y otros detalles. Debajo del gráfico de tablas, se muestra otra tabla con los datos no procesados devueltos por la consulta de rastreo y puede hacer clic en Ocultar datos no procesados para ocultarlos.

  8. Utilice los siguientes separadores de la parte derecha para realizar tareas como agregar un nombre para el widget y personalizar la visualización de datos en el widget:
    Nota

    Puede hacer clic en JSON en la esquina superior derecha para editar los metadatos de JSON del widget directamente. El editor de JSON le proporciona una mayor flexibilidad y más opciones para visualizar datos en el widget. Sin embargo, se recomienda utilizarlo solo si está familiarizado con la edición de JSON del widget. Para obtener más información sobre el editor de JSON, póngase en contacto con los Servicios de Soporte Oracle.
    • Acerca de: introduzca un nombre para el widget, seleccione el compartimento en el que desea que resida el widget y agregue una descripción para el widget.

      También puede hacer clic en Mostrar opciones avanzadas para agregar etiquetas de formato libre o definidas al widget. Si tiene los permisos necesarios para crear un widget, también los tiene para agregar etiquetas de formato libre. Para agregar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta. Para obtener información sobre:

    • Visualización: seleccione un tipo de gráfico y personalice la visualización especificando o modificando opciones adicionales.

      Si selecciona Tabla como tipo de gráfico, tiene la opción de eliminar algunas de las columnas o seleccionar la casilla de control Todas las columnas para mostrar todas las columnas. Los tipos de gráfico que tienen ejes X e Y, como el gráfico de línea, tienen una combinación de las siguientes opciones de visualización adicionales:

      • Eje X: seleccione el atributo de datos que desea proyectar en el eje X.
      • Eje Y: seleccione el atributo de datos que desea proyectar en el eje Y. El eje Y soporta atributos de datos numéricos y solo se muestran.
      • Serie: seleccione el atributo de datos que desea trazar en series independientes en el gráfico. Esta opción también está disponible para un gráfico Gráfico circular.
      • Tamaño: seleccione un atributo de datos a cuyos valores desea asignar tamaño. Esta opción solo está disponible para un gráfico de burbujas.
      • Colorar por: seleccione el atributo de datos a cuyos valores desea asignar colores distintos. Normalmente, la opción Color por se utiliza junto con la opción Serie para asignar colores distintos a la serie independiente. Esta opción también está disponible para un gráfico Gráfico circular.
      • Título del eje X: especifique un título para el atributo de datos proyectado en el eje X.
      • Título del eje Y: especifique un título para el atributo de datos proyectado en el eje Y.
      • Leyenda: especifique la ubicación de la leyenda en el widget. Esta opción también está disponible para un gráfico Gráfico circular.
      • Pistas relacionadas: seleccione esta opción para correlacionar las pistas de todos los widgets basados en consultas del panel de control.
      • Cursor de datos: seleccione esta opción para ver la pista cuando pase el cursor sobre el widget.
      • Apilado: seleccione esta opción si desea apilar los atributos de datos que se muestran en el gráfico, por color.
      • Usar color sólido: cuando se utiliza un gráfico de área para la visualización, el área que representa la presencia de datos se cubre con un color sólido. Esta opción está seleccionada por defecto.

      Para obtener más información sobre las opciones de visualización en un creador de widgets basado en consultas, consulte Acerca de las opciones de visualización.

    • Configuración: revise y edite las entradas del widget, si es necesario.
  9. Haga clic en Guardar para guardar el widget en la biblioteca de widgets y agregarlo al panel de control.

A continuación, se muestra un escenario en el que las 5 transacciones principales del período de tiempo especificado se muestran mediante un gráfico de líneas. En el generador de widgets basado en consultas:

  1. Asegúrese de que el período de tiempo esté seleccionado en la esquina superior derecha.
  2. En la lista desplegable Origen de datos, seleccione Rastreos.
  3. En el campo Consulta, introduzca el siguiente rastreo y haga clic en Ejecutar.
    show traces OperationName as Transaction, avg(traceDuration) as Duration where pageviews > 0 group by OperationName order by count(*) first 5 rows timeseries
  4. Especifique lo siguiente en el separador Visualización:
    1. Seleccione el gráfico Línea como Tipo de gráfico.
    2. Seleccione timeseries.Duration en la lista desplegable Eje Y.
    3. Seleccione timeseries.date en la lista desplegable Eje X.
    4. Seleccione Transacción en la lista desplegable Serie.
    5. Seleccione Transacción en la lista desplegable Color por.

Se muestra un gráfico de líneas con las 5 transacciones principales.

Widget de rastreo basado en consultas