Skip to main content
Esta documentação descreve como configurar o logging com a integração AppSignal for Python.
O logging só está disponível ao usar o modo collector, que é um recurso experimental.

​
Configurar logging

🔐 Não envie Informações Pessoais Identificáveis (PII) para a AppSignal. Filtre PII (por exemplo, nomes, e-mails) dos logs 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) podem ser encontradas em nossa documentação de Business Add-Ons.
Você não precisa criar uma fonte de log para enviar logs da integração AppSignal for Python. Uma fonte de log “application” será criada automaticamente. Ao usar o modo collector, o AppSignal instrumenta automaticamente o módulo logging embutido do Python via OpenTelemetry, anexando um handler ao logger raiz.

​
Desabilitando a instrumentação de logging

A instrumentação para o módulo logging do Python pode ser desabilitada usando a opção de configuração disable_default_instrumentations: 
# __appsignal__.py
appsignal = Appsignal(
    # ...
    disable_default_instrumentations=["logging"],
)
Isso desabilita a instrumentação automática do módulo logging por meio da anexação de um handler ao logger raiz, o que significa que os logs enviados ao módulo logging do Python não serão mais capturados pelo AppSignal. Você ainda pode enviar logs diretamente usando a API de logs do OpenTelemetry, conforme descrito na seção Enviando logs com OpenTelemetry abaixo.

​
Anexando handlers manualmente

Quando a instrumentação automática está desabilitada, você pode anexar o LoggingHandler do OpenTelemetry a loggers específicos por conta própria, em vez de depender do AppSignal adicioná-lo ao logger raiz: 
import logging
from opentelemetry.sdk._logs import LoggingHandler

handler = LoggingHandler(level=logging.NOTSET)
logging.getLogger("myapp").addHandler(handler)
Isso te dá controle sobre quais loggers enviam sua saída ao AppSignal.

​
Nível de log

O módulo logging do Python tem como padrão WARNING, o que significa que mensagens INFO e DEBUG não são capturadas por padrão. Para capturar mensagens de severidade mais baixa, defina explicitamente o nível do logger raiz: 
import logging
logging.root.setLevel(logging.INFO)

​
Quais logs são capturados

O AppSignal captura logs enviados ao logger raiz e a qualquer logger que propague para ele. A propagação é controlada pelo atributo propagate em cada logger, que tem como padrão True no Python. Loggers com propagate=False não terão suas mensagens capturadas pelo AppSignal.

​
Configuração de Framework

​
Django

O Django configura alguns loggers com propagate=False por padrão, o que impede que eles cheguem ao AppSignal. Sobrescreva-os em settings.py para reativar a propagação: 
# settings.py
LOGGING = {
    "version": 1,
    "disable_existing_loggers": False,
    "handlers": {
        "console": {"class": "logging.StreamHandler"},
    },
    "loggers": {
        "django.server": {
            "handlers": ["console"],
            "level": "INFO",
            "propagate": True,
        },
        "myapp": {
            "handlers": ["console"],
            "level": "INFO",
            "propagate": True,
        },
    },
}
Definir "propagate": True garante que as mensagens do logger cheguem ao logger raiz, onde o handler do AppSignal está anexado.

​
Anexando handlers manualmente

Como alternativa, você pode anexar o LoggingHandler diretamente aos loggers do Django em vez de depender da propagação para o logger raiz: 
# settings.py
import logging
from opentelemetry.sdk._logs import LoggingHandler

LOGGING = {
    "version": 1,
    "handlers": {
        "console": {"class": "logging.StreamHandler"},
        "appsignal": {"()": LoggingHandler, "level": logging.NOTSET},
    },
    "loggers": {
        "django.server": {
            "handlers": ["console", "appsignal"],
            "level": "INFO",
        },
        "myapp": {
            "handlers": ["console", "appsignal"],
            "level": "INFO",
        },
    },
}

​
Celery

O Celery faz fork dos processos worker, então o AppSignal precisa ser iniciado para cada fork. Use o sinal worker_process_init para reinicializar o AppSignal e configurar o logging em cada processo worker. Veja a página de instrumentação do Celery para mais detalhes sobre como instrumentar tarefas do Celery. 
# tasks.py
import logging
import appsignal
from celery.signals import worker_process_init

@worker_process_init.connect(weak=False)
def init_worker_logging(*args, **kwargs):
    appsignal.start()
    logging.root.setLevel(logging.INFO)
    logging.getLogger("celery").propagate = True

​
Enviando logs com OpenTelemetry

Você também pode enviar logs diretamente usando a API de logs do OpenTelemetry, sem passar pelo módulo logging do Python: 
from opentelemetry._logs import get_logger_provider
from opentelemetry.sdk._logs import SeverityNumber

logger_provider = get_logger_provider()
logger = logger_provider.get_logger("my-app")

logger.emit(
    logger_provider.get_logger("my-app").create_log_record(
        body="Log message line",
        severity_number=SeverityNumber.INFO,
    )
)

​
Precisa de ajuda?

Depois de configurar sua aplicação Python para enviar logs, os logs devem aparecer no AppSignal. Se você tiver dúvidas sobre este passo ou o AppSignal não estiver recebendo logs, você sempre pode entrar em contato para obter ajuda. Vamos te ajudar a voltar ao normal!