Skip to content

Conversation

@B-Step62
Copy link

Hi team!

Semantic Kernel and Agent Framework both supports OpenTelemetry tracing, which allows users to export traces to third party tracing providers like MLflow. We (MLflow maintainers) have received questions about how to setup tracing for Semantic Kernel and Agent Framework from multiple times, therefore we believe it is benefitial for users to have a guide in the official documentation. Many other agent authroing frameworks have similar 3P tracing page(s) in their documentation.

Note: I could not find how to run preview website, so only checked the format via naive markdown preview. Please let me know if there is a way to build and preview doc page locally.

@B-Step62
Copy link
Author

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

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit febd726:

⚠️ Validation status: warnings

File Status Preview URL Details
semantic-kernel/concepts/enterprise-readiness/observability/telemetry-with-mlflow.md ⚠️Warning Details
semantic-kernel/concepts/enterprise-readiness/observability/TOC.yml ⚠️Warning Details
agent-framework/user-guide/agents/agent-observability.md 💡Suggestion Details
agent-framework/user-guide/workflows/observability.md 💡Suggestion Details
semantic-kernel/concepts/enterprise-readiness/observability/index.md 💡Suggestion Details

semantic-kernel/concepts/enterprise-readiness/observability/telemetry-with-mlflow.md

  • Line 0, Column 0: [Warning: pivot-id-unused] Pivot ID 'programming-language-csharp' is defined in 'programming-languages' group in 'zone-pivot-groups.yml', but not used. You must use all pivot IDs in a pivot group to avoid blank tabs.
  • Line 0, Column 0: [Warning: pivot-id-unused] Pivot ID 'programming-language-java' is defined in 'programming-languages' group in 'zone-pivot-groups.yml', but not used. You must use all pivot IDs in a pivot group to avoid blank tabs.
  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/semantic-kernel-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.
  • Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.
  • Line 6, Column 11: [Suggestion: value-deprecated-replace - See documentation] The 'ms.topic: conceptual' you used is now deprecated and can no longer be used. We suggest you replace it with 'ms.topic: article'.

semantic-kernel/concepts/enterprise-readiness/observability/TOC.yml

  • Line 12, Column 9: [Warning: file-not-found - See documentation] Invalid file link: 'mlflow.mdx'.

agent-framework/user-guide/agents/agent-observability.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/microsoft-agent-framework-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

agent-framework/user-guide/workflows/observability.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/microsoft-agent-framework-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

semantic-kernel/concepts/enterprise-readiness/observability/index.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/semantic-kernel-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.
  • Line 6, Column 11: [Suggestion: value-deprecated-replace - See documentation] The 'ms.topic: conceptual' you used is now deprecated and can no longer be used. We suggest you replace it with 'ms.topic: article'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@markwallace-microsoft
Copy link
Contributor

@B-Step62 Theer are some warnings and a merge conflict that need to be resolved

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 1d8063c:

⚠️ Validation status: warnings

File Status Preview URL Details
⚠️Warning Details
semantic-kernel/concepts/enterprise-readiness/observability/telemetry-with-mlflow.md ⚠️Warning Details
semantic-kernel/concepts/enterprise-readiness/observability/TOC.yml ⚠️Warning Details
agent-framework/user-guide/observability.md 💡Suggestion Details
agent-framework/user-guide/workflows/observability.md 💡Suggestion Details
semantic-kernel/concepts/enterprise-readiness/observability/index.md 💡Suggestion Details
agent-framework/user-guide/agents/agent-observability.md ✅Succeeded

  • Line 0, Column 0: [Warning: redirected-file-not-removed - See documentation] Redirected file 'user-guide/agents/agent-observability.md' are still in the repo. After adding a file to the redirection JSON file, you must delete the original file from the repo.

semantic-kernel/concepts/enterprise-readiness/observability/telemetry-with-mlflow.md

  • Line 0, Column 0: [Warning: pivot-id-unused] Pivot ID 'programming-language-csharp' is defined in 'programming-languages' group in 'zone-pivot-groups.yml', but not used. You must use all pivot IDs in a pivot group to avoid blank tabs.
  • Line 0, Column 0: [Warning: pivot-id-unused] Pivot ID 'programming-language-java' is defined in 'programming-languages' group in 'zone-pivot-groups.yml', but not used. You must use all pivot IDs in a pivot group to avoid blank tabs.
  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/semantic-kernel-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.
  • Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

semantic-kernel/concepts/enterprise-readiness/observability/TOC.yml

  • Line 12, Column 9: [Warning: file-not-found - See documentation] Invalid file link: 'mlflow.mdx'.

agent-framework/user-guide/observability.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/microsoft-agent-framework-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

agent-framework/user-guide/workflows/observability.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/microsoft-agent-framework-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

semantic-kernel/concepts/enterprise-readiness/observability/index.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/semantic-kernel-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 3e521b4:

⚠️ Validation status: warnings

File Status Preview URL Details
semantic-kernel/concepts/enterprise-readiness/observability/telemetry-with-mlflow.md ⚠️Warning Details
semantic-kernel/concepts/enterprise-readiness/observability/TOC.yml ⚠️Warning Details
agent-framework/user-guide/observability.md 💡Suggestion Details
agent-framework/user-guide/workflows/observability.md 💡Suggestion Details
semantic-kernel/concepts/enterprise-readiness/observability/index.md 💡Suggestion Details

semantic-kernel/concepts/enterprise-readiness/observability/telemetry-with-mlflow.md

  • Line 0, Column 0: [Warning: pivot-id-unused] Pivot ID 'programming-language-csharp' is defined in 'programming-languages' group in 'zone-pivot-groups.yml', but not used. You must use all pivot IDs in a pivot group to avoid blank tabs.
  • Line 0, Column 0: [Warning: pivot-id-unused] Pivot ID 'programming-language-java' is defined in 'programming-languages' group in 'zone-pivot-groups.yml', but not used. You must use all pivot IDs in a pivot group to avoid blank tabs.
  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/semantic-kernel-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.
  • Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

semantic-kernel/concepts/enterprise-readiness/observability/TOC.yml

  • Line 12, Column 9: [Warning: file-not-found - See documentation] Invalid file link: 'mlflow.mdx'.

agent-framework/user-guide/observability.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/microsoft-agent-framework-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

agent-framework/user-guide/workflows/observability.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/microsoft-agent-framework-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

semantic-kernel/concepts/enterprise-readiness/observability/index.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/semantic-kernel-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

Signed-off-by: B-Step62 <[email protected]>
@B-Step62
Copy link
Author

B-Step62 commented Jan 9, 2026

Hi @markwallace-microsoft, resolved the conflict and addressed comments from the auto review.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 169155a:

⚠️ Validation status: warnings

File Status Preview URL Details
semantic-kernel/concepts/enterprise-readiness/observability/telemetry-with-mlflow.md ⚠️Warning Details
semantic-kernel/concepts/enterprise-readiness/observability/TOC.yml ⚠️Warning Details
agent-framework/user-guide/observability.md 💡Suggestion Details
agent-framework/user-guide/workflows/observability.md 💡Suggestion Details
semantic-kernel/concepts/enterprise-readiness/observability/index.md 💡Suggestion Details

semantic-kernel/concepts/enterprise-readiness/observability/telemetry-with-mlflow.md

  • Line 0, Column 0: [Warning: pivot-id-unused] Pivot ID 'programming-language-csharp' is defined in 'programming-languages' group in 'zone-pivot-groups.yml', but not used. You must use all pivot IDs in a pivot group to avoid blank tabs.
  • Line 0, Column 0: [Warning: pivot-id-unused] Pivot ID 'programming-language-java' is defined in 'programming-languages' group in 'zone-pivot-groups.yml', but not used. You must use all pivot IDs in a pivot group to avoid blank tabs.
  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/semantic-kernel-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.
  • Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

semantic-kernel/concepts/enterprise-readiness/observability/TOC.yml

  • Line 12, Column 9: [Warning: file-not-found - See documentation] Invalid file link: 'telemetry-with-mlflow.mdx'.

agent-framework/user-guide/observability.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/microsoft-agent-framework-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

agent-framework/user-guide/workflows/observability.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/microsoft-agent-framework-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

semantic-kernel/concepts/enterprise-readiness/observability/index.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/semantic-kernel-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

Signed-off-by: B-Step62 <[email protected]>
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 7d3cf34:

⚠️ Validation status: warnings

File Status Preview URL Details
semantic-kernel/concepts/enterprise-readiness/observability/telemetry-with-mlflow.md ⚠️Warning Details
agent-framework/user-guide/observability.md 💡Suggestion Details
agent-framework/user-guide/workflows/observability.md 💡Suggestion Details
semantic-kernel/concepts/enterprise-readiness/observability/index.md 💡Suggestion Details
semantic-kernel/concepts/enterprise-readiness/observability/TOC.yml ✅Succeeded

semantic-kernel/concepts/enterprise-readiness/observability/telemetry-with-mlflow.md

  • Line 0, Column 0: [Warning: pivot-id-unused] Pivot ID 'programming-language-csharp' is defined in 'programming-languages' group in 'zone-pivot-groups.yml', but not used. You must use all pivot IDs in a pivot group to avoid blank tabs.
  • Line 0, Column 0: [Warning: pivot-id-unused] Pivot ID 'programming-language-java' is defined in 'programming-languages' group in 'zone-pivot-groups.yml', but not used. You must use all pivot IDs in a pivot group to avoid blank tabs.
  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/semantic-kernel-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.
  • Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

agent-framework/user-guide/observability.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/microsoft-agent-framework-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

agent-framework/user-guide/workflows/observability.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/microsoft-agent-framework-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

semantic-kernel/concepts/enterprise-readiness/observability/index.md

  • Line 0, Column 0: [Suggestion: external-image] Image 'https://mlflow.org/docs/latest/images/llms/tracing/semantic-kernel-tracing.png' references an external site. This poses a security risk and external images are unavailable in some environments. Reference an image file within the repo instead.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

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