<div align="center">
<img align="center" width="128px" src="https://avatars.githubusercontent.com/u/140384842?s=200&v=4" />
<h1 align="center"><b>falken-trace-py</b></h1>
<p align="center">
Enhance OpenTelemetry with pinpointed code-level observability for Python.
<br />
<a href="https://github.com/baz-scm/"><strong>Baz on GitHub ยป</strong></a>
<br />
<br />
<b>Install via PyPI</b>
<br />
<code>pip install --upgrade falken-trace</code>
<br />
<br />
<b>Libraries Available</b>
<br />
Python: <a href="https://github.com/baz-scm/falken-trace-py">falken-trace-py</a> ยท
Go: <a href="https://github.com/baz-scm/falken-trace-go">falken-trace-go</a>
</p>
</div>
---



## ๐ What is Falken Trace?
Falken Trace extends OpenTelemetry and Datadog for Python by pinpointing **file names, function names**, and **line numbers** that generate spans. It addresses gaps in default observability implementations, making tracing faster and more actionable.
Default OpenTelemetry tracing for Python lacks this granularity, which we uncovered while building our contextual code review platform at [baz.co](https://baz.co).
With Falken Trace, troubleshooting becomes faster, more precise, and far more effective, giving you a crystal-clear view of codebase flows.
---
## Install
```shell
pip install --upgrade falken-trace
```
## Usage
Add the `falken_trace` import at the beginning of the application entrypoint file
```python
import falken_trace # noqa
from ddtrace import patch_all
```
# ๐ Learn More
Go library: https://github.com/baz-scm/falken-trace-go
Blog post: [Extending OpenTelemetry to Pinpoint Code Elements](https://baz.co/resources/extending-opentelemetry-to-pinpoint-code-elements-our-journey-to-close-the-gap)
Raw data
{
"_id": null,
"home_page": "https://github.com/baz-scm/falken-trace-py",
"name": "falken-trace",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "observability, tracing",
"author": "Baz",
"author_email": "info@baz.co",
"download_url": "https://files.pythonhosted.org/packages/aa/a6/0122d451affd93c22b6c32cba821ebb05aa22d61ad2f55b4701c148af9bc/falken_trace-0.2.0.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <img align=\"center\" width=\"128px\" src=\"https://avatars.githubusercontent.com/u/140384842?s=200&v=4\" />\n <h1 align=\"center\"><b>falken-trace-py</b></h1>\n <p align=\"center\">\n Enhance OpenTelemetry with pinpointed code-level observability for Python.\n <br />\n <a href=\"https://github.com/baz-scm/\"><strong>Baz on GitHub \u00bb</strong></a>\n <br />\n <br />\n <b>Install via PyPI</b>\n <br />\n <code>pip install --upgrade falken-trace</code>\n <br />\n <br />\n <b>Libraries Available</b>\n <br />\n Python: <a href=\"https://github.com/baz-scm/falken-trace-py\">falken-trace-py</a> \u00b7 \n Go: <a href=\"https://github.com/baz-scm/falken-trace-go\">falken-trace-go</a>\n </p>\n</div>\n\n---\n\n \n \n\n\n## \ud83d\ude80 What is Falken Trace?\n\nFalken Trace extends OpenTelemetry and Datadog for Python by pinpointing **file names, function names**, and **line numbers** that generate spans. It addresses gaps in default observability implementations, making tracing faster and more actionable.\n\nDefault OpenTelemetry tracing for Python lacks this granularity, which we uncovered while building our contextual code review platform at [baz.co](https://baz.co).\n\nWith Falken Trace, troubleshooting becomes faster, more precise, and far more effective, giving you a crystal-clear view of codebase flows.\n\n---\n## Install\n\n```shell\npip install --upgrade falken-trace\n```\n\n## Usage\nAdd the `falken_trace` import at the beginning of the application entrypoint file\n\n```python\nimport falken_trace # noqa\n\nfrom ddtrace import patch_all\n```\n\n# \ud83d\udd17 Learn More\nGo library: https://github.com/baz-scm/falken-trace-go\n\nBlog post: [Extending OpenTelemetry to Pinpoint Code Elements](https://baz.co/resources/extending-opentelemetry-to-pinpoint-code-elements-our-journey-to-close-the-gap)\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Enhances traces with code metadata",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/baz-scm/falken-trace-py",
"Repository": "https://github.com/baz-scm/falken-trace-py",
"changelog": "https://github.com/baz-scm/falken-trace-py/blob/main/CHANGELOG.md",
"releases": "https://github.com/baz-scm/falken-trace-py/releases"
},
"split_keywords": [
"observability",
" tracing"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "52fa335c77f1099ea24d2c839d90ccc9599e016fc3429964b4cf63c04d6862b7",
"md5": "540e44e3a48d0d1865f1847428ee46d4",
"sha256": "9c8b95860774a2d3ff26cfabee8d7a04788a59e17e85fbfd93a8be09efe4c070"
},
"downloads": -1,
"filename": "falken_trace-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "540e44e3a48d0d1865f1847428ee46d4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 10468,
"upload_time": "2025-02-23T11:22:14",
"upload_time_iso_8601": "2025-02-23T11:22:14.956904Z",
"url": "https://files.pythonhosted.org/packages/52/fa/335c77f1099ea24d2c839d90ccc9599e016fc3429964b4cf63c04d6862b7/falken_trace-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "aaa60122d451affd93c22b6c32cba821ebb05aa22d61ad2f55b4701c148af9bc",
"md5": "847a68495a9747f35e83c9330a6c45fe",
"sha256": "316b1a5f00beb40a8272a630ee25071a39fa0a32463934f0db6d2ff89a12e128"
},
"downloads": -1,
"filename": "falken_trace-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "847a68495a9747f35e83c9330a6c45fe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 8527,
"upload_time": "2025-02-23T11:22:16",
"upload_time_iso_8601": "2025-02-23T11:22:16.629212Z",
"url": "https://files.pythonhosted.org/packages/aa/a6/0122d451affd93c22b6c32cba821ebb05aa22d61ad2f55b4701c148af9bc/falken_trace-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-23 11:22:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "baz-scm",
"github_project": "falken-trace-py",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "falken-trace"
}