Incluir instrumentação personalizada na sua aplicação pode ser útil para identificar as linhas específicas de código que causam problemas de performance.
O AppSignal para Python usa objetos tracer do OpenTelemetry; você pode ler mais sobre traces em Python no Python Cookbook do OpenTelemetry.
Traces são compostos por uma ou mais spans. Um Trace pode ser pensado como um grafo acíclico direcionado (DAG) de spans:
Atributos específicos do AppSignal devem ser adicionados a uma span para que ela seja analisada com sucesso pelo AppSignal. Nosso conjunto de métodos auxiliares pode ser usado para definir esses atributos.
Esta documentação explicará como criar instrumentações personalizadas definindo atributos específicos do AppSignal nas spans da sua aplicação Python.
Criando uma span
Ao adicionar instrumentação personalizada, primeiro importe o módulo trace do OpenTelemetry no arquivo onde você quer adicionar a instrumentação.
from opentelemetry import trace
tracer = trace.get_tracer(__name__)
with tracer.start_as_current_span("Span name"):
# Here you can execute your app logic
# And set AppSignal span details:
from appsignal import set_category
set_category("category.name")
Scripts pontuais e Serverless
Ao executar scripts pontuais ou funções serverless, você precisa inicializar o AppSignal manualmente e pará-lo no final para garantir que nenhum dado seja perdido. O helper stop encerrará o processo do agente graciosamente e aguardará um pouco para garantir que todos os dados sejam enviados aos servidores do AppSignal.
appsignal = Appsignal(
active=True,
name="My Python App",
push_api_key="YOUR_PUSH_API_KEY",
)
appsignal.start()
# Your code here along with the instrumentation
# ...
appsignal.stop()
Métodos auxiliares
Os métodos auxiliares a seguir definem atributos específicos do AppSignal em spans que ajudam a agrupar spans e melhorar como elas são exibidas no AppSignal. Outros atributos não são suportados em spans pelo AppSignal.
set_category
A categoria da span é o nome que aparece na linha do tempo de eventos de performance para traces. Também é usada para agrupar spans, criando um detalhamento por grupo na página de detalhes da amostra.
from appsignal import set_category
set_category("category.name")
set_category("query.users")
set_category("update.users")
set_category("view.users")
.) para expressar a herança hierárquica do evento, com a unidade mais alta por último. Para mais informações sobre categorias de span, consulte o guia de nomes de eventos.
set_name
Mais detalhes podem ser adicionados à span que ficam visíveis ao passar o mouse sobre o evento na linha do tempo. O nome da span é usado para fornecer mais informações sobre o evento, como “Buscar usuários”, o banco de dados de onde são buscados ou a URL que foi requisitada.
from appsignal import set_name
set_name("Fetch users")
start_as_current_span foi chamado.
set_body
🔐 Não envie Informações Pessoais Identificáveis (PII) para a AppSignal. Filtre PII (por exemplo, nomes, e-mails) e use um ID, hash ou identificador pseudonimizado no lugar.
Para entidades cobertas pela HIPAA, mais informações sobre como assinar um Business Associate Agreement (BAA) estão disponíveis em nossa documentação de Business Add-Ons. set_sql_body em vez deste.
from appsignal import set_body
set_body("Span body")
set_sql_body
Disponível desde o pacote Python 0.3.2.
set_body, mas é especializado para consultas SQL. Qualquer consulta SQL definida como corpo com este atributo será sanitizada para evitar enviar dados PII (Informações Pessoalmente Identificáveis) aos nossos servidores.
Consulte o helper set_body para mais detalhes sobre como funciona o atributo body.
Quando ambos os helpers set_body e set_sql_body são chamados na mesma span, o valor do helper set_sql_body prevalece e o valor do helper set_body será ignorado.
from appsignal import set_sql_body
set_body("SELECT * FROM users")
set_root_name
Este atributo se aplica a todo o trace. Ele pode ser definido em um span filho e não precisa ser definido no span pai mais externo. Este atributo só pode ser definido uma vez por trace. Se for definido várias vezes, apenas o atributo de um span no trace será aplicado.
set_root_name.
Use um nome de ação genérico o suficiente para agrupar todos os traces dessa parte do app, sem reportar nomes diferentes a cada vez. Defina GET /users/:id (onde :id é o nome do parâmetro de URL) como o nome de ação, em vez de GET /users/123 (onde 123 é o valor real feito na requisição). O último reportaria um novo incidente para cada requisição única.
from appsignal import set_root_name
set_root_name("GET /custom")
# With URL parameters
set_root_name("GET /users/:id")
Exemplo de caso de uso
Sua aplicação tem um endpoint chamado GET /coffee.
def coffee(request):
return render(request, "coffee.html", {})
GET /coffee, mas seu endpoint trata múltiplas ações: coffee?action=buy e coffee?action=sell.
Embora todos usem o endpoint GET /coffee, são conceitualmente muito diferentes e, portanto, faria sentido que fossem agrupados separadamente no AppSignal em vez de na mesma amostra GET /coffee. Para fazer isso, você pode usar o helper set_root_name:
from appsignal import set_root_name
def coffee(request):
if request.GET.action == "buy":
set_root_name("Buy coffee")
# Buy coffee...
elif request.GET.action == "sell":
set_root_name("Sell coffee")
# Sell coffee...
return render(request, "coffee.html", {})
set_root_name mudará o nome da span raiz, agrupando as amostras das requisições coffee?action=buy e coffee?action=sell em ações separadas:
Outros dados de trace
Para personalizar ainda mais os dados armazenados no trace, consulte nossos guias de Tagging e Personalização de dados para adicionar tags, parâmetros, dados de sessão, dados personalizados e muito mais. 