El editor de instrumentación personalizada de New Relic permite al usuario de la aplicación Java implementar instrumentación personalizada a través de la interfaz de usuario de New Relic. El editor es la opción preferida cuando no puedes modificar el código de tu aplicación y no tienes tantos métodos para tocar. Consulte Instrumentación personalizada de Java para conocer otras opciones de instrumentación y los motivos para utilizar cada una.
Para utilizar el editor de instrumentación personalizado: Vaya a one.newrelic.com > All capabilities > APM & services > (select a Java app) > Settings > Instrumentation. Utilice el editor de instrumentación personalizada para:
- Instrumento un framework sin soporte.
- Obtenga información adicional valiosa con métodos no instrumentados.
- Ignorar transacción particular.
Requisitos
Para utilizar el editor de instrumentación personalizada es necesario cumplir con los siguientes requisitos:
Requirement | Comments |
|---|---|
Agente | Agente de Java versión 3.17.0 o superior |
Seguridad | El usuario del modo de alta seguridad debe exportar su instrumentación e importarla manualmente a su servidor de aplicaciones. |
Definir instrumentación personalizada
Para definir instrumentación personalizada desde la interfaz de usuario de New Relic, utilice una sesión de creación de perfiles de subprocesos para recopilar un rastreo detallado de la pila de cada subproceso en su aplicación. Si es posible, pruebe su instrumentación personalizada en un entorno previo de producción antes de cambiar las reglas de instrumentación en su aplicación de producción.
En cualquiera de los entornos, utilice el editor de instrumentación personalizada para definir los métodos que desea instrumentar y aplicar sus cambios:
Crear un nuevo hilo de sesión generador de perfiles. Para asegurarse de recopilar suficiente conjunto de datos, la duración de la sesión debe ser de al menos dos minutos.
Vaya a one.newrelic.com > All capabilities > APM & services > (select an app) > Settings > Instrumentation. Desplácese hasta la parte inferior de la página hasta que vea la lista Recently collected thread profiles y luego seleccione el perfil del hilo más reciente.
Amplíe los métodos individuales para localizar instrumentos no instrumentados. métodos.
Para definir reglas de instrumentación para nodos particulares, seleccione Instrument o Ignore y personalice las reglas si es necesario.
Para guardar su configuración, seleccione Confirm instrumentation changes.
desplegar tus cambios desde la páginaInstrumentation :
Para desplegar sus cambios automáticamente, seleccione
Deploy instrumentation changes
.
Para implementar sus cambios manualmente, seleccione
Export XML
y consulte cómo exportar su instrumentación.
Advertencia
Evite el exceso de instrumentación siempre que sea posible. Con cada método adicional que se instrumente, el agente utilizará más recursos y su aplicación incurrirá en más gastos generales. Además, desplegar su instrumentación provocará un breve período de mayores gastos generales. Esto puede ralentizar notablemente las solicitudes de aplicaciones durante varios segundos.
Si aplicó sus cambios desde la UI, el agente comenzará a instrumentar sus métodos dentro de unos pocos ciclos de recolección (normalmente unos minutos).
Instrumentación manual mediante el editor.
También puede crear puntos de instrumentación directamente en el editor sin utilizar un perfil de hilo:
Desde el editor de instrumentación personalizada, seleccione
Add manual instrumentation
para ingresar manualmente una clase y método para instrumentarlos o ignorarlos.
Siga la instrumentación personalizada mediante reglas XML al definir sus puntos de instrumentación.
Despliega tus cambios desde el editor de instrumentación.
El uso de este método para agregar instrumentación expone una funcionalidad adicional más allá de lo que está disponible en un perfil de subproceso. Además de hacer coincidir métodos por firma, también puede instrumentar métodos por tipo de retorno, métodos en interfaces y por anotación Java.
Estos tipos de instrumentación más complejos se pueden crear y eliminar en el editor, pero no editarse.
Importante
Si un método está marcado como Instrumentation not allowed, siga los procedimientos de resolución de problemas de New Relic para instrumentación personalizada.
Desplegar cambios manualmente
También puede utilizar el editor de instrumentación personalizada para crear un conjunto de instrumentación personalizada, luego exportar un archivo de instrumentación e importarlo manualmente a su servidor de aplicaciones. Esto es necesario para el usuario del modo de alta seguridad.
Para exportar su instrumentación, defina instrumentación personalizada a través de la UI. Luego seleccione Export xml en la página Instrumentation e importe el archivo en su servidor de aplicaciones.
Funciones de página
La página Instrumentation admite la siguiente característica:
Si quieres... | Hacer esto... |
|---|---|
Pausar o desactivar la instrumentación personalizada |
|
Importar instrumentación existente |
|
Editar o eliminar puntos de instrumentación | No puede editar la instrumentación manual, solo eliminarla.
|
Ver historial de instrumentación |
|
Opciones de instrumentación
Puedes definir las siguientes opciones con el editor de instrumentación personalizada:
Instrumentation options | Comments |
|---|---|
Métodos de instrumentos | Comience a instrumentar el método seleccionado. Los métodos instrumentados serán visibles en la UI de New Relic. Instrument admite las siguientes opciones secundarias:
|
Informe atributo personalizado | El parámetro del método se puede capturar como atributo en una transacción. New Relic informa estos atributos a la traza de la transacción, errores de traza y Por motivos de seguridad, la captura de atributos personalizados mediante el Editor de instrumentación personalizada es disabled de forma predeterminada y no se puede habilitar mientras se utiliza el modo de alta seguridad. Si desea reportar atributo personalizado usando el editor de instrumentación personalizada y no desea que el agente de Java esté en modo de alta seguridad, desactive el modo de alta seguridad y luego agregue el siguiente texto en el bloque |
Ignorar transacción | Ignore este método por completo. El agente no informará métricas de este método y el método no contribuirá a los cálculos de Apdex. |
Resultados con opción "iniciar"
Si selecciona Instrument methods > Start the transaction when this method executes, el comportamiento del agente depende de si hay una transacción preexistente en el hilo.
Cuando la clase o método está instrumentado:
¿Está marcada la bandera "Start the transaction" ? | |
|---|---|
Yes | No |
Si una transacción preexistente is en ese hilo y el indicador Start the transaction is están marcados:
| Si una transacción preexistente is en ese subproceso y el indicador Start the transaction no está marcado, el agente incluye la clase/método en la transacción preexistente. |
Si una transacción no está en ese hilo y la Start the transaction bandera is está marcada:
| Si una transacción no está en ese hilo y el indicador Start the transaction no está marcado:
|