elenjical-sdk

Error tracking and logs for Python services (Django, Flask, FastAPI, Celery, scripts), reported to Elenjical.

Install

pip install "elenjical-sdk[flask]"     # or [django], [fastapi], [celery], [sqlalchemy], or none

Set up

Set ELENJICAL_DSN (your service's DSN from Elenjical, Settings > Services) and, optionally, ELENJICAL_ENVIRONMENT and ELENJICAL_RELEASE. Then, before the application starts:

import logging

import elenjical
from elenjical.integrations.flask import FlaskIntegration
from elenjical.integrations.logging import LoggingIntegration, ignore_logger

elenjical.init(
    integrations=[
        FlaskIntegration(),
        LoggingIntegration(level=logging.INFO, event_level=logging.ERROR, logs_level=logging.INFO),
    ],
)
ignore_logger("gunicorn.access")

Arguments you pass take precedence over the environment. Report handled errors with elenjical.capture_exception(error), identify people with elenjical.set_user({"id": ..., "email": ...}), write logs with elenjical.logger.info("...").

If browsers call this service, allow elenjical.TRACE_HEADERS in CORS (Flask-CORS: allow_headers=["Content-Type", "Authorization", *elenjical.TRACE_HEADERS]) so their sessions link to your errors.

See NOTICE for the open-source software this package is built on.