Guía para utilizar la API agente de Java

Crea un Transaction cuando New Relic no crea uno automáticamente

@Trace(dispatcher = true) sobre el método que engloba el trabajo a reportar. Cuando esta anotación se utiliza en un método dentro del contexto de una transacción existente, esto no iniciará una nueva transacción, sino que incluirá el método en la transacción existente.

Captura la duración de un método que New Relic no traza automáticamente

@Trace() en el método que desea cronometrar.

Establecer el nombre de la corriente Transaction

NewRelic.setTransactionName(...)

Inicie el cronómetro para el tiempo de respuesta del Transaction actual y para hacer que un Transaction que cree se informe como una transacción Web , en lugar de como una transacción Other .

NewRelic.setRequestAndReponse(...)

Agregue un atributo personalizado a Transactions y TransactionEvents

NewRelic.addCustomParameter(...)

Agrega seguimiento de usuarios a Transactions configurando el atributo de agente enduser.id .

NewRelic.setUserId()

Evitar que un Transaction sea reportado a New Relic

NewRelic.ignoreTransaction()

Excluye un Transaction al calcular la puntuación Apdex de tu aplicación

NewRelic.ignoreApdex()

Traza un método asíncrono si está vinculado a un Transaction existente...

@Trace(async = true)

Vincular el Transaction asociado con el Token en el hilo actual...

Token.link() o Token.linkAndExpire()

Caducar un Token asociado con el Transaction actual...

Token.expire()

Deje de cronometrar un Segment y haga que se informe como parte de su padre Transaction

Segment.end()

Dejar de cronometrar un Segment y no informarlo como parte de su padre Transaction

Segment.ignore()

Obtenga información sobre los encabezados de tipo específico de un mensaje entrante o saliente.

Headers

Para una implementación proporcionada de Headers use ConcurrentHashMapHeaders.

Vea un ejemplo de implementación de encabezados W3C Trace Context en el uso de la API de DT con Kafka.

Cree e inserte encabezados de rastreo distribuido en una estructura de datos Headers . Esta API insertará encabezados newrelic y W3C Trace Context (traceparent y tracestate), a menos que el agente esté configurado explícitamente para excluir los encabezados newrelic .

Transaction.insertDistributedTraceHeaders(Headers)

Para obtener más información sobre cómo obtener referencias a la transacción actual y otras clases de API, consulte Obtener referencias.

Acepte los encabezados de rastreo distribuido enviados desde el servicio de llamadas y vincule estos servicios en un rastreo distribuido.

Transaction.acceptDistributedTraceHeaders(TransportType, Headers)

Para obtener más información sobre cómo obtener referencias a la transacción actual y otras clases de API, consulte Obtener referencias.

Comprenda una clase de utilidad que proporciona constantes de enumeración para definir el tipo de transporte al aceptar encabezados distribuidos de rastreo.

Agregar atributo personalizado a SpanEvents en rastreo distribuido

NewRelic.getAgent().getTracedMethod().addCustomAttribute(...)

Cree una carga útil para enviarla a un servicio llamado.

Transaction.createDistributedTracePayload()

Para obtener más información sobre cómo obtener referencias a la transacción actual y otras clases de API, consulte Obtener referencias.

Aceptar una carga útil enviada desde el primer servicio; esto unirá estos servicios en una traza.

Transaction.acceptDistributedTracePayload(...)

Para obtener más información sobre cómo obtener referencias a la transacción actual y otras clases de API, consulte Obtener referencias.

Carga utilizada para conectar servicios. La llamada text() devuelve una representación de cadena JSON de la carga útil.

DistributedTracePayload.text()

Carga utilizada para conectar servicios. La llamada httpSafe() devuelve una representación de cadena JSON codificada en base64 de la carga útil.

DistributedTracePayload.httpSafe()

Traza a través de un canal de transporte personalizado que New Relic no admite de forma predeterminada, como un transporte RPC propietario

Transaction.getRequestMetadata(), .processRequestMetadata(...), .getResponseMetadata(), .processResponseMetadata(...)

Consulte también la información de este documento sobre el uso Transaction para obtener referencias a las clases de API de New Relic.

Ver o cambiar el nombre de la métrica o el nombre de una métrica acumulada de un TracedMethod

(El nombre de una métrica acumulada, como OtherTransaction/all, no tiene como ámbito una transacción específica. Representa todas las transacciones en segundo plano.)

TracedMethod.getMetricName(), .setMetricName(...), .setRollupMetricName(...)

Consulte también la información de este documento sobre el uso TracedMethod para obtener referencias a las clases de API de New Relic.

Informar una llamada a un servicio HTTP externo, servidor de base de datos, cola de mensajes u otro recurso externo que se está trazando utilizando la anotación@Trace del agente de Java API

TracedMethod.reportAsExternal(...) pasando argumentos construidos usando el constructor ExternalParameters .

Consulte también la información de este documento sobre el uso TracedMethod para obtener referencias a las clases de API de New Relic.

Habilite y agregue seguimiento de aplicaciones múltiples cuando se comunique con un servicio HTTP o JMS externo instrumentado por New Relic

TracedMethod.addOutboundRequestHeaders(...) junto con TracedMethod.reportAsExternal(...)

Consulte también la información de este documento sobre el uso TracedMethod para obtener referencias a las clases de API de New Relic.

Agregar tiempo para un servidor de aplicaciones o despachador que no es compatible automáticamente

Transaction.setRequest(...), Transaction.setResponse(...), o NewRelic.setRequestAndResponse(...), y Transaction.markResponseSent()

Consulte también la información de este documento sobre el uso Transaction para obtener referencias a las clases de API de New Relic.

Obtener una referencia a la actualidad Transaction

NewRelic.getAgent().getTransaction()

Obtenga un Token para vincular trabajo asincrónico

Comience y obtenga una referencia a un Segment

Obtener una referencia del método que se está trazando actualmente.

NewRelic.getAgent().getTracedMethod()

Obtener una referencia al logger Agent

NewRelic.getAgent().getLogger()

Obtener una referencia a la configuración Agent

NewRelic.getAgent().getConfig()

Obtenga una referencia a un agregador de métrica personalizada

NewRelic.getAgent().getAggregator()

Obtener una referencia a Insights (nuestro nombre original de la característica que regía el evento personalizado) para registrar el evento personalizado.

NewRelic.getAgent().getInsights()

Establecer explícitamente la información de puerto, nombre y versión para un servidor de aplicaciones o despachador y el nombre de instancia para una JVM

Informar un error que New Relic no informa automáticamente

NewRelic.noticeError(...)

Dentro de una transacción, gana la última llamada a noticeError . Solo se informará 1 error por transacción.

Agrupe los errores con su propia huella digital definida personalizada; implemente la interfaz ErrorGroupCallback que se utiliza para generar claves de agrupación para los errores que se enviarán a New Relic. La huella digital se utilizará para agrupar mensajes de error en la Errors Inbox UI de la .

public interface ErrorGroupCallback { String generateGroupingString(ErrorData errorData); }

Configure su propia huella digital de error mediante una función de devolución de llamada. Para registrar un ErrorGroupCallback que se utiliza para generar una clave de agrupación para el error proporcionado.

NewRelic.setErrorGroupCallback(errorGroupCallback)

Agregue el tiempo de carga de la página del browser para Transactions que New Relic no agrega al encabezado automáticamente

Crear y acumular métricas personalizadas

NewRelic.recordMetric(...), .recordResponseTimeMetric(...), o .incrementCounter(...)

Grabar evento personalizado

Insights.recordCustomEvent(...)

O utilice NewRelic.addCustomParameter(...) para agregar un atributo personalizado al tipo TransactionEvent definido por New Relic .

Consulte también la información de este documento sobre el uso Insights para obtener referencias a las clases de API de New Relic.