Skip to main content
Para enviar dados do OpenTelemetry da sua aplicação Python ao AppSignal, você pode usar o pacote AppSignal para Python ou instalar e configurar o OpenTelemetry manualmente.

Usando o pacote AppSignal para Python

O pacote AppSignal para Python pode configurar automaticamente o OpenTelemetry para enviar dados ao AppSignal collector. Ele também pode habilitar automaticamente instrumentações do OpenTelemetry para bibliotecas e frameworks populares. Siga as instruções na documentação de instalação do AppSignal para Python para instalar o pacote e configurar o arquivo de configuração, e depois siga as instruções na página de configuração do collector do AppSignal para Python para usá-lo com o AppSignal Collector.

Instalando o OpenTelemetry manualmente

Certifique-se de instalar o AppSignal collector antes de prosseguir com estas instruções.

Instale os pacotes do OpenTelemetry

Adicione o SDK do OpenTelemetry, o exporter OTLP e os pacotes de instrumentação ao requirements.txt da sua aplicação:
Adicione também os pacotes de instrumentação do OpenTelemetry para as bibliotecas e frameworks que sua aplicação usa. Por exemplo, se você está usando Django e Celery:
Confira o registro do OpenTelemetry para pacotes de instrumentação para a maioria das bibliotecas e frameworks.

Configure o OpenTelemetry na sua aplicação

Adicione este arquivo appsignal.py à sua aplicação com o exporter do OpenTelemetry e a configuração do AppSignal. Em seguida, importe esse arquivo antes que sua aplicação inicie. Certifique-se de atualizar os valores abaixo com o nome da sua aplicação no AppSignal, ambiente e push API key, e de substituir o endpoint do exporter pelo endereço do seu AppSignal collector se necessário.
Em seguida, no mesmo arquivo, após a configuração do OpenTelemetry, inicialize as instrumentações do OpenTelemetry para as bibliotecas e frameworks que sua aplicação usa. Por exemplo, se você está usando as instrumentações do Django e do Celery:
Por fim, chame a função initialize_opentelemetry com o nome do serviço que está sendo monitorado, o mais cedo possível no ponto de entrada da sua aplicação. Uma escolha comum para o nome do serviço é o nome do framework usado.

Uso com Django

No arquivo settings.py da sua aplicação Django, importe o módulo appsignal.py no início do arquivo e chame a função initialize_opentelemetry:

Uso com Celery

No arquivo tasks.py da sua aplicação Celery, adicione um callback de conexão para os processos worker e importe o módulo appsignal.py dentro dele.

Teste o app!

Agora que todos os componentes estão conectados, inicie seu app e teste se você vê os dados chegando no AppSignal. Verifique especificamente as páginas “Errors > Issue list” e “Performance > Traces”. Se, depois de seguir nossas instruções de instalação, você ainda não vir dados no AppSignal, avise-nos e te ajudaremos a finalizar a instalação do OpenTelemetry!