دليل Python مع AllStak

تتبّع الأخطاء والطلبات في FastAPI أو Flask أو Django أو أي تطبيق Python عبر حزمة AllStak Python SDK (Python 3.9+).

المستودع المصدر:
AllStak/allstak-python
مسار README:
README.md
إصدار الـ SDK:
0.2.0
مصدر التثبيت:
PyPI
آخر تحقّق:
2026-05-31

التثبيت

ثبّت من PyPI. تتوفّر إضافات لأطر العمل، مثل allstak[fastapi] و allstak[flask] و allstak[django].

pip install allstak

الإعداد

هيّئ عند بدء التطبيق. يعود api_key إلى متغيّر البيئة ALLSTAK_API_KEY عند غيابه.

import os
import allstak

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

مثال أساسي

يُجهَّز FastAPI/Starlette تلقائيًا بعد init؛ ويمكنك ربطه صراحةً. ويستخدم Flask الصيغة AllStakFlask(app)؛ ويضيف Django القيمة "allstak" إلى INSTALLED_APPS.

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

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

التقاط الأخطاء

التقط الاستثناءات المُعالَجة صراحةً.

allstak.capture_exception(RuntimeError("checkout failed"))

تتبّع الطلبات

بعد init، يسجّل تكامل إطار العمل الطلبات الواردة تلقائيًا. ويمكن تسجيل HTTP الصادر عبر allstak.http.record(direction="outbound", method=..., host=..., path=..., status_code=..., duration_ms=...).

أفضل الممارسات

  • استدعِ allstak.init() قبل إنشاء نسخة التطبيق.
  • اضبط release لتجميع الأخطاء لكل نشر.
  • ثبّت إضافة إطار العمل المطابقة (fastapi/flask/django) للتكاملات.
ابدأ مجاناً كل الأدلّة