Monocle Apptrace
Monocle helps developers and platform engineers building or managing GenAI apps monitor these in prod by making it easy to instrument their code to capture traces that are compliant with open-source cloud-native observability ecosystem.
Monocle is a community-driven OSS framework for tracing GenAI app code governed as a Linux Foundation AI & Data project.
Use Monocle
- Get the Monocle package
pip install monocle_apptrace
- Instrument your app code
- Import the Monocle package
from monocle_apptrace.instrumentor import setup_monocle_telemetry - Setup instrumentation in your
main()functionsetup_monocle_telemetry(workflow_name="your-app-name")
- Import the Monocle package
- (Optionally) Modify config to alter where traces are sent
See Monocle user guide for more details.
Claude Code Instrumentation
# 1. Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh
# 2. Install package
uv tool install monocle_apptrace
# 3. Register hooks — prompts for Okahu API key (leave blank for local-only)
monocle-apptrace claude-setup
Start a new Claude Code session — traces flow automatically.
See Hook Setup Guide for complete instructions.
Codex CLI Instrumentation
# 1. Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh
# 2. Install package
uv tool install monocle_apptrace
# 3. Register hooks — prompts for Okahu API key (leave blank for local-only)
monocle-apptrace codex-setup
Start a new Codex session — traces flow automatically.
See Hook Setup Guide for complete instructions.
GitHub Copilot Instrumentation
# 1. Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh
# 2. Install package
uv tool install monocle_apptrace
# 3. Register hooks — prompts for Okahu API key (leave blank for local-only)
monocle-apptrace copilot-setup
After setup, reload your environment for the config to take effect — run source ~/.zshrc (or your shell's equivalent) in the terminal, or Developer: Reload Window in VS Code.
Captures traces from both Copilot CLI and VS Code Copilot Chat. Start a session — traces flow automatically.
Token counts are collected via Copilot's built-in OpenTelemetry file exporter, which copilot-setup enables automatically. Trace data is written to ~/.monocle/.copilot_otel/copilot.jsonl and attached to the emitted OTel spans at the end of each turn.
See Hook Setup Guide for complete instructions.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file monocle_apptrace-0.8.14.tar.gz.
File metadata
- Download URL: monocle_apptrace-0.8.14.tar.gz
- Upload date:
- Size: 281.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
61a7126baeedac7c77092a92046bdda0fd7e940ff2dc676c2caf027ff739e53a
|
|
| MD5 |
343c7b127e7021b00971775f38aae9ad
|
|
| BLAKE2b-256 |
ff87847705dee19ebf6f476141b98e3f101bb2112072019e70ab2412e71e1b1b
|
Provenance
The following attestation bundles were made for monocle_apptrace-0.8.14.tar.gz:
Publisher:
release.yml on monocle2ai/monocle
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
monocle_apptrace-0.8.14.tar.gz -
Subject digest:
61a7126baeedac7c77092a92046bdda0fd7e940ff2dc676c2caf027ff739e53a - Sigstore transparency entry: 2617996118
- Sigstore integration time:
-
Permalink:
monocle2ai/monocle@efc125eeeb01a12b91e2ad16c2d520c173f32346 -
Branch / Tag:
refs/tags/v0.8.14 - Owner: https://github.com/monocle2ai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@efc125eeeb01a12b91e2ad16c2d520c173f32346 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file monocle_apptrace-0.8.14-py3-none-any.whl.
File metadata
- Download URL: monocle_apptrace-0.8.14-py3-none-any.whl
- Upload date:
- Size: 401.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a2ac41ab08108f8049a49e349162a4e99ee5801fad055d0f9ac31c645e511a33
|
|
| MD5 |
633537c904b1f3309a9a1a1fc7d69291
|
|
| BLAKE2b-256 |
e5b20225b08fd40a34f659bd63db1f642b1d07e1f2fb4a4f45913b7198a98e16
|
Provenance
The following attestation bundles were made for monocle_apptrace-0.8.14-py3-none-any.whl:
Publisher:
release.yml on monocle2ai/monocle
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
monocle_apptrace-0.8.14-py3-none-any.whl -
Subject digest:
a2ac41ab08108f8049a49e349162a4e99ee5801fad055d0f9ac31c645e511a33 - Sigstore transparency entry: 2617996138
- Sigstore integration time:
-
Permalink:
monocle2ai/monocle@efc125eeeb01a12b91e2ad16c2d520c173f32346 -
Branch / Tag:
refs/tags/v0.8.14 - Owner: https://github.com/monocle2ai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@efc125eeeb01a12b91e2ad16c2d520c173f32346 -
Trigger Event:
workflow_dispatch
-
Statement type:
