Enriquecimiento de período

Acerca del enriquecimiento de períodos

Proporcione a los usuarios la capacidad de enriquecer períodos con atributos personalizados o cambiar, combinar o eliminar datos de atributos existentes.
Las operaciones de enriquecimiento se definen mediante reglas de período que contienen una o más acciones que se aplicarán en un orden concreto en un período determinado.
Hay dos tipos de reglas de período: personalizadas y proporcionadas por Oracle.
El enriquecimiento de período se configura en el nivel de dominio de APM.

Ejemplos de enriquecimiento de período:

Eliminación de información de identificación personal (PII) de períodos.
Combine datos de varios atributos en uno solo.
Extrae datos de un atributo. Por ejemplo, una ruta parcial de una URL más larga.
Aplicar funciones matemáticas a los datos. Por ejemplo, convierta una unidad de segundos a milisegundos.
Asignar un valor de atributo a un nuevo valor. Por ejemplo, asigne el valor '1' al color 'azul', el valor '2' al color 'rojo'.
Distribuir valores numéricos en bloques. Por ejemplo, un rango de valores de temperatura que se asigna a cubos 'fríos', 'calientes' y 'calientes'.

Temas:

Uso de enriquecimiento de período

El enriquecimiento de período se configura mediante reglas de período que funcionan en un período y se utilizan para modificar los atributos del período. La caja de herramientas de reglas de período proporciona una variedad de acciones que se pueden realizar como parte de una regla.

Las reglas de período se gestionan dentro de grupos. Un grupo es una recopilación de reglas que se aplican en un orden especificado. Cada regla puede aplicar una o más acciones en un período y la salida de cada regla se puede utilizar como entrada para las reglas de seguimiento. Los grupos de reglas necesitan un filtro de período que se utilice para seleccionar los períodos en los que aplicar las reglas.

Se pueden definir varios grupos. Esto resulta útil cuando necesita mantener diferentes tipos de reglas para diferentes tipos de períodos, ya que crea entidades lógicas con una funcionalidad diseñada para un propósito específico. Esto reduce la complejidad general del juego de reglas.

Si varios grupos tienen configurados filtros de período que coinciden con el mismo período, todos ellos aplicarán sus reglas a ese período. El orden en el que se realiza está determinado por el orden alfabético de los nombres de grupo. Tenga esto en cuenta al asignar un nombre o cambiar el nombre a los grupos. Oracle recomienda anteponer los nombres con un número para evitar que los nombres de grupo se ordenen alfabéticamente. Por ejemplo, "1". Eliminar datos de ubicación", "2. Convertir unidades de longitud".

Tenga en cuenta que cuando varios grupos están funcionando en el mismo período, esto significa que cada grupo estará funcionando en una versión del período que puede haber sido modificado por un grupo anterior en la cadena. Esto puede resultar útil, ya que puede escribir reglas en grupos de seguimiento que dependen de modificaciones creadas por grupos anteriores. Por otro lado, también puede provocar que las reglas de seguimiento fallen si un atributo en el que se basa una regla, es eliminado o modificado por un grupo anterior.

Nota

Lo anterior sólo es importante cuando un período coincide con más de un grupo.

Si los grupos tienen filtros claramente separados, un único grupo modificará siempre un período y las consideraciones anteriores dejarán de ser relevantes.

Atributos en eventos de período

Los períodos pueden contener una lista de eventos a los que también se hace referencia como mensajes de log. Normalmente se utilizan para almacenar información sobre momentos importantes durante la ejecución del período. Por ejemplo, si un período describe una consulta de base de datos, se pueden generar eventos para marcar el momento en el que se abrió la conexión, cuándo se envió realmente la solicitud de consulta y cuándo se recibió la respuesta.

Un evento se identifica mediante name, timestamp y un juego de attributes (pares clave-valor) que proporcionan más contexto para la información registrada.

Todas las acciones de regla de intervalo que se describen a continuación, que requieren un atributo como entrada o salida, también se pueden aplicar a los atributos de eventos individuales. Dado que los atributos de evento son independientes de los atributos de período normales, deberá utilizar la siguiente sintaxis event reference para identificar el atributo de evento adecuado:

event['NameOfEvent']:'NameOfAttribute'.

Nota

Los atributos de evento no se pueden utilizar como filtros de período.

Crear y gestionar reglas de período

Puede crear y gestionar Reglas de expansión en función de sus necesidades de generación de informes.

Para crear Reglas de expansión para un dominio de APM determinado, haga lo siguiente:

Vaya a la página Dominios de APM y haga clic en el dominio APM deseado.

Se muestra la página Detalles.
Vaya a Recursos, ubicado en la parte inferior izquierda, y haga clic en Enriquecimiento de intervalo.

Se muestra el panel Enriquecimiento de intervalo.
Haga clic en Crear grupo para crear un nuevo grupo de reglas de período.
Se muestra el panel Crear grupo de reglas de período.
- Introduzca el nombre del nuevo grupo.
- Seleccione un filtro de intervalo para utilizarlo con este grupo.
- También puede proporcionar una descripción para el nuevo grupo.
- Haga clic en Siguiente para continuar con el panel Acciones de regla para empezar a agregar reglas de período al nuevo grupo según el tipo de regla de período: Regla de período personalizada o Regla de período proporcionada por Oracle.
- Introduzca el nombre de regla.
- Opcionalmente, seleccione un filtro de período de reglas para reducir aún más el ámbito de la operación de la regla.
  
  Nota
  
  Los filtros de período se crean por separado. Para obtener más información, consulte Filtros de expansión.
- También puede proporcionar una descripción de regla.
- Seleccione un tipo de regla de período.
  - Si selecciona Regla de período proporcionada por Oracle, se le ofrecerá una lista de reglas entre las que elegir.
    
    Oracle ya ha creado las reglas para ayudar a los usuarios. La lista incluye lo siguiente:
    Agrega la dirección IP del cliente a un intervalo.
    Agrega la dirección IP del cliente a un intervalo como un atributo denominado ClientIP.
    
    Suite EBS.
    Proporciona la plantilla de E-Business Suite.
    
    Conversión de nomenclatura de OpenTelemetry a APM.
    Convierte los nombres de atributo span de la convención de nomenclatura OpenTelemetry a la convención de nomenclatura APM. Para obtener información sobre el uso de OpenTelemetry con APM, consulte Configuración de orígenes de datos OpenTelemetry.
    Haga clic en una regla de la lista para agregarla al grupo.
    
    Nota
    
    No puede configurar ninguna acción porque la propia regla la gestiona internamente. Además, no puede ver cuáles son las acciones para una regla proporcionada por Oracle.
  - Si selecciona crear una regla de período personalizado, debe definir una o más acciones para ella. (Una regla siempre contiene al menos una acción).
    Para poder seleccionar una Acción, debe seleccionar un destino de acción y un tipo de acción.
    
    El destino de acción especifica la parte del período en el que opera la acción. Hay dos destinos disponibles:
    
    Entidad: dirija todo el período.
    
    Atributo: dirija un solo atributo.
    
    El tipo de acción especifica el tipo. Se utiliza principalmente para agrupar acciones de forma lógica. Por ejemplo, cadena o numérica.
    
    A continuación, seleccione la acción adecuada en la lista desplegable Acciones disponibles.
    Dado que las acciones tienen varios contextos, la ventana cambiará en consecuencia con cada tipo de acción. Para obtener más información sobre las acciones, consulte Trabajo con Acciones.
    Para obtener más información sobre las acciones disponibles para destino de acción y Tipo de acción, consulte Acciones disponibles.
    Utilice el botón Agregar acción para agregar más acciones a la regla.
    
    Utilice el menú de elementos de acción situado en la parte superior derecha de cada acción para moverlo hacia arriba o hacia abajo en el orden de reglas, o bien suprima una acción.

Trabajo con Acciones

Las acciones que tienen un destino de Atributo siempre necesitan que proporcione el nombre del atributo cuyo valor se utilizará como entrada para la acción. La ventana de configuración de cada acción hace referencia a ella como Input Attribute.

Algunas acciones también necesitan que proporcione el nombre de un atributo en el que almacenar el resultado de la operación. Esto se denomina Output Attribute. Si el atributo existe en el período, cualquier valor que tenga en ese momento se sobrescribirá con el resultado de la acción. Si aún no existe, se agregará al período con el nuevo valor. Puede utilizar este mecanismo para sustituir el valor de cualquier atributo del intervalo (incluso el atributo de entrada) por el resultado de la operación de la acción.

Con esto, puede introducir los resultados de cualquier acción en una acción de seguimiento (o incluso en una regla dentro del mismo grupo de reglas).

También se puede utilizar para almacenar valores en atributos temporales que se pueden utilizar mediante acciones o reglas de seguimiento, pero sin necesidad de mantenerlos como parte del resultado final. Asegúrese de eliminar los atributos temporales como último paso mediante la acción Eliminar atributo.

Nota

Una acción Bloquear rechaza el período y no puede utilizarlo más adelante, incluso desde otro grupo de reglas.

Acciones disponibles

Objetivo de la Acción	Tipo de acción	Acciones disponibles
Entidad	Transferencia Acciones que controlan si el período en su totalidad se pasa o se bloquea. Los períodos bloqueados se rechazan desde el pipeline de procesamiento. Los períodos rechazados ya no serán procesados por APM, no se almacenarán en ningún lugar y no estarán disponibles para su visualización más adelante en otras herramientas o paneles de control de APM.	Bloquear: bloquea este período sin condiciones. No se aplicará ninguna acción ni regla de seguimiento y el período ya no estará disponible en los productos y herramientas de OCI de APM. Ejemplo: las muestras (aceptados) abarcan un porcentaje de muestra. Por ejemplo, un porcentaje de muestra del 25% aceptará (aleatoriamente) el 25% de todos los períodos y bloqueará el resto. Los períodos bloqueados aquí se tratan del mismo modo que los períodos bloqueados por la acción Bloquear.
Atributo	Cadena Acciones que permiten varias operaciones en el valor del atributo que es una cadena. Por ejemplo, cambiar el caso, sustituir un valor o extraer una parte de la cadena.	Agregar: agrega una cadena estática al valor de un atributo mediante una cadena de separador opcional. Concatenar: concatena dos valores de atributo. Se puede proporcionar una cadena de separador opcional en la que se unirán los valores. El resultado se devuelve como un nuevo atributo. Extraer: extrae una parte del valor de un atributo en función de una expresión regular. El resultado se devuelve como un nuevo atributo. La expresión regular debe contener un operador de grupo de captura que identifique la parte de la cadena que se va a capturar. Si la expresión regular no coincide o no hay ningún grupo de captura, la acción no producirá ninguna salida. Opcionalmente, puede proporcionar un valor de reserva, que se utilizará como salida de la acción en caso de que la extracción en sí no produzca ningún resultado. Minúsculas: convierte el valor de un atributo a minúsculas. Buscar y sustituir: sustituye una o más partes del valor de un atributo mediante una expresión regular. La cadena modificada se devuelve como un nuevo atributo. La expresión regular puede contener un grupo de captura. Sin un grupo de captura, se sustituirá el contenido completo de las coincidencias de la expresión. Cuando hay un grupo de captura, solo se sustituirá el contenido capturado por el grupo. La incidencia de coincidencia opcional se puede utilizar si solo se debe sustituir una incidencia específica de una coincidencia. Si no se establece, o se establece en 0, todas las incidencias coincidentes se reemplazarán. Este es el comportamiento predeterminado. Recortar: Recorta cualquier espacio inicial y final del valor de un atributo. Mayúsculas: convierte el valor de un atributo a mayúsculas.
Atributo	Numérico Acciones que permiten varias operaciones matemáticas en los valores de atributo (siempre que sean números). Las acciones numéricas soportan números y números reales representados como cadenas en el valor de atributo, es decir, los dos siguientes son equivalentes: "importe" : 2,5 "importe" : "2.5" Las acciones numéricas pueden tomar como entrada una cadena que represente el nombre de un atributo cuyo valor se va a utilizar en la operación o un número que se utilizará directamente en el cálculo. Todas las acciones numéricas tienen una opción en la que puede aplicar el redondeo al valor de salida. El redondeo puede ser uno de los siguientes: Redondeo: redondea el número hacia arriba o hacia abajo al número entero más cercano. Piso: redondea el número hacia abajo al número entero más cercano. Encillo: redondea el número hasta el número entero más cercano. Sin redondeo: opción por defecto.	Absoluto: devuelve el valor absoluto del valor de entrada. Agregar: suma dos valores. Bucketizar: se asigna un valor de atributo numérico a nombres de cubo. Si el valor del atributo está dentro del rango de un cubo, se devolverá el nombre del cubo. Si no hay ningún cubo coincidente, se devolverá un valor de reserva. Dividir: divide el primero por el segundo valor. Si el segundo valor es 0, el resultado será 0. Máximo: devuelve el máximo de los dos valores. Mínimo: devuelve el mínimo de los dos valores. Multiplicar: multiplica los dos valores. Negado: alterna (cambia el signo) del valor. Restar: resta el segundo del primer atributo.
Atributo	Genérico Las acciones genéricas proporcionan operaciones de nivel de atributo, como la eliminación de un atributo del período.	Asignar valor de atributo: toma el valor de un atributo y lo asigna a un nuevo valor. Eliminar atributo: elimina el atributo del período. Si el atributo es una referencia de nombre de evento, `event['EventName']`, se eliminará todo el evento de período. Cambiar nombre de atributo: cambia el nombre del atributo. Definir atributo: establece un atributo en un valor estático. Si el atributo no existe, se agrega; de lo contrario, se le asigna el nuevo valor, sobrescribiendo el existente.

Ejemplos de configuración de acciones

En esta sección, se proporcionan ejemplos de los pasos de configuración necesarios para algunas acciones individuales.

Ejemplo de Bucketización:
Esta acción utiliza un minieditor para configurar un número de cubos y sus valores de umbral. Puede utilizar el control de la derecha para crear, actualizar y eliminar cubos.

Los bloques se ordenan automáticamente según sus valores de umbral. Se utiliza un valor de reserva cuando un valor es demasiado grande para el último cubo. En la siguiente imagen se muestra un ejemplo con cinco cubos y un valor de reserva:
Ejemplo de Mapa:
Esta acción utiliza un minieditor para configurar la asignación de pares de valores de entrada/salida. Ambos valores pueden ser números o cadenas. Utilice el control de la derecha para crear, actualizar o eliminar una asignación.
El botón Exportar permite descargar cualquier asignación a un archivo (en formato CSV) en su equipo.
El botón Importar permite rellenar las asignaciones de un archivo CSV en la computadora. Esto resulta especialmente útil si tiene un gran número de asignaciones.

Validación de reglas de enriquecimiento de período

Las configuraciones de enriquecimiento de períodos pueden ser complejas de escribir y, a veces, puede ser difícil saber de antemano si una regla o un grupo de reglas funcionarán como se esperaba. Para ayudar con esto, el Editor de configuración de enriquecimiento de intervalo proporciona una opción para probar una regla o un grupo de reglas en un período de ejemplo antes de guardarlo.

Para utilizar la opción de prueba, haga lo siguiente:

Seleccione un grupo y, a continuación, haga clic en Editar para abrir el panel Editar grupo de reglas de período. Otra forma es crear un nuevo grupo y se muestra el panel Editar.
Haga clic en el paso Configurar acciones de regla.
Haga clic en Probar para probar todo el grupo de reglas. También puede seleccionar la regla y hacer clic en Probar regla para probar una regla individual.
Nota

La regla de prueba no está disponible cuando el grupo de reglas solo contiene una regla.
Se muestra el panel Grupo de reglas de período de prueba.
Las reglas que se van a probar se mostrarán con una casilla de control junto a ellas. Puede alternar las opciones que desee.
Introduzca un intervalo de ejemplo en el cuadro de texto Ejemplo de intervalo.
Haga clic en Probar período para realizar una prueba de las reglas seleccionadas en el período especificado.

Figura 9-1 Validación de regla de enriquecimiento de intervalo

Validación de regla de enriquecimiento de período

La ejecución de prueba informará si el período coincide con los filtros de período configurados o no.

Si los filtros coinciden, las reglas se aplicarán al intervalo y las diferencias resultantes (si las hay) se mostrarán en la siguiente tabla. Los atributos que se hayan agregado como resultado de la regla se resaltarán en verde. Los atributos que se hayan eliminado se resaltarán en rojo. Los atributos modificados se resaltarán en amarillo.

Explorador de rastreo: para obtener ejemplos precisos de períodos del tráfico, haga clic en el Explorador de rastreo situado en la parte superior derecha para abrir el explorador de rastreo y ver los períodos reales que se han procesado. Puede seleccionar un período, abrir el menú contextual de la derecha (los tres puntos verticales) y hacer clic en Copiar datos de período raíz.

Se muestra una ventana emergente con el contenido del período. Puede copiar los datos de período y utilizarlos durante las pruebas.

Otra opción es pegar sus propios períodos o introducirlos manualmente, siempre que se ajusten al formato de período según lo informado por Trace Explorer.

Alias de Propiedades de Intervalo

Nota

Algunas de las propiedades de período reales tienen un nombre diferente cuando se utilizan en las funciones Enriquecimiento de intervalos o Filtros de intervalos. Aparte de la diferencia visual, esto no afecta a la configuración de las reglas y los filtros. Por ejemplo, siempre debe utilizar el alias al hacer referencia a la propiedad determinada.

Estas son las propiedades que actualmente tienen un alias:

Propiedad de período	Alias de enriquecimiento de período	Observaciones
`td-micros`	`SpanDuration`	`td-micros` está en microsegundos, mientras que `SpanDuration` está en milisegundos. La conversión de unidad de tiempo se aplica automáticamente mediante los filtros de intervalo y enriquecimiento.
`name`	`OperationName`	El nombre del intervalo representa la operación realizada
`ts-micros`	`StartTime`	`ts-micros` está en microsegundos, mientras que `StartTime` está en milisegundos. La conversión de unidad de tiempo se aplica automáticamente mediante los filtros de intervalo y enriquecimiento.
`id`	`SpanId`
`parent-id`	`ParentId`
`trace-id`	`TraceId`

Documentación de Oracle Cloud Infrastructure

Enriquecimiento de período