lognitor 1.0.2

Lognitor SDK for Python — log management, error tracking, and monitoring

lognitor

Official Lognitor SDK for Python — log management, error tracking, and monitoring.

Install

pip install lognitor

Quick Start

import lognitor

lognitor.init(
    api_key="your-api-key",
    service="my-python-app",
    environment="production",
)

lognitor.info("Server started", metadata={"port": 8000})

Log Levels

lognitor.debug("Cache miss", metadata={"key": "user:123"})
lognitor.info("Order created", metadata={"order_id": "ord_456"})
lognitor.warn("Rate limit approaching")
lognitor.error("Payment failed", error=ValueError("Card declined"))
lognitor.fatal("Database corrupted")

Error Tracking

try:
    process_payment(order)
except Exception as e:
    lognitor.capture_exception(e, metadata={"order_id": order.id})

User Context

lognitor.set_user({"id": "user_123", "email": "[e-mail]"})
lognitor.clear_user()

Framework Integrations

Django

# settings.py
MIDDLEWARE = ["lognitor.integrations.django.LognitorMiddleware", ...]
LOGNITOR = {"api_key": "your-key", "service": "my-django-app", "environment": "production"}

Flask

from lognitor.integrations.flask import init_app
client = init_app(app, api_key="your-key", service="my-flask-app")

FastAPI

from lognitor.integrations.fastapi import LognitorMiddleware
app.add_middleware(LognitorMiddleware, api_key="your-key", service="my-fastapi-app")

Configuration

Option	Default	Description
api_key	required	Project API key
service	None	Service name
environment	None	Environment
batch_size	25	Logs per batch
flush_interval	5.0	Auto-flush interval (seconds)
max_retries	3	Retry count
min_level	None	Minimum level to send
redact_patterns	[]	PII patterns to redact
before_send	None	Transform/filter callback

More

• Child loggers: lognitor.child(service="payments")
• Timers: t = lognitor.start_timer(); t.end("Done")
• Heartbeat: lognitor.heartbeat("token").wrap(lambda: job())
• Releases: lognitor.register_release(version="2.0")
• Python logging bridge: from lognitor.logging_handler import LogHandler

Full documentation: docs.lognitor.com

Compatibility

Python 3.8+. No external dependencies.