Skip to content

Add Event Hubs Troubleshooting Guide #24652

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.

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

Merged
merged 11 commits into from
May 22, 2025
Merged

Add Event Hubs Troubleshooting Guide #24652

merged 11 commits into from
May 22, 2025

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented May 19, 2025

This PR adds a comprehensive troubleshooting guide for the Azure Event Hubs Go SDK to provide guidance for customers and support representatives encountering difficulties with the client library.

The guide includes:

  • General troubleshooting information (error handling, logging, authentication)
  • Common error scenarios and their solutions
  • Event Processor troubleshooting for load balancing and checkpointing issues
  • Connectivity guidance for enterprise environments (firewalls, proxies, WebSockets)
  • Advanced troubleshooting techniques (logs to capture, interpretation)
  • Guidelines for filing GitHub issues

The implementation follows the pattern established by other Azure SDK troubleshooting guides:

  • Main guide in /sdk/messaging/azeventhubs/TROUBLESHOOTING.md
  • Stub guide in /sdk/messaging/azeventhubs/checkpoints/TROUBLESHOOTING.md pointing to the main guide
  • Updated README.md to reference the troubleshooting guide

This will help users diagnose and resolve common issues without requiring support escalation.

Fixes #17459.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

  • cdn.fwupd.org
    • Triggering command: /usr/bin/fwupdmgr refresh (dns block)
  • learn.microsoft.com
    • Triggering command: curl -s REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

@Copilot Copilot AI changed the title [WIP] Event Hubs Troubleshooting Guide Add Event Hubs Troubleshooting Guide May 19, 2025
@Copilot Copilot AI requested a review from RickWinter May 19, 2025 17:22
Copilot finished work on behalf of RickWinter May 19, 2025 17:22
- Adding a bit more doc to the guide to show how to configure retries
- Removing ErrorCodeOwnershipLost - 99% of people don't need to handle it, and if they do it'll show up in the processor example.
@richardpark-msft
Copy link
Member

@RickWinter, take a look at my updates.

@RickWinter
Copy link
Member

@RickWinter, take a look at my updates.

Changes look good. I can't approve since I triggered the Agent

@richardpark-msft richardpark-msft marked this pull request as ready for review May 22, 2025 22:57
@richardpark-msft richardpark-msft enabled auto-merge (squash) May 22, 2025 23:00
@richardpark-msft richardpark-msft merged commit ba91d35 into main May 22, 2025
26 checks passed
@richardpark-msft richardpark-msft deleted the copilot/fix-17459 branch May 22, 2025 23:52
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.

Event Hubs Troubleshooting Guide
4 participants