Métricas personalizadas

Acerca de las métricas personalizadas

Permita a los usuarios configurar cómo se recopilan las métricas para sus períodos en función de sus necesidades de informes.
Los usuarios pueden configurar sus propias definiciones de métricas según las propiedades de los períodos, lo que les permite configurar formas personalizadas de supervisar sus aplicaciones.
Las métricas personalizadas utilizan filtros de período para seleccionar los períodos para los que se van a calcular las métricas. Esto permite a los usuarios definir diferentes juegos de métricas para diferentes tipos de períodos.
Para los informes detallados, se pueden asignar dimensiones a las métricas, lo que permite agrupar y filtrar según esas dimensiones. Por ejemplo, los usuarios de informes por tipo de explorador o los artículos vendidos por país.
Las métricas personalizadas se configuran en el nivel de dominio de APM.

Casos de uso de ejemplo de métricas personalizadas

Ejemplo 1: cree una métrica para realizar un seguimiento del número de errores que se producen durante el paso de finalización de compra.

Para este caso de uso, debe identificar los períodos que han fallado durante el paso de finalización de compra. Suponiendo que la URL de la página de finalización de compra termine con checkout.jsp, puede definir un Span Filter que compruebe si el atributo HttpUrl termina con checkout.jsp y también compruebe si el atributo Error está definido en true.

HttpUrl like '%checkout.jsp' AND Error = 'true'

Como origen de valor, seleccione SpanErrorCount. Esto tendrá el valor 1 si se ha producido un error en la página y 0 en caso contrario. Además, puede ser interesante saber si los errores solo ocurren con exploradores específicos para que pueda agregar la dimensión BrowserName.

Ejemplo 2: creación de una métrica para realizar un seguimiento del tiempo de respuesta de la página inicial

En este escenario, queremos realizar un seguimiento del tiempo de respuesta de nuestra página inicial. Para ello, puede utilizar el origen del valor PageResponseTime. Puede configurar un Span Filter para que coincida con la página inicial denominada home.php.

HttpUrl like '%home.php' AND ApmrumType = 'PAGE'

Ahora, seleccione PageResponseTime para el origen de valor. Además, puede agregar dimensiones como considere oportunas. Por ejemplo, GeoCountry para obtener un desglose de los tiempos de respuesta por país.

Gestionar métricas personalizadas

Para crear una métrica personalizada para un dominio de APM deseado, haga lo siguiente:

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

Se muestra la página Detalles de dominio.
Vaya a Recursos, situado en la parte inferior izquierda, y haga clic en Métricas personalizadas.

Se muestra el panel Métricas personalizadas.
En el panel Métricas personalizadas, haga clic en Crear métrica personalizada.

Se muestra la ventana Crear métrica personalizada.
- Introduzca el nombre de la métrica de la nueva métrica personalizada.
- En el cuadro Filtro de intervalo, seleccione un filtro de intervalo predefinido (global) o un tipo en una definición de filtro de intervalo local.
- En la lista desplegable Origen de valor de métrica, seleccione una métrica.
- Opcional: en la lista desplegable Dimensiones, seleccione una o varias dimensiones. El número máximo de dimensiones es 10.
- Opcional: en la lista desplegable Unidad de métrica, seleccione una unidad de métrica.
- Opcional: haga clic en Validar métrica personalizada para comprobar si algún período ingerido recientemente coincide con el filtro de período configurado. La herramienta de validación permite comprobar los períodos ingeridos durante un máximo de 24 horas en el pasado.
- Haga clic en Siguiente para continuar con las opciones Seleccionar almacenamiento de métricas.
- En la lista desplegable compartimento, seleccione un compartimento.
- En el campo Espacio de nombres, introduzca un espacio de nombres.
  El espacio de nombres por defecto para todas las métricas personalizadas es oracle_apm_custom.
  
  Usar un espacio de nombres personalizado: si lo prefiere, puede proporcionar un espacio de nombres personalizado para que lo utilice la métrica personalizada.
  
  Al utilizar un espacio de nombres no por defecto, se necesita una política para crear el nuevo espacio de nombres.
  - En el campo Espacio de nombres, edite el valor por defecto e introduzca el espacio de nombres preferido.
  - Se muestra el mensaje Política necesaria para el nuevo espacio de nombres que indica que se necesita la siguiente política:
    Allow service applicationperformancemonitoring to manage metrics in compartment <compartment_name> where target.metrics.namespace=<custom_namespace_name>
    Por ejemplo:
    Allow service applicationperformancemonitoring to manage metrics in compartment ABC where target.metrics.namespace=namespace2
    La política anterior permite que el servicio OCI Application Performance Monitoring publique en el espacio de nombres personalizado.
    Están disponibles las siguientes opciones:
    
    Copiar política: la política se copia en el portapapeles y se debe crear manualmente mediante la consola de OCI.
    Utilice esta opción si no tiene permisos para crear políticas en OCI. En la mayoría de los casos, un usuario administrador necesita crear la política.
    
    Validar política: la política se valida mediante una métrica de prueba y comprobando los permisos en el espacio de nombres personalizado.
    
    Aplicar política: la política se crea automáticamente.
    Utilice esta opción si tiene permisos para crear políticas en OCI. Por ejemplo, si tiene permisos de administrador.
    Para obtener información sobre cómo crear políticas, consulte Creación de una política en la documentación de Identity Management.
- Opcional: en la lista desplegable Grupo de recursos, seleccione un grupo de recursos.
- Haga clic en Crear.
  Si el proceso de creación falla al utilizar el espacio de nombres personalizado, compruebe si el servicio Application Performance Monitoring tiene acceso para escribir en el espacio de nombres personalizado.

Utilice el menú de acción para editar o suprimir una métrica personalizada.

Si tiene una métrica personalizada existente y desea actualizarla para que empiece a utilizar un espacio de nombres personalizado (en lugar de utilizar el espacio de nombres por defecto oracle_apm_custom), asegúrese de que la política anterior se aplica al espacio de nombres personalizado.

Documentación de Oracle Cloud Infrastructure

Métricas personalizadas