Skip to content

doc: Add MLflow observability integration guide#1114

Merged
omeraplak merged 1 commit into
VoltAgent:mainfrom
B-Step62:docs/add-mlflow-observability
Mar 5, 2026
Merged

doc: Add MLflow observability integration guide#1114
omeraplak merged 1 commit into
VoltAgent:mainfrom
B-Step62:docs/add-mlflow-observability

Conversation

@B-Step62

@B-Step62 B-Step62 commented Feb 28, 2026

Copy link
Copy Markdown
Contributor

PR Checklist

Please check if your PR fulfills the following requirements:

Bugs / Features

This is a doc update only and pnpm changeset only generated an empty file, hence I did not add it in this PR.

Change

This PR adds a guide for tracing/observability integration with MLflow, an open-source LLMOps platform with 30MM monthly download. This guide helps users trace, evaluate, and monitor agents built with VoltAgent.


Summary by cubic

Add an MLflow observability guide showing how to send VoltAgent OpenTelemetry traces to MLflow’s /v1/traces using the OTLP protobuf exporter. Includes setup steps, required env vars, and a screenshot, and adds the page to the Observability sidebar.

Written for commit 95e4b1c. Summary will update on new commits.

Summary by CodeRabbit

  • Documentation
    • Added MLflow integration documentation covering prerequisites, installation steps, environment configuration, and setup code samples for exporting VoltAgent traces via OpenTelemetry OTLP exporter.

Signed-off-by: B-Step62 <yuki.watanabe@databricks.com>
@changeset-bot

changeset-bot Bot commented Feb 28, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 95e4b1c

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@coderabbitai

coderabbitai Bot commented Feb 28, 2026

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

Adds a new documentation file for MLflow integration under the observability section, explaining how to export VoltAgent traces to MLflow via OpenTelemetry OTLP exporter. Updates the sidebar navigation to reference the new documentation.

Changes

Cohort / File(s) Summary
MLflow Documentation
website/docs/observability/mlflow.md
New documentation file covering MLflow integration, including prerequisites, installation, TypeScript setup code samples with OTLPTraceExporter and BatchSpanProcessor configuration, environment variables, and tracing pipeline explanation.
Sidebar Navigation
website/sidebars.ts
Added "observability/mlflow" entry to the Observability section in the docs sidebar.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~8 minutes

Possibly related PRs

Poem

🐰 A fluffy guide hops into view,
MLflow traces, shiny and new!
OpenTelemetry shows the way,
Observability brightens the day! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title 'doc: Add MLflow observability integration guide' clearly and concisely describes the main change—adding documentation for MLflow integration—matching the changeset which adds an MLflow observability guide and updates the sidebar.
Description check ✅ Passed The description covers key required sections including a completed PR checklist, explanation of changes, and notes about why changesets weren't included; it adequately documents the doc-only update with context about MLflow's purpose.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Tip

Try Coding Plans. Let us write the prompt for your AI agent so you can ship faster (with fewer bugs).
Share your feedback on Discord.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

No issues found across 3 files

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
website/docs/observability/mlflow.md (1)

89-91: Optional: vary link text in “Learn More” for better scanability.

All three bullets start with “MLflow”; slight wording variation would improve readability.

Suggested wording tweak
- - [MLflow Tracing](https://mlflow.org/docs/latest/genai/tracing/index.html) — Full tracing guide including evaluation, prompt management, and more.
- - [MLflow OpenTelemetry Integration](https://mlflow.org/docs/latest/genai/tracing/opentelemetry.html) — Details on MLflow's OpenTelemetry support.
- - [MLflow VoltAgent Guide](https://mlflow.org/docs/latest/genai/tracing/integrations/listing/voltagent.html) — Step-by-step setup tutorial with screenshots.
+ - [MLflow Tracing](https://mlflow.org/docs/latest/genai/tracing/index.html) — Full tracing guide including evaluation, prompt management, and more.
+ - [OpenTelemetry Integration in MLflow](https://mlflow.org/docs/latest/genai/tracing/opentelemetry.html) — Details on MLflow's OpenTelemetry support.
+ - [VoltAgent Guide on MLflow](https://mlflow.org/docs/latest/genai/tracing/integrations/listing/voltagent.html) — Step-by-step setup tutorial with screenshots.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@website/docs/observability/mlflow.md` around lines 89 - 91, Vary the three
bullet link texts to improve scanability by rewording each prefix: change
"[MLflow Tracing]" to something like "Tracing with MLflow" (for the tracing
guide), "[MLflow OpenTelemetry Integration]" to "OpenTelemetry in MLflow" (for
the OpenTelemetry support page), and "[MLflow VoltAgent Guide]" to "VoltAgent
setup (MLflow)" or "Setting up VoltAgent" (for the VoltAgent tutorial); update
the displayed link labels in the three list items so they differ while keeping
the same URLs.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@website/docs/observability/mlflow.md`:
- Around line 89-91: Vary the three bullet link texts to improve scanability by
rewording each prefix: change "[MLflow Tracing]" to something like "Tracing with
MLflow" (for the tracing guide), "[MLflow OpenTelemetry Integration]" to
"OpenTelemetry in MLflow" (for the OpenTelemetry support page), and "[MLflow
VoltAgent Guide]" to "VoltAgent setup (MLflow)" or "Setting up VoltAgent" (for
the VoltAgent tutorial); update the displayed link labels in the three list
items so they differ while keeping the same URLs.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d031576 and 95e4b1c.

⛔ Files ignored due to path filters (1)
  • website/static/img/mlflow-tracing.png is excluded by !**/*.png
📒 Files selected for processing (2)
  • website/docs/observability/mlflow.md
  • website/sidebars.ts

@omeraplak

Copy link
Copy Markdown
Member

Thank you so much @B-Step62 🔥

@omeraplak
omeraplak merged commit 549fc45 into VoltAgent:main Mar 5, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants