Rastreamento multiaplicativo (obsoleto)

Importante

Para nosso agente Python, o rastreamento multiaplicativo foi descontinuado desde a versão v7.0.0.166 do agente e será removido em uma versão futura do agente. Um recurso distributed tracing já está disponível. Distributed tracing melhora o rastreamento multiaplicativo e é recomendado para atividades de monitoramento em sistemas complexos distribuídos.

O protocolo usado para comunicação entre aplicativos envolve anexar metadados a solicitações e respostas. Os metadados são processados por cada aplicativo e os dados resultantes são relatados pelo agente.

Requisitos

Requer agente New Relic Python versão 2.92.0.78 até a versão 7.0.0.166. Está obsoleto para versões acima disso.

Cliente personalizado (HTTP)

Essas API são usadas para bibliotecas de comunicação HTTP customizadas que não são instrumentadas como parte da instrumentação integrada.

O rastreamento multiaplicativo HTTP usa cabeçalhos HTTP para transportar metadados de transação pelo aplicativo. Para gerar cabeçalhos de rastreamento multiaplicativo de saída, use a API generate_request_headers na classe ExternalTrace . Para processar cabeçalhos de rastreamento multiaplicativo de entrada, use a API process_response_headers na 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)

Cliente personalizado (não HTTP)

Essas API são usadas para bibliotecas de instrumentos que não usam o transporte HTTP (e, portanto, podem não ser capazes de usar cabeçalhos como transporte de metadados) e não são instrumentadas como parte da instrumentação integrada.

Exemplo de instrumentação

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)

Servidor WSGI

Dica

O agente tratará automaticamente do processamento e envio de respostas aos metadados trace multiaplicativo para todos os servidores WSGI.

Para obter informações sobre servidores WSGI instrumentados, consulte a documentação da API do wsgi_application para obter detalhes.

Servidor não HTTP personalizado

Os servidores customizados que não são baseados em WSGI ou que não usam HTTP como transporte terão que processar metadados de rastreamento multiaplicativo de entrada e gerar respostas trace multiaplicativo.

A API a seguir permite o processamento de metadados de rastreamento multiaplicativo enviados em solicitações não HTTP e a geração de metadados de resposta para enviar de volta ao chamador.

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

Esta tradução de máquina é fornecida para sua comodidade.

Rastreamento multiaplicativo (obsoleto)

Importante

Requisitos

Cliente personalizado (HTTP)

Solicitações de saída

Resposta recebida

Cliente personalizado (não HTTP)

Exemplo de instrumentação

Solicitações de saída

Resposta recebida

Servidor WSGI

Dica

Servidor não HTTP personalizado

Exemplo de instrumentação

Esta tradução de máquina é fornecida para sua comodidade.

Rastreamento multiaplicativo (obsoleto)

Importante

Requisitos.css-21sua1{background:none;border:none;width:0;padding:0;}

Cliente personalizado (HTTP)

Resposta recebida

Cliente personalizado (não HTTP)

Exemplo de instrumentação

Solicitações de saída

Resposta recebida

Servidor WSGI

Dica

Servidor não HTTP personalizado

Exemplo de instrumentação

Requisitos