Guía para usar la API del agente Go

El agente de New Relic Go monitorea su aplicación de lenguaje Go y sus microservicios para ayudarlo a identificar y resolver problemas de rendimiento. La API del agente Go es una de varias API de New Relic disponibles.

Monitor transacciones

Antes de instrumentar manualmente su código para monitor transacciones, asegúrese de cumplir con la compatibilidad y los requisitos y de que esté utilizando la última versión del agente Go.

Métodos específicos de tiempo que utilizan segmentos

Si una transacción ya es visible en New Relic, pero no tiene suficientes datos sobre un método en particular que se llamó durante esa transacción, puede crear segmentos. Por ejemplo, si desea cronometrar un método que tiene una lógica compleja, puede crear un segmento para cada uno de los métodos de la transacción.

Para instrumentar un método dentro de una transacción existente, cree segmentos para lo siguiente:

• Bloques de codigo
• Funciones
• Almacenes de datos
• Servicios externos

Si el trabajo se realiza en una rutina diferente a la que comenzó la transacción, debe utilizar la API NewGoroutine() .

Mejorar los metadatos de una transacción

Puedes gestionar los metadatos que New Relic reporta para transacciones. A continuación se muestran algunos ejemplos de casos en los que es posible que desee un nivel diferente de detalle para su transacción:

• Si tiene un problema de agrupación métrica, cambie los nombres predeterminados de su transacción para hacerlos más identificables.
• Si desea crear un panel para su transacción, agregue un atributo personalizado.

Instrumentar las llamadas a servicios externos

Utilice estos métodos para recopilar datos sobre las conexiones de su aplicación a otras aplicaciones o base de datos:

Cobro o error omitido

El agente detecta errores automáticamente. Si desea cambiar la forma en que el agente Go informa errores a New Relic, cambie la configuración del selector de errores.

Error huellas dactilares: aplica dinámicamente un grupo de errores a cada error detectado

Se puede proporcionar una función de devolución de llamada al agente para aplicar dinámicamente un grupo de errores deseado a cada error detectado. Utilice la opción de configuración Ir al agente newrelic.ConfigSetErrorGroupCallbackFunction para proporcionarle al agente una devolución de llamada.

Esta llamada API toma un método de devolución de llamada (debe ser del tipo newrelic.ErrorGroupCallback) como único argumento. He aquí un ejemplo:

myCallbackFunc := CallbackFunc(errorInfo newrelic.ErrorInfo) string {
   if errorInfo.Message == "example error message" {
       return "example group 1"
   }
   if errorInfo.GetHttpResponseCode() == "403" && errorInfo.GetUserID() == "user 2" {
       return "user 2 payment issue"
   }

   // use default error grouping behavior
   return ""
}

app, err := newrelic.NewApplication(
   newrelic.ConfigSetErrorGroupCallbackFunction(myCallbackFunc)
)

En el ejemplo que se muestra, se crea un proceso de devolución de llamada que aceptará un objeto de tipo newrelic.ErrorInfo y devolverá una cadena que representa el grupo de error. Tenga en cuenta que cuando su función ErrorGroupCallback devuelve una cadena que no está vacía, anulará el comportamiento de agrupación predeterminado de un error detectado y aplicará la lógica de agrupación del lado del servidor.

Se espera que la función de devolución de llamada reciba exactamente un argumento de entrada, un objeto newrelic.ErrorInfo . El objeto contiene lo siguiente:

Seguimiento de usuarios: asociar un ID de usuario a cada transacción y error

Las transacciones y los errores se pueden asociar con una identificación de usuario si el agente de New Relic Go la conoce. Utilice Go API del agente txn.SetUserID("example user ID") para proporcionarle al agente un ID de usuario.

Esta llamada API requiere un único argumento de una cadena que represente un identificador único para un usuario final. Esta cadena puede ser un UUID, una identificación de base de datos o similar. La llamada API debe realizarse al menos una vez por transacción para informar al agente de New Relic Go con qué ID de usuario asociar la transacción. Luego, a su vez, cuando el agente detecta errores durante la vida útil de la transacción, los errores llevarán un atributo de agente enduser.id que contiene el valor de ID de usuario.

Debido a que la API está diseñada para ser llamada cada vez que una nueva ID de usuario ingresa al alcance, idealmente se llamará a través de un middleware que tenga en cuenta la creación de la sesión del usuario. Una vez que el agente de New Relic Go conozca el ID de usuario, proporcionará el atributo de agente enduser.id en la transacción actual, así como en cualquier error detectado durante la vida útil de la transacción actual.

Envía datos personalizados desde tu aplicación

Para registrar datos personalizados con el agente Go, puede utilizar cualquiera de los siguientes métodos:

• Evento personalizado
• Atributo personalizado
• Métrica personalizada

Ver registro relacionado

Para ver el registro directamente dentro del contexto de los errores y la traza de su aplicación, use estas llamadas API para anotar su registro:

• GetTraceMetadata
• GetLinkingMetadata

Para obtener más información sobre cómo correlacionar los datos log con otros telemetry data, consulte nuestra documentación logs en el contexto .

Monitor el rendimiento browser con monitoreo de browser

Para monitor el rendimiento del browser de su aplicación mediante monitoreo de browsery el agente Go, puede utilizar cualquiera de los siguientes métodos:

Cambiar los ajustes de configuración del agente Go

Para administrar algunos aspectos del monitoreo de New Relic, puede cambiar la configuración de su agente Go; Por ejemplo:

• Activar el modo de alta seguridad
• Agregar etiquetas personalizadas para filtrar y ordenar
• Gestionar la información que se reporta