Sintaxe
newrelic.agent.add_custom_span_attribute(key, value)
Adiciona um atributo personalizado a um evento span.
Descrição
Esta chamada registra um atributo personalizado (um par de valor principal anexado ao seu evento span).
Atributo pode ser encontrado no distributed tracing ou no APM se um rastreamento da transação for criado pela transação pai. atributo também pode ser encontrado e consultado na interface do New Relic.
Importante
Antes de criar um atributo personalizado, revise nossa lista de termos reservados usados pelo NRQL.
Parâmetro
Parâmetro | Descrição |
---|---|
corda | Obrigatório. O nome da chave. Apenas os primeiros 255 caracteres são mantidos. |
string, inteiro, float, booleano | Obrigatório. O valor da string a ser adicionado ao evento span atual. Apenas os primeiros 255 caracteres são mantidos. |
Valores de retorno
Retorna True
se o atributo foi adicionado com sucesso.
Exemplos
Adicionando atributo personalizado à tarefa em segundo plano
Um exemplo de adição de atributo personalizado a uma tarefa em segundo plano:
@newrelic.agent.background_task()def send_request(): with newrelic.agent.FunctionTrace(name='Trace'): newrelic.agent.add_custom_span_attribute('attribute', 'value')
Usando o atributo span personalizado para solucionar problemas
Você também pode usar o atributo personalizado para solucionar problemas de desempenho. Por exemplo, você pode ver ocasionalmente um ritmo de resposta lento de um conjunto de instâncias do Memcache, mas não sabe qual instância está causando o problema. Você pode adicionar um atributo ao span indicando o servidor, assim:
# Set server_ip to be the current server processing the transaction
newrelic.agent.add_custom_span_attribute("memcache_query_frontend_lookup", server_ip)