Sintaxe
newrelic.agent.profile_trace(name=None, group=None, label=None, params=None, depth=3)Adiciona atributos adicionais aos nomes trace de função.
Descrição
profile_trace é usado para adicionar mais detalhes ao seu rastreamento de transação na forma de segmentos adicionais. Todas as chamadas relatadas com profile_trace aparecerão na página do banco de dados do APM. profile_trace retorna uma parcial de ProfileTraceWrapper que pode ser usada como decorador de uma função para cronometrar chamadas para seu profiler.
Se você não puder usar o decorador em seu aplicativo, poderá usar o seguinte formato de chamada: O formulário wrapper é ProfileTraceWrapper. Pode ser usado para retornar uma função encapsulada sem o uso de um decorador.
Para obter uma explicação sobre os usos desses diferentes formatos de chamada, consulte Diferentes formatos de chamada. Consulte Exemplos para exemplos de chamadas.
Importante
As funções são instrumentadas apenas no escopo da chamada de função especificada. Se uma função function_a for trace e chamar function_b , ela só será instrumentada dentro do escopo de function_a e não em qualquer outro lugar onde function_b for chamado, mas não trace.
Parâmetro
Parâmetro para decorador
newrelic.agent.profile_trace(name=None, group=None, label=None, params=None, depth=3)Esta chamada inclui estes parâmetros:
Parâmetro | Descrição |
|---|---|
corda | Opcional. O nome da função. Se não for definido, o padrão será o nome capturado da função. |
corda | Opcional. O Se não for fornecido, o grupo terá como padrão |
corda | Opcional. Adiciona um sinalizador de estilo callout ao segmento em um rastreamento de transação. O padrão é |
dict | Opcional. Parâmetro personalizado a ser adicionado ao segmento no rastreamento da transação. |
dict | Opcional. parâmetro para profundidade máxima trace da função. O padrão é 3. |
Parâmetro do wrapper
newrelic.agent.ProfileTraceWrapper(wrapped, name=None, group=None, label=None, params=None, depth=3)Os parâmetros do wrapper incluem todos os parâmetros para profile_trace e um parâmetro wrapped :
Parâmetro | Descrição |
|---|---|
função | Obrigatório. A função que está sendo encapsulada. |
Exemplos
profile_trace exemplo
Um exemplo de uso do decorador profile_trace :
import newrelic.agent
@newrelic.agent.profile_trace()def some_function(): ...Exemplo de wrapper
Um exemplo de uso do ProfileTraceWrapper:
import newrelic.agent
def another_function(): wrapped_function = newrelic.agent.ProfileTraceWrapper(some_function) ... wrapped_function() ...