Rastreamento multiaplicativo com Go

Se estiver usando o http.ServeMux do Go e quiser suporte CAT, você precisará usar os wrappers WrapHandle e WrapHandleFunc do agente. Esses wrappers iniciam e encerram automaticamente a transação com o gravador de solicitação e resposta, que adicionará automaticamente os cabeçalhos CAT corretos. Seu código deve ser semelhante ao seguinte:

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

Você pode ler mais sobre esses invólucros em Instrumento de transação Go.

Ao criar sua própria transação com app.StartTransaction, certifique-se de chamar também Transaction.SetWebRequest e Transaction.SetWebResponse. Por exemplo, uma transação iniciada com o seguinte código terá o 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()

Entretanto, uma transação foi iniciada sem que as chamadas para Transaction.SetWebRequest e Transaction.SetWebResponse will not tivessem CAT ativado:

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

Além disso, se você estiver configurando códigos de resposta HTTP, use o método txn.WriteHeader do agente Go em vez do método http.ResponseWriter.WriteHeader da biblioteca padrão.

// 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 suas solicitações HTTP(s) de saída sejam elegíveis para CAT, você precisará criar um segmento externo.

A maneira mais fácil de criar um segmento externo para sua solicitação HTTP(s) de saída é usar o método newrelic.NewRoundTripper . Por exemplo, este código fará uma solicitação para http://api.example.com/ que inclui os cabeçalhos CAT de saída.

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

Se você tiver uma solicitação mais complexa que usa o http.Request da biblioteca padrão Go, precisará usar o método newrelic.StartExternalSegment para garantir que sua solicitação de saída seja qualificada 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
}

Embora também seja possível criar um ExternalSegment por meio de um literal de estrutura, esse segmento will not é elegível para CAT. Por causa disso, a New Relic recomenda usar 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)
}