Traçage inter-applications (obsolète)

Le protocole utilisé pour communiquer entre les applications implique de joindre des métadonnées aux requests et aux réponses. Les métadonnées sont traitées par chaque application et les données résultantes sont signalées par l'agent.

Exigences

Nécessite l'agent Python New Relic version 2.92.0.78 jusqu'à la version 7.0.0.166. C'est obsolète pour les versions supérieures à celle-ci.

Client personnalisé (HTTP)

Ces API sont utilisées pour les bibliothèques de communication HTTP personnalisées qui ne sont pas instrumentées dans le cadre de l'instrumentation intégrée.

Le traçage inter-applications HTTP utilise les en-têtes HTTP pour transporter les métadonnées de transaction entre les applications. Pour générer des en-têtes de traçage inter-applications sortants, utilisez l'API generate_request_headers sur la classe ExternalTrace . Pour traiter les en-têtes de traçage inter-applications entrants, utilisez l'API process_response_headers sur la classe ExternalTrace .

import newrelic.agent

transaction = newrelic.agent.current_transaction()
# returns a list of tuples in the form (header_name, header_value)
outgoing_headers = newrelic.agent.ExternalTrace.generate_request_headers(transaction)
for header_name, header_value in outgoing_headers:
  ...request.putheader(header_name, header_value) # code to be instrumented
...make_request(request) # code to be instrumented

import newrelic.agent

transaction = newrelic.agent.current_transaction()
trace = newrelic.agent.ExternalTrace(transaction, 'library', 'http://example.com', 'get')
with trace:
  response = fetch_example_dot_com() # code to be instrumented
  trace.process_response_headers(...response.headers)

Client personnalisé (non HTTP)

Ces API sont utilisées pour instrumenter les bibliothèques qui n'utilisent pas le transport HTTP (et qui peuvent donc ne pas être en mesure d'utiliser les en-têtes comme transport crypté) et ne sont pas instrumentées dans le cadre de l'instrumentation intégrée.

Exemple d'instrumentation

import newrelic.agent

transaction = newrelic.agent.current_transaction()
# returns a string value
outgoing_metadata = newrelic.agent.ExternalTrace.get_request_metadata(transaction)
...request.add_metadata(outgoing_metadata) # code to be instrumented
...make_request(request) # code to be instrumented

import newrelic.agent

transaction = newrelic.agent.current_transaction()
trace = newrelic.agent.ExternalTrace(transaction, 'library', 'myproto://service', 'fetch')
with trace:
  ...response = fetch_from_service() # code to be instrumented
  # extract the metadata string sent from the service
  metadata_value = response.metadata # code to be instrumented
  trace.process_response_metadata(metadata_value)

Serveur WSGI

Pour plus d'informations sur les serveurs WSGI instrumentés, consultez la documentation de l'API wsgi_application pour plus de détails.

Serveur non HTTP personnalisé

Les serveurs personnalisés qui ne sont pas basés sur WSGI ou n'utilisent pas HTTP comme moyen de transport devront traiter les métadonnées de traçage inter-applications entrantes et générer des réponses trace inter-applications.

Les API suivantes permettent de traiter les métadonnées de traçage inter-applications envoyées sur requests non HTTP et de générer des métadonnées de réponse à renvoyer à l'appelant.

import newrelic.agent

def handle_incoming_request(request):
  transaction = newrelic.agent.current_transaction()
  if transaction:
    transaction.process_request_metadata(...request.metadata)

  response = generate_response() # code to be instrumented

  if transaction:
    # get_response_metadata returns a string
      ...response.metadata = transaction.get_response_metadata()
  return response