aice-observability 0.2.0__tar.gz

aice_observability-0.2.0/.gitignore

@@ -0,0 +1,28 @@
+# Python bytecode / caches
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Virtualenvs & editors
+.venv/
+.env
+.env.*
+!.env.example
+.vscode/
+.idea/
+.DS_Store
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+node_modules/
+*.tsbuildinfo
+
+# uv / pnpm lockfiles tracked per-package don't ignore them.
+_skills

aice_observability-0.2.0/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog aice-observability
+
+Format loosely follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## 0.2.0
+
+First release on PyPI. Earlier 0.1.x uploads were withdrawn and are not
+available.
+
+### Added
+- `Observability`, an OpenTelemetry bootstrap for Python services: traces,
+  metrics and logs over OTLP/HTTP, configured with `.service(name)` and the
+  standard `OTEL_*` environment variables. `OTEL_SERVICE_NAME`, when set,
+  overrides `.service(name)` and is enough on its own for `.start()`.
+  `OTEL_EXPORTER_OTLP_HEADERS` values are percent-decoded, as the OTel spec
+  requires.
+- Instrumentation for FastAPI, Flask, Django, SQLAlchemy, httpx, Redis,
+  psycopg2, Psycopg 3, asyncpg, botocore (boto3 / S3 / MinIO), Celery,
+  logging and system metrics. Each integration skips quietly when the library
+  it instruments is absent. `instrument_fastapi()` and `instrument_flask()`
+  must run before the app serves its first request, and don't need `.start()`
+  first.
+- `aice_observability.propagation`: `inject_context()`, `extract_context()`
+  and `continue_trace()` for carrying a trace across a hand-rolled queue (a
+  Postgres job table, pgmq). A missing or malformed carrier starts a new trace.
+- AI telemetry: `ai.agents.invoke_agent()` / `execute_tool()` (with
+  `extra_attributes`) and `ai.metrics.record_budget_event(kind)`
+  (`gen_ai.budget.events` counter).