allstak 0.1.2

Official Python SDK for AllStak — error tracking, structured logs, HTTP + DB monitoring, distributed tracing, and cron monitoring with first-class FastAPI, Django and Flask support

allstak

AllStak SDK for Python, Django, Flask, FastAPI, and plain services. Captures exceptions, logs, inbound and outbound HTTP requests, spans, database telemetry, and cron heartbeats.

Install

Not yet on PyPI. pip install allstak is reserved but does not resolve a published artifact yet. Until first publish lands (tracked in docs/devops/sdk-python-dotnet-first-publish.md in the platform monorepo), install directly from source:

pip install "git+https://github.com/AllStak/allstak-python.git@develop"

Once 0.1.x ships on PyPI, the canonical install becomes:

pip install allstak

Setup

import os
import allstak

allstak.init(
    api_key=os.getenv("ALLSTAK_API_KEY"),
    environment=os.getenv("APP_ENV", "production"),
    release=os.getenv("ALLSTAK_RELEASE"),
)

allstak.log.info("worker started")
allstak.capture_exception(RuntimeError("checkout failed"))

FastAPI

from fastapi import FastAPI
from allstak.integrations.fastapi import AllStakFastAPI

app = FastAPI()
AllStakFastAPI(app, service="checkout-api")

Flask

from flask import Flask
from allstak.integrations.flask import AllStakFlask

app = Flask(__name__)
AllStakFlask(app)

Django

Add the middleware:

MIDDLEWARE = [
    "allstak.integrations.django.AllStakDjangoMiddleware",
    *MIDDLEWARE,
]

Spans

with allstak.start_span("checkout.authorize", tags={"provider": "payments"}):
    authorize_payment()

Configuration

Option	Description
api_key	Project API key.
environment	Deployment environment.
release	App version or commit SHA.
flush_interval_ms	Background flush interval.
buffer_size	Max buffered events.

Privacy

The SDK redacts common sensitive headers and fields. Avoid putting secrets in custom metadata.

Troubleshooting

• No events: confirm ALLSTAK_API_KEY is set before allstak.init(...).
• Missing request telemetry: register the framework integration during app startup.
• Short-lived script: call allstak.get_client().flush() before exit when a client is initialized.

Contributing and Support

• Report bugs with the GitHub bug report template: https://github.com/AllStak/allstak-python/issues/new/choose
• Open pull requests using the checklist in CONTRIBUTING.md.
• Report security vulnerabilities privately through SECURITY.md.

License

MIT