makbool-sdk 1.1.0

Makbool Python SDK — error tracking for Python apps

makbool-sdk

Python SDK для отслеживания ошибок в приложениях. Автоматически перехватывает необработанные исключения и отправляет их в Makbool.

Установка

pip install makbool-sdk

Для Flask или Django — установить с нужной экстрой:

pip install makbool-sdk[flask]
pip install makbool-sdk[django]

Быстрый старт

import makbool_sdk

makbool_sdk.init(project_key='ВАШ_API_КЛЮЧ')

После этого все необработанные исключения отправляются автоматически через sys.excepthook.

Ручная отправка исключения

try:
    risky_operation()
except Exception as e:
    # user_id и url попадают в отдельные поля события,
    # всё остальное — в context (произвольные метаданные)
    makbool_sdk.capture_exception(e, user_id='123', context={'order_id': 42})

Произвольное сообщение

makbool_sdk.capture_message('Что-то пошло не так', level='warning')

Breadcrumbs

makbool_sdk.add_breadcrumb(
    message='Пользователь нажал кнопку оплаты',
    category='ui',
    data={'plan': 'pro'},
)

Flask

from flask import Flask
from makbool_sdk.integrations.flask import MakboolFlaskMiddleware
import makbool_sdk

app = Flask(__name__)
makbool_sdk.init(project_key='ВАШ_API_КЛЮЧ')
MakboolFlaskMiddleware(app)

Django

# settings.py
MIDDLEWARE = [
    'makbool_sdk.integrations.django.MakboolDjangoMiddleware',
    ...
]

Инициализировать SDK при старте приложения (например, в apps.py или wsgi.py):

import makbool_sdk
makbool_sdk.init(project_key='ВАШ_API_КЛЮЧ', environment='production')

Параметры init

Параметр	Обязателен	По умолчанию	Описание
project_key	да	—	API-ключ проекта из дашборда
endpoint	нет	https://makbool.ru/api/v1/errors	URL сервера
environment	нет	production	Метка окружения (staging, dev)
release	нет	None	Версия релиза для фильтрации ошибок

Лицензия

MIT