Skip to content

Adding monocle to traces doc #9112

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
hocokahu wants to merge 8 commits into
base: main
Choose a base branch
from
Open

Adding monocle to traces doc #9112

hocokahu wants to merge 8 commits into from
+367 −3

Conversation

@hocokahu
Copy link

@hocokahu hocokahu commented Nov 26, 2025

Monocle is an open source by LF AI & Data Foundation. It is built on top of OpenTelemetry.
It does have support for most framework and models. More info at https://docs.okahu.ai/monocle_overview/

@hocokahu
Copy link
Author

hocokahu commented Nov 26, 2025

@microsoft-github-policy-service agree [company="Okahu, Inc"]

@ntrogh
Copy link
Contributor

ntrogh commented Nov 26, 2025

@hocokahu Thanks for your contribution. Having someone from the product team review this addition to the docs.

@ntrogh ntrogh added aitk AI Toolkit for VS Code extension Content related to VS Code extensions hosted in the VS Code docs don't merge labels Nov 26, 2025
@hocokahu
Copy link
Author

hocokahu commented Nov 26, 2025

@hocokahu please read the following Contributor License Agreement(CLA). If you agree with the CLA, please reply with the following information.

@microsoft-github-policy-service agree [company="{your company}"]

Options:

  • (default - no company specified) I have sole ownership of intellectual property rights to my Submissions and I am not making Submissions in the course of work for my employer.
@microsoft-github-policy-service agree
  • (when company given) I am making Submissions in the course of work for my employer (or my employer has intellectual property rights in my Submissions by contract or applicable law). I have permission from my employer to make Submissions and enter into this Agreement on behalf of my employer. By signing below, the defined term “You” includes me and my employer.
@microsoft-github-policy-service agree company="Microsoft"

Contributor License Agreement

@microsoft-github-policy-service agree [company="Okahu, Inc"]

@hocokahu
Copy link
Author

hocokahu commented Nov 26, 2025

@hocokahu the command you issued was incorrect. Please try again.

Examples are:

@microsoft-github-policy-service agree

and

@microsoft-github-policy-service agree company="your company"

@microsoft-github-policy-service agree company="Okahu, Inc"

@hocokahu
Copy link
Author

hocokahu commented Nov 26, 2025

@hocokahu Thanks for your contribution. Having someone from the product team review this addition to the docs.

Thanks @ntrogh
Happy to jump on a call if needed.

kuojianlu
kuojianlu reviewed Dec 2, 2025
View reviewed changes
docs/intelligentapps/tracing.md Outdated
| | Azure AI Inference | Foundry Agent Service | Anthropic | Gemini | LangChain | OpenAI SDK <sub>3</sub> | OpenAI Agents SDK |
|---|---|---|---|---|---|---|---|
| **Python** | ✅ | ✅ | ✅ ([traceloop](https://github.com/traceloop/openllmetry))<sub>1,2</sub> | ✅ | ✅ ([LangSmith](https://github.com/langchain-ai/langsmith-sdk))<sub>1,2</sub> | ✅ ([opentelemetry-python-contrib](https://github.com/open-telemetry/opentelemetry-python-contrib))<sub>1</sub> | ✅ ([Logfire](https://github.com/pydantic/logfire))<sub>1,2</sub> |
| **Python** | ✅ ([monocle](https://github.com/monocle2ai/monocle)) | ✅ | ✅ ([traceloop](https://github.com/traceloop/openllmetry), [monocle](https://github.com/monocle2ai/monocle))<sub>1,2</sub> | ✅ ([monocle](https://github.com/monocle2ai/monocle)) | ✅ ([LangSmith](https://github.com/langchain-ai/langsmith-sdk), [monocle](https://github.com/monocle2ai/monocle))<sub>1,2</sub> | ✅ ([opentelemetry-python-contrib](https://github.com/open-telemetry/opentelemetry-python-contrib), [monocle](https://github.com/monocle2ai/monocle))<sub>1</sub> | ✅ ([Logfire](https://github.com/pydantic/logfire), [monocle](https://github.com/monocle2ai/monocle))<sub>1,2</sub> |
Copy link

@kuojianlu kuojianlu Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Azure AI Inference is Microsoft's SDK, and it have 1st party support for instrumentation. Thus, I think we'd better not recommend the 3rd party monocle instrumentation.

kuojianlu
kuojianlu reviewed Dec 2, 2025
View reviewed changes
docs/intelligentapps/tracing.md Outdated

![Screenshot showing the Trace Details view in the Tracing webview.](./images/tracing/trace_details.png)

## Example 2: set up tracing with the Azure AI Inference SDK using Monocle
Copy link

@kuojianlu kuojianlu Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think only one example to show the experience is good enough and there is no need to include three examples. @MuyangAmigo What's your opinion?

@ntrogh
Copy link
Contributor

ntrogh commented Dec 2, 2025

@hocokahu Can you please apply the feedback from the review? Thanks!

@hocokahu
Copy link
Author

hocokahu commented Dec 4, 2025

@ntrogh @kuojianlu Yes, I am working on an update.

@hocokahu
Copy link
Author

hocokahu commented Dec 6, 2025

@ntrogh @kuojianlu I removed the 3P part under "Azure AI Inference" and previous Example 2. I still have OpenAI Agents SDK example as I haven't seen one but let me know if you guys want to keep it or remove it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

1 more reviewer

@kuojianlu kuojianlu kuojianlu left review comments

Reviewers whose approvals may not affect merge requirements

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

aitk AI Toolkit for VS Code don't merge extension Content related to VS Code extensions hosted in the VS Code docs

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@hocokahu @ntrogh @kuojianlu