Skip to main content
Diese Dokumentation beschreibt, wie Sie Logging mit der AppSignal for Python-Integration konfigurieren.
Logging ist nur im Collector-Modus verfügbar, der ein experimentelles Feature ist.

​
Logging konfigurieren

🔐 Senden Sie keine personenbezogenen Daten (Personal Identifiable Information, PII) an AppSignal. Filtern Sie PII (z. B. Namen, E-Mail-Adressen) aus Logs und verwenden Sie stattdessen eine ID, einen Hash oder einen pseudonymisierten Bezeichner.

Für HIPAA-pflichtige Stellen finden Sie weitere Informationen zum Abschluss eines Business Associate Agreement (BAA) in unserer Business Add-Ons-Dokumentation.
Sie müssen keine Log-Quelle erstellen, um Logs aus der AppSignal for Python-Integration zu senden. Eine “application”-Log-Quelle wird automatisch erstellt. Im Collector-Modus instrumentiert AppSignal automatisch das integrierte logging-Modul von Python über OpenTelemetry und hängt einen Handler an den Root-Logger.

​
Logging-Instrumentierung deaktivieren

Die Instrumentierung des logging-Moduls von Python kann mit der Konfigurationsoption disable_default_instrumentations deaktiviert werden: 
# __appsignal__.py
appsignal = Appsignal(
    # ...
    disable_default_instrumentations=["logging"],
)
Dies deaktiviert die automatische Instrumentierung des logging-Moduls durch Anhängen eines Handlers an den Root-Logger, was bedeutet, dass Logs, die an das logging-Modul von Python gesendet werden, nicht mehr von AppSignal erfasst werden. Sie können Logs weiterhin direkt über die OpenTelemetry Logs API senden, wie im Abschnitt Logs mit OpenTelemetry senden unten beschrieben.

​
Handler manuell anhängen

Wenn die automatische Instrumentierung deaktiviert ist, können Sie den OpenTelemetry-LoggingHandler selbst an bestimmte Logger anhängen, anstatt darauf zu setzen, dass AppSignal ihn an den Root-Logger anhängt: 
import logging
from opentelemetry.sdk._logs import LoggingHandler

handler = LoggingHandler(level=logging.NOTSET)
logging.getLogger("myapp").addHandler(handler)
Damit haben Sie die Kontrolle darüber, welche Logger ihre Ausgabe an AppSignal senden.

​
Log-Level

Das logging-Modul von Python verwendet standardmäßig WARNING, was bedeutet, dass INFO- und DEBUG-Nachrichten standardmäßig nicht erfasst werden. Um Nachrichten mit niedrigerer Severity zu erfassen, setzen Sie das Level des Root-Loggers explizit: 
import logging
logging.root.setLevel(logging.INFO)

​
Welche Logs erfasst werden

AppSignal erfasst Logs, die an den Root-Logger gesendet werden, sowie an jeden Logger, der an ihn propagiert. Die Propagierung wird durch das Attribut propagate an jedem Logger gesteuert, das in Python standardmäßig auf True gesetzt ist. Logger mit propagate=False lassen ihre Nachrichten nicht von AppSignal erfassen.

​
Framework-Setup

​
Django

Django konfiguriert einige Logger standardmäßig mit propagate=False, was verhindert, dass sie AppSignal erreichen. Überschreiben Sie diese in settings.py, um die Propagierung wieder zu aktivieren: 
# 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,
        },
    },
}
Das Setzen von "propagate": True stellt sicher, dass die Nachrichten des Loggers den Root-Logger erreichen, an den der Handler von AppSignal angehängt ist.

​
Handler manuell anhängen

Alternativ können Sie den LoggingHandler direkt an die Logger von Django anhängen, anstatt sich auf die Propagierung zum Root-Logger zu verlassen: 
# 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

Celery forkt Worker-Prozesse, daher muss AppSignal für jeden Fork gestartet werden. Verwenden Sie das worker_process_init-Signal, um AppSignal neu zu initialisieren und Logging in jedem Worker-Prozess zu konfigurieren. Weitere Details zur Instrumentierung von Celery-Tasks finden Sie auf der Seite zur Celery-Instrumentierung. 
# 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

​
Logs mit OpenTelemetry senden

Sie können Logs auch direkt über die OpenTelemetry Logs API senden, ohne den Umweg über das logging-Modul von 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,
    )
)

​
Brauchen Sie Hilfe?

Nachdem Sie Ihre Python-Anwendung so konfiguriert haben, dass sie Logs sendet, sollten die Logs in AppSignal erscheinen. Wenn Sie sich bei diesem Schritt unsicher sind oder AppSignal keine Logs empfängt, können Sie sich jederzeit für Unterstützung an uns wenden. Wir helfen Ihnen, wieder auf Kurs zu kommen!