Traçage inter-applications avec Go

Si vous utilisez http.ServeMux de Go et souhaitez la prise en charge de CAT, vous devrez utiliser les wrappers WrapHandle et WrapHandleFunc de l'agent. Ces wrappers démarrent et terminent automatiquement les transactions avec le rédacteur de requêtes et de réponses, qui ajoutera automatiquement les en-têtes CAT corrects. Votre code devrait ressembler à ce qui suit :

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

Vous pouvez en savoir plus sur ces wrappers dans Instrumenter les transactions Go.

Lorsque vous créez vos propres transactions avec app.StartTransaction, assurez-vous d'appeler également Transaction.SetWebRequest et Transaction.SetWebResponse. Par exemple, une transaction démarrée avec le code suivant aura CAT activé :

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()

Cependant, une transaction démarrée sans les appels à Transaction.SetWebRequest et Transaction.SetWebResponse will not a CAT activé :

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

De plus, si vous définissez des codes de réponse HTTP, utilisez la méthode txn.WriteHeader de l'agent Go plutôt que la méthode http.ResponseWriter.WriteHeader de la bibliothèque standard.

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

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

Pour que vos requests HTTP sortantes soient éligibles au CAT, vous devez créer un segment externe.

Le moyen le plus simple de créer un segment externe pour votre requête HTTP sortante est d'utiliser la méthode newrelic.NewRoundTripper . Par exemple, ce code fera une demande à http://api.example.com/ qui inclut les en-têtes CAT sortants.

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 vous avez une demande plus complexe qui utilise la http.Request de la bibliothèque standard Go, vous devrez utiliser la méthode newrelic.StartExternalSegment pour garantir que votre demande sortante est éligible pour 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
}

Bien qu'il soit également possible de créer un ExternalSegment via un littéral de structure, ce segment will not peut être éligible pour CAT. Pour cette raison, New Relic recommande d'utiliser newrelic.NewRoundTripper ou 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)
}