Sintaxe
newrelic.agent.web_transaction(application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)Usado para instrumento de transação da web.
Requisitos
Versão do agente 4.16.0.116 ou superior
Descrição
Este decorador Python pode ser usado para instrumento de transação da web. As transações marcadas com este decorador são mostradas na interface do APM em transação da web e são separadas das transações da web.
Se você não puder usar o decorador, um destes formatos de chamada pode ser mais útil:
The wrapper
: se você souber antecipadamente onde estão as funções específicas que deseja rastrear, poderá usar o decorador
web_transaction. Mas se você não conhece todas as funções que precisam ser rastreadas (por exemplo, se elas estão sendo pesquisadas dinamicamente como parte de um sistema de roteamento), então você deve usar oWebTransactionWrapperpara agrupar a função no momento da inscrição ou no momento da ligação.The path-based wrapper
: o formulário wrapper baseado em caminho é
wrap_web_transaction.
Para obter mais informações sobre as diferenças e os usos dessas formas de função, consulte Formatos de chamada de variáveis.
Parâmetro
Parâmetro decorador
newrelic.agent.web_transaction(application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)Parâmetro para essas chamadas:
Parâmetro | Descrição |
|---|---|
Instância do aplicativo | Opcional. O aplicativo sob o qual os dados serão relatados. Se ficar sem valor, o aplicativo especificado na configuração do agente (arquivo de configuração ou variável de ambiente) será usado. Para obter mais informações sobre como gerar um objeto de aplicativo, consulte o método |
corda | Opcional. O nome da transação. Por padrão, o nome será o nome da função à qual o decorador foi aplicado, mas você pode substituir isso fornecendo este nome. |
corda | Opcional. O Se não for fornecido, o grupo será padronizado como |
corda | Opcional. A parte do esquema do URL da solicitação |
corda | Opcional. A parte do host do URL da solicitação |
inteiro | Opcional. A parte da porta do URL da solicitação |
corda | Opcional. O método de solicitação HTTP, como GET ou POST |
corda | Opcional. O restante do caminho do URL da solicitação |
corda | Opcional. A parte do URL da solicitação que segue o ponto de interrogação |
iterável ou ditado | Opcional. Os cabeçalhos de solicitação HTTP Um iterável de [nome, valor] iteráveis de dois itens ou ditado de |
Parâmetro do wrapper:
newrelic.agent.WebTransactionWrapper(wrapped, application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)WebTransactionWrapper usa os mesmos parâmetros do decorador web_transaction e este parâmetro wrapped adicional:
Parâmetro | Descrição |
|---|---|
método | Obrigatório. O método a ser rastreado. |
Parâmetro baseado em caminho:
newrelic.agent.wrap_web_transaction(module, object_path, application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)wrap_web_transaction leva o mesmo parâmetro do decorador web_transaction mais estes parâmetros adicionais:
Parâmetro | Descrição |
|---|---|
módulo ou string | Obrigatório. O módulo que contém a função/atividade web que você está instrumentado. |
corda | Obrigatório. O caminho para o módulo. |
Exemplos
web_transaction exemplo de decorador
Aqui está um exemplo de uso do decorador web_transaction:
@newrelic.agent.web_transaction()def get(): ...WebTransactionWrapper exemplo
Um exemplo de uso do WebTransactionWrapper:
task = newrelic.agent.WebTransactionWrapper(get_next_task())result = task(*args, **kwargs)