alertiqo 1.0.0

Alertiqo SDK for Python error tracking

Alertiqo Python SDK

Error tracking SDK for Python applications.

Installation

pip install alertiqo

Usage

Basic Setup

from alertiqo import Alertiqo

alertiqo = Alertiqo(
    api_key="your-api-key",
    endpoint="https://alertiqo.hamizi.net",
    environment="production",
    release="1.0.0",
)

alertiqo.init()

Capture Exceptions

try:
    raise ValueError("Something went wrong")
except Exception as e:
    alertiqo.capture_exception(e)

Capture Messages

alertiqo.capture_message("User completed checkout", level="info")

Add Breadcrumbs

alertiqo.add_breadcrumb(
    message="User clicked button",
    category="user-action",
    level="info",
    data={"button_id": "submit-btn"}
)

Set User Context

alertiqo.set_user(
    user_id="12345",
    email="[e-mail]",
    username="johndoe"
)

Set Tags

alertiqo.set_tag("page", "checkout")
alertiqo.set_tags({
    "feature": "payments",
    "version": "2.1.0"
})

Flask Integration

from flask import Flask
from alertiqo import Alertiqo, alertiqo_middleware

app = Flask(__name__)

alertiqo = Alertiqo(
    api_key="your-api-key",
    endpoint="https://alertiqo.hamizi.net",
)
alertiqo.init()

# Add middleware
app.wsgi_app = alertiqo_middleware(alertiqo)(app.wsgi_app)

Django Integration

# settings.py
ALERTIQO_API_KEY = "your-api-key"
ALERTIQO_ENDPOINT = "https://alertiqo.hamizi.net"

# In your app's apps.py or __init__.py
from alertiqo import Alertiqo

alertiqo = Alertiqo(
    api_key=settings.ALERTIQO_API_KEY,
    endpoint=settings.ALERTIQO_ENDPOINT,
)
alertiqo.init()

API

Alertiqo(config)

Creates a new Alertiqo instance.

Config Options:

• api_key (required): Your API key
• endpoint (required): Backend endpoint URL
• environment: Environment name (default: PYTHON_ENV or 'production')
• release: Release version
• tags: Default tags for all errors
• capture_unhandled: Auto-capture uncaught exceptions (default: True)
• before_send: Callback to modify/filter errors before sending

Methods

• init(): Initialize error handlers
• capture_exception(error, additional_data=None): Capture an exception
• capture_message(message, level="info"): Capture a message
• add_breadcrumb(message, category, level, data): Add a breadcrumb
• set_user(user_id, email, username): Set user context
• set_tag(key, value): Set a single tag
• set_tags(tags): Set multiple tags

License

MIT