microsoft / microsoft/GitHub-Copilot-for-Azure
Gap-7: Functions Diagnose (B → A) — Trigger/binding/Durable troubleshooting + tests
- Dominant language
- Python
- Stars
- 250
- Forks
- 204
- Avg merge
- 1d 12h
- Merged PRs (30d)
- 67
Description
Parent: #1608
## Functions Diagnose: B → A
**Learning from:** Container Apps (B+) — has both reference docs AND integration tests for diagnostics
**Current state:** Has `functions/README.md` with ARG queries. Missing: integration tests, trigger-specific troubleshooting, binding error diagnosis.
## Deliverables
- [ ] Extend `references/functions/README.md` with:
- Trigger-specific troubleshooting (HTTP 5xx, timer misfires, queue poison messages, blob trigger delays)
- Binding error diagnosis (connection string issues, permission errors, SDK version conflicts)
- Durable Functions troubleshooting (stuck orchestrations, replay issues, task hub conflicts)
- Flex Consumption-specific issues (instance allocation, networking)
- [ ] Add 2 integration tests: trigger failure diagnosis, binding error troubleshooting
## Key Scenarios
- "My timer function is not firing" → NCRONTAB validation, singleton lock, scale controller logs
- "My queue trigger has poison messages" → dead-letter analysis, maxDequeueCount config
- "My Durable orchestration is stuck" → task hub status, purge instance history
> ⚠️ **Starting assessment** — domain experts should modify or contribute what they believe is essential.
Contributor guide
Research direction
Read references/functions/README.md alongside the existing functions/README.md to understand the current ARG queries and documentation structure. Identify the repository's integration-test entry point, then cover trigger-failure and binding-error diagnosis with the requested troubleshooting sections. Done means both README updates and two passing integration tests address the listed scenarios.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- azure
- Domain
- cloud, documentation, testing
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100