Activer le traçage distribué pour votre application Go

le traçage distribué vous permet de voir l'intégralité du parcours de vos requests à travers un systèmes distribués. Pour l'agent Go, nous proposons deux types de traçage distribué (pour plus de détails, voir Comment fonctionne l'échantillonnage de la portée) :

• Standard (échantillonnage en début de workflow) : Avant l'arrivée de toute trace, nous déterminons un pourcentage défini de trace à accepter et à analyser. Cela vous donne un point de départ solide pour voir comment le traçage peut vous aider. Il est activé par défaut dans Go Agent 3.16.0 et versions ultérieures.

• Traçage infini (échantillonnage en fin de workflow) : Notre service basé sur le cloud accepte toutes vos traces puis les trie pour trouver les plus importantes. Le traçage infini analyse toutes vos traces et vous offre des options configuration pour échantillonner les traces qui comptent le plus pour vous.

Que vous souhaitiez simplement tester le traçage standard distribué (échantillonnage en début de workflow) ou que vous souhaitiez également mettre en place un traçage infini (échantillonnage en fin de workflow), vous devez commencer par mettre en place le traçage standard.

Traçage standard distribué

Il s’agit de la meilleure approche pour configurer le traçage standard distribué si vous n’avez pas encore installé d’agent APM pour vos services.

Identifier les services

Déterminez quels services touchent à votre demande afin de pouvoir instrumenter chacun d'eux pour envoyer des données trace à New Relic.

instrumenter chaque service avec un agent APM

Pour chaque service impliqué dans vos transactions, vous effectuerez une installation distincte de l'agent. Si certains de vos services utilisent d’autres langues, répétez simplement les étapes d’installation pour ces langues.

Conseil

L'agent Go nécessite que vous instrumentez manuellement vos services Go, contrairement à l'auto-instrumentation de l'autre agent New Relic . Cela signifie que vous devez ajouter quelques lignes à votre code pour utiliser l'agent Go. Vous en apprendrez davantage à ce sujet lorsque vous démarrerez l'installation ci-dessous.

Pour démarrer la routine d'installation, cliquez sur la tuile ci-dessous. Une fois l'installation de chaque agent terminée, revenez ici pour voir des conseils pour visualiser votre trace.

Start installation

Afficher la trace

Après avoir instrumenté chacun de vos services avec l'agent APM, générez du trafic dans votre application afin que nous puissions capturer une trace. Voici quelques façons d'afficher votre trace dans l'UI:

Afficher les traces qui incluent un service spécifique

Voici une façon de voir la trace d’un service particulier :

1. Allez à one.newrelic.com > All capabilities > APM & services.
2. Cliquez sur votre entité (service).
3. Dans la section Monitor du volet de gauche, cliquez sur Distributed tracing.
4. Pour plus de détails, cliquez sur une trace individuelle. Si Group similar traces est activé dans le menu supérieur, cliquez sur un groupe trace, puis cliquez sur une trace individuelle.
5. Si vous ne voyez pas la trace souhaitée, vous pouvez filtrer par trace.id.

Afficher la trace sur les comptes

Pour voir la trace de ces comptes croisés :

1. Allez à one.newrelic.com > All capabilities > Traces.
2. Sélectionnez votre entité (service) dans le volet de gauche.
3. Pour plus de détails, cliquez sur une trace individuelle. Si Group similar traces est activé dans le menu supérieur, cliquez sur un groupe trace, puis cliquez sur une trace individuelle.
4. Si vous ne voyez pas la trace souhaitée, vous pouvez filtrer par trace.id.

Examiner le log lié à la trace

Vous pouvez rassembler votre log et vos détails de traçage pour rendre le dépannage plus facile et plus rapide. Avec les logs en contexte, vous pouvez voir le message du à côté de log la trace dans l'UI de New Relic.

Après avoir localisé une trace intéressante en suivant les étapes décrites dans Afficher la trace qui inclut un service spécifique ou Afficher la trace sur plusieurs comptes, procédez comme suit :

1. Si vous avez activé les journaux en contexte, cliquez sur l'onglet Logs (à côté de Trace details).
2. Pour afficher les détails relatifs à un log individuel, cliquez directement sur le message.

Pour plus d'aide pour trouver votre trace dans l'UI:

• Comprendre et utiliser l'UI de tracing distribué
• Interroger les données de traces distribuées

Traçage infini (optionnel)

Le traçage standard distribué pour l'agent APM capture jusqu'à 10 % de votre trace, mais si vous souhaitez que nous analysions toutes vos données et trouvions la trace la plus pertinente, vous pouvez configurer le traçage infini.

Avant de commencer, assurez-vous d’abord de répondre aux exigences.

instrumentationmanuelle supplémentaire

Toutes les installations de l'agent Go et le traçage distribué nécessitent une instrumentation manuelle utilisant les paramètres répertoriés dans les paramètres configuration de l'agent Go. Néanmoins, vous devrez peut-être effectuer quelques configurations supplémentaires pour optimiser votre configuration. Voici quelques lignes directrices pour les transactions instrumentées et requests HTTP.

http.HandleFunc("/users", usersHandler)

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

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

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
}

func noGoodForDt(txn *newrelic.Transaction, url string) (*http.Response, error) {
    // Distributed tracing headers are not added to the outgoing request.
    // Use newrelic.NewRoundTripper or newrelicc.StartExternalSegment instead.
    defer newrelic.ExternalSegment{
        StartTime: txn.StartSegmentNow(),
        URL:       url,
    }.End()

    return http.Get(url)
}

InsertDistributedTraceHeaders(h http.Header)

AcceptDistributedTraceHeaders(h http.Header)

Pour plus de détails sur leur utilisation, consultez le référentiel GitHub agent Go.