📅 2025-07-14 — Session: Diagnosed and resolved PromptFlow dependency issues

🕒 15:35–17:30
🏷️ Labels: Promptflow, Azure, Dependency Management, Opentelemetry, Python
📂 Project: Dev
⭐ Priority: MEDIUM

Session Goal

The primary objective of this session was to diagnose and resolve various dependency and environment issues related to the PromptFlow SDK and associated Azure modules.

Key Activities

  • Local Test Plan for Run Locally Documentation: Reviewed a checklist for validating local development environments, focusing on setup steps and common failure modes.
  • Diagnosing and Fixing PromptFlow Dependency Issues: Identified missing Azure SDK modules as the root cause of critical issues with PromptFlow dependencies and outlined a fix strategy.
  • Resolving Versioning and Installation Issues: Addressed versioning issues with the azure-monitor-opentelemetry-exporter package by exploring beta installation options and meta-packages.
  • Understanding and Resolving Telemetry Errors: Investigated telemetry logging errors in PromptFlow, focusing on import failures and deprecated Azure modules.
  • Analyzing Import Dependency Chain: Explored the import dependency chain in PromptFlow to identify bad design and proposed multiple solutions.
  • OpenTelemetry Tracing Strategy: Developed a strategy for implementing OpenTelemetry-based tracing in Python applications without Azure SDK dependencies.

Achievements

  • Successfully diagnosed and resolved several critical dependency and environment issues related to PromptFlow.
  • Developed a comprehensive strategy for OpenTelemetry tracing without Azure SDK dependencies.

Pending Tasks

  • Further testing and validation of the implemented fixes and strategies in different environments.
  • Monitoring for any additional issues that may arise from these changes.