structlog

structlog : структурированное ведение журнала для Python

Простой. Мощный. Быстрый. Выберите три.

structlog — это готовое к использованию решение для ведения журналов для Python:

• Просто : все дело в функциях , которые принимают и возвращают словари — и все это скрыто за знакомыми API .
• Мощный : функции и словари не просто просты, но и мощны. structlog оставляет вам контроль.
• Быстро : structlog не страдает от замыслов прошлого. Его гибкость достигается не за счет производительности.

Благодаря гибкому дизайну вы можете выбрать, хотите ли вы, чтобы structlog позаботился о выводе ваших записей журнала, или вы предпочитаете пересылать их в существующую систему журналирования, такую ​​​​как модуль logging стандартной библиотеки.

Формат вывода столь же гибок, а structlog поддерживает JSON, logfmt , а также красивый готовый вывод на консоль:

Пожалуйста, рассмотрите возможность присоединиться к ним, чтобы сделать обслуживание structlog более устойчивым!

Введение

structlog успешно используется в производстве любого масштаба с 2013 года , охватывая при этом передовые технологии, такие как asyncio , контекстные переменные или подсказки типов по мере их появления. Его парадигмы оказались достаточно влиятельными, чтобы помочь в разработке пакетов структурированного ведения журналов в различных экосистемах.

Краткое объяснение того, почему структурированное ведение журнала полезно для вас и почему structlog — правильный инструмент для этой работы, можно найти в главе «Почему» нашей документации.

Как только вы почувствуете вдохновение попробовать его, ознакомьтесь с нашим дружелюбным руководством по началу работы.

Полноценное руководство по нулевому герою можно найти в «Комплексном руководстве по ведению журналов Python с помощью structlog» .

Если вы предпочитаете видео чтению, посмотрите выступление Маркуса Холтермана «Переосмысление ведения журнала 2: Действия Фрэнка Тейлора-младшего» :

Кредиты

structlog пишет и поддерживает Хайнек Шлавак. Идея связанных лесорубов вдохновлена ​​предыдущими работами Жана-Поля Кальдерона и Дэвида Рида.

Разработку любезно поддерживают мой работодатель Variomedia AG, подписчики structlog Tidelift и все мои замечательные спонсоры GitHub.

Логотип бобра, любящего бревна, был создан Линн Рут.

Ссылки на проекты

• Получить помощь (используйте тег structlog при переполнении стека)
• ПиПИ
• GitHub
• Документация
• Журнал изменений
• Сторонние расширения

структурный журнал для предприятия

Доступно как часть подписки Tidelift.

Разработчики structlog и тысяч других пакетов сотрудничают с Tidelift, чтобы обеспечить коммерческую поддержку и обслуживание пакетов с открытым исходным кодом, которые вы используете для создания своих приложений. Экономьте время, снижайте риски и улучшайте работоспособность кода, платя при этом разработчикам тех пакетов, которые вы используете.