dagstack-logger 0.1.1rc1

Python binding for dagstack/logger-spec — OTel-compatible structured logging, named loggers hierarchy, context propagation, sinks, scoped overrides

dagstack-logger

Python binding для dagstack/logger-spec — OTel-compatible structured logging с named loggers hierarchy, W3C trace context propagation, pluggable sinks, scoped overrides.

Конфигурируется через dagstack-config.

Status: Phase A (skeleton). Реализация в прогрессе.

Roadmap

• Phase A (this PR) — repo skeleton, pyproject, CI, spec submodule, empty package.
• Phase B — core primitives: LogRecord dataclass, Severity enum, W3C hex encoding, dagstack JSON-lines canonical serializer.
• Phase C — Sink Protocol + Phase 1 sinks: ConsoleSink (JSON/pretty TTY-aware), FileSink (rotation), InMemorySink (ring-buffer).
• Phase D — Logger class (hierarchy, context propagation, redaction, subscriptions), scoped overrides, Logger.configure(config_section) интеграция с dagstack-config.
• Phase 1 release (0.1.0) — MVP без OTLP sink, без LogProcessor chain, без AI-agent extension pack (§5.5 logger-spec).
• Phase 2+ — OTLPSink, LokiSink, SentrySink, LogProcessor chain (redaction/sampling), AI-agent conventions.

Spec

Spec submodule в spec/ → dagstack/logger-spec. Основные decisions — spec/adr/0001-logger-contract.md.

Local development

git clone --recurse-submodules [e-mail]:dagstack/logger-python.git
cd logger-python
uv sync --group dev

make test           # pytest
make lint           # ruff check + format --check
make typecheck      # mypy --strict

Dependencies

• dagstack-config>=0.1.0.dev0 — для конфигурирования.
• opentelemetry-api>=1.20,<2.0 — для trace/span/baggage context propagation (mandatory per spec §3.4).
• opentelemetry-sdk + exporter (optional via [otlp] extras) — для OTLPSink в Phase 2+.

Licensing

Apache-2.0.

Related

• dagstack/logger-spec — language-agnostic spec.
• dagstack/config-python — config binding; logger читает logging: section через этот binding.
• dagstack/plugin-system-python — plugin system; logger instrumentation_scope может быть derived из plugin manifest.