Los atributos definidos en el agente de explorador de APM se agregan a los períodos que el agente de explorador carga en el servicio APM.

Los atributos de texto personalizados del agente de explorador de APM se representan como dimensiones en el explorador de rastreo y también se pueden utilizar para definir grupos de métricas. Los atributos numéricos personalizados del agente de explorador de APM se representan como métricas en el explorador de rastreo. Los atributos numéricos se pueden agregar y utilizar en las alertas del servicio Monitoring. Para obtener más información sobre las dimensiones del explorador de rastreo, consulte Acerca de los atributos de rastreo y período.

Configurar atributos personalizados

Los atributos personalizados se pueden agregar más fácilmente mediante la propiedad udfAttributes del objeto apmrum.

Cada vez que el código de agente del explorador crea un intervalo, estos datos se consultan y se utilizan para rellenar el intervalo con los atributos deseados. La definición puede ser una cadena, un número o una función (que devuelve una cadena o un número).

Cuando se utiliza una función, esa función se ejecutará cada vez que se cree el intervalo y se necesite el valor del atributo. Se requiere atención al detalle cuando se utilizan funciones para evitar un impacto negativo en el rendimiento.

Ejemplo de configuración simple

window.apmrum.udfAttributes = [
    { name: 'mySiteId', value: "TheWebSiteId" },
    { name: 'resultsOnPage', value: 123 },

     // calling a user-supplied javascript function to calculate shopping cart totals
    { name: 'shoppingCart', value: () => { productsInBasket(); } }
];

Es importante tener en cuenta que algo como productNumber no se debe proporcionar como un número, sino que se debe utilizar como una cadena, para permitir la selección de productos específicos, así como la agrupación por el producto. Por ejemplo, cuando productid o productNumber está disponible en javascript como campo numérico, se debe convertir en una cadena para garantizar que Application Performance Monitoring la maneje correctamente.

Ejemplo de configuración compleja

window.apmrum.udfAttributes = [
    { name: 'myDynamicSiteId', value: () => window.apmrum.tmpSiteId },
    { name: 'curProductNumber', value: '123456' },
];

// on other locations in the code:
window.apmrum.tmpSiteId = 'siteA';

 // on some other locations in the code
window.apmrum.tmpSiteId = 'siteB';

La implantación más clara es que los atributos se generen en un solo lugar. Si un valor concreto se conoce o se define como algún estado durante llamadas específicas, se pueden asignar a una propiedad en el objeto apmrum que empiece por ‘tmp’ en el nombre. Este valor se puede seleccionar en udfAttributes para informar el valor. Cuando el valor es ‘undefined’, la propiedad no se enviará.

Limitaciones

Los datos facilitados se limitan a garantizar que la información al respecto tenga sentido. El objetivo principal es garantizar que los datos arbitrarios no se transfieran accidentalmente.

Configuración de atributo de nombre de usuario

Debe definir el atributo apmrum.username para activar el filtrado de datos de Supervisión de usuario real por nombre de usuario.

Configurar atributos personalizados en entornos heredados

Si ha migrado desde el producto Oracle Management Cloud Application Performance Monitoring al servicio Oracle Cloud Infrastructure (OCI) Application Performance Monitoring, puede utilizar las mismas propiedades en la configuración de OCI que se muestran en esta sección.

Los valores de estos atributos proporcionan una perspectiva más cercana del rendimiento de la aplicación en el sitio del usuario. Estos atributos se muestran como dimensiones en la interfaz de usuario de Application Performance Monitoring, que se pueden utilizar para filtrar datos. Para agregar los atributos, incluya el siguiente código JavaScript en las páginas que desea supervisar:

apmrum.udfAttribute1 = function()
{
    // return desired value of attribute 1
    return "Attribute value 1"; 
};
apmrum.udfAttribute2 = function()
{
    // return desired value of attribute 2
    return "Attribute value 2"; 
};

Por defecto, attribute1 se rellenará con el directorio de nivel superior de la URL y attribute2..9 permanecerá vacío y podrá configurarlo. En Application Performance Monitoring, puede configurar hasta nueve atributos.

Por ejemplo, en la URL https://www.sample.com/calendar/render, attribute1 se rellenará con la cadena calendar.

El título del documento de la página de aplicación y el texto visible para el usuario pueden ser útiles en la generación de informes, pero pueden contener información de identificación personal (PII) que no está permitido capturar por defecto. Si desea capturar esos valores, puede utilizar la configuración trackScreenText, que se debe definir de forma explícita en un valor verdadero mediante lo siguiente: window.apmrum.trackScreenText=true.

El título de página se puede redefinir definiendo el atributo apmrum.udfAttributeDt. En los informes de contexto, los datos de attribute1 son más genéricos, los de udfAttributeDt son más específicos (nivel de página) y los de apmrum.udfAttribute2 se supone que apuntan a/describen aproximadamente el área de una pantalla activa durante una llamada AJAX o el área en la que se hace clic.

La lógica de nomenclatura de elementos se puede redefinir mediante la configuración del atributo getElmLabelFn. Esta función recibe el elemento (destino de evento) en el que el usuario hizo clic o que activó como argumento. Al utilizar el atributo getElmLabelFn, tiene más control sobre la información notificada y reduce el riesgo de exponer accidentalmente la PII.

A continuación le mostramos un ejemplo:

apmrum.trackScreenText=true;
apmrum.udfAttributeDt = function()
{     
    // return desired value of page title
    return "New Page Title";
};
apmrum.getElmLabelFn = function(e)
{
    // return desired value for element
    return "elm: "+e.tagName+"["+e.id+"]"; 
}