• EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Editor de instrumentación personalizada: instrumento desde UI

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:

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:

  1. 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.

  2. 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.

  3. Amplíe los métodos individuales para localizar instrumentos no instrumentados. métodos.

  4. Para definir reglas de instrumentación para nodos particulares, seleccione Instrument o Ignore y personalice las reglas si es necesario.

  5. Para guardar su configuración, seleccione Confirm instrumentation changes.

  6. 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:

  1. Desde el editor de instrumentación personalizada, seleccione

    Add manual instrumentation

    para ingresar manualmente una clase y método para instrumentarlos o ignorarlos.

  2. Siga la instrumentación personalizada mediante reglas XML al definir sus puntos de instrumentación.

  3. 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

  • Seleccionar

    Disable instrumentation

    para inhabilitar temporalmente toda la instrumentación personalizada definida por UI .

  • Seleccione

    Enable instrumentation

    para volver a habilitar la configuración de instrumentación.

Importar instrumentación existente

Editar o eliminar puntos de instrumentación

No puede editar la instrumentación manual, solo eliminarla.

  • Seleccione

    Remove

    para dejar de instrumentar un método en particular.

  • Seleccione

    Edit

    para cambiar las reglas de instrumentación.

Ver historial de instrumentación

  • Puede ver cada iteración anterior de su instrumentación personalizada desde la pestaña

    Instrumentation history

    , incluido quién implementa los cambios y cuándo.

  • Puede restaurar una versión anterior seleccionando

    export

    para descargar una copia del archivo personalizado de instrumentación y luego importarlo al editor 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:

  • Name the transaction (transaction name)

    : Anula el nombre de transacción estándar, definido por las reglas de nomenclatura automática. En su lugar, la UI utilizará el nombre indicado.

  • Start the transaction when this method executes

    : En lugar de incluir métricas de esta métrica dentro de su transacción principal, cree una nueva transacción para este método. El comportamiento del agente con esta opción depende de si existe una transacción preexistente en el hilo.

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 Transaction evento.

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 common: de su newrelic.yml:

reinstrument:
attributes_enabled: true

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:

  1. El agente ignora el indicador

    Start the transaction

    .

  2. El agente incluye la clase/método en la transacción preexistente.

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:

  1. El agente descubre que no hay ninguna transacción actual.
  2. El agente crea una nueva transacción comenzando con la clase/método que usted ha instrumentado.

Si una transacción no está en ese hilo y el indicador Start the transaction no está marcado:

  1. El agente busca una transacción en ese hilo y no encuentra ninguna.
  2. La métrica se elimina.
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.