Rastreo multiaplicación con Go

El agente Go admite rastreo multiaplicación (CAT). El seguimiento de múltiples aplicaciones vincula la transacción entre la aplicación APM-monitor, lo cual es vital para la aplicación que implementa una arquitectura orientada a servicios o microservicios.

Importante

El rastreo de aplicaciones múltiples ha quedado obsoleto en favor de Distributed tracing y se eliminará en una versión futura de agente.

Habilitar el rastreo multiaplicación con Go

Puede habilitar o deshabilitar el seguimiento de múltiples aplicaciones en el agente Go usando el indicador de configuración CrossApplicationTracer.Enabled .

Pautas de transacciones y solicitudes HTTP con Go

Incluso con el seguimiento de aplicaciones múltiples habilitado, deberá asegurarse de que su aplicación siga algunas convenciones simples al responder a solicitudes HTTP, realizar sus propias solicitudes HTTP o crear su propia transacción.

Si está utilizando http.ServeMux de Go y desea compatibilidad con CAT, deberá utilizar los contenedores WrapHandle y WrapHandleFunc del agente. Estos contenedores inician y finalizan automáticamente la transacción con el escritor de solicitud y respuesta, que agregará automáticamente los encabezados CAT correctos. Su código debería ser similar al siguiente:

http.HandleFunc("/users", usersHandler)
http.HandleFunc(newrelic.WrapHandleFunc(app, "/users", usersHandler))

Puedes leer más sobre estos envoltorios en Instrumentar Go transacción.

Al crear su propia transacción con app.StartTransaction, asegúrese de llamar también Transaction.SetWebRequest y Transaction.SetWebResponse. Por ejemplo, una transacción iniciada con el siguiente código tendrá CAT habilitado:

txn := app.StartTransaction("transactionName")
// req is a *http.Request, this marks the transaction as a web transaction
txn.SetWebRequestHTTP(req)

// writer is a http.ResponseWriter, use the returned writer in place of the original
writer = txn.SetWebResponse(writer)
writer.WriteHeader(500)

defer txn.End()

Sin embargo, una transacción comenzó sin que las llamadas a Transaction.SetWebRequest y Transaction.SetWebResponse will not tuvieran CAT habilitado:

// Cross application tracing not enabled
txn := app.StartTransaction("transactionName")
defer txn.End()

Además, si configura códigos de respuesta HTTP, utilice el método txn.WriteHeader del agente Go en lugar del método http.ResponseWriter.WriteHeader de la biblioteca estándar.

// old code
// writer.WriteHeader(http.StatusInternalServerError)

// replace with this
txn := app.StartTransaction("transactionName")
txn.SetWebRequest(req)
writer = txn.SetWebResponse(writer)
writer.WriteHeader(http.StatusInternalServerError)

Para que sus solicitudes HTTP salientes sean elegibles para CAT, deberá crear un segmento externo.

La forma más sencilla de crear un segmento externo para su solicitud HTTP saliente es utilizar el método newrelic.NewRoundTripper . Por ejemplo, este código realizará una solicitud a http://api.example.com/ que incluye los encabezados CAT salientes.

func useNewRoundTripper(txn *newrelic.Transaction) (*http.Response, error) {
    client := &http.Client{}
    client.Transport = newrelic.NewRoundTripper(client.Transport)
    req, _ := http.NewRequest("GET", "http://api.example.com/", nil)
    req = newrelic.RequestWithTransactionContext(req, txn)
    return client.Do(req)
}

Si tiene una solicitud más compleja que utiliza http.Request de la biblioteca estándar de Go, deberá utilizar el método newrelic.StartExternalSegment para asegurarse de que su solicitud saliente sea apta para CAT.

func external(txn *newrelic.Transaction, req *http.Request) (*http.Response, error) {
    s := newrelic.StartExternalSegment(txn, req)
    response, err := http.DefaultClient.Do(req)
    s.Response = response
    s.End()
    return response, err
}

Si bien también es posible crear un ExternalSegment mediante una estructura literal, este segmento will not será elegible para CAT. Debido a esto, New Relic recomienda usar newrelic.NewRoundTripper o newrelic.ExternalSegment.

func noGoodForCat(txn *newrelic.Transaction, url string) (*http.Response, error) {
    // CAT headers not inserted
    defer newrelic.ExternalSegment{
        StartTime: txn.StartSegmentNow(),
        URL:       url,
    }.End()

    return http.Get(url)
}

Obtener rastreo distribuido

New Relic también ofrece rastreo distribuido. rastreo distribuido es una mejora del rastreo multiaplicación y se recomienda para sistemas distribuidos grandes.

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

Importante

Habilitar el rastreo multiaplicación con Go

Pautas de transacciones y solicitudes HTTP con Go

Creating transactions via http.ServeMux

Crear transacción web manualmente

Realizar solicitudes HTTP

Obtener rastreo distribuido

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

Rastreo multiaplicación con Go

Importante

Habilitar el rastreo multiaplicación con Go .css-21sua1{background:none;border:none;width:0;padding:0;}

Pautas de transacciones y solicitudes HTTP con Go

Crear transacción web manualmente

Realizar solicitudes HTTP

Obtener rastreo distribuido

Habilitar el rastreo multiaplicación con Go