Troubleshooting¶
Use this section to move from a storage symptom to a validated cause quickly. The structure follows an App Service-style flow: mental model first, first-10-minutes checklists second, detailed playbooks third.
mermaid flowchart TD A[Incident starts] --> B[Quick Diagnosis Cards] B --> C[Decision Tree] C --> D[First 10 Minutes] D --> E[Playbook] E --> F[Evidence Collection] F --> G[Mitigation and Prevention]
Start Here¶
| Need | Open First |
|---|---|
| Understand storage failure surfaces | Architecture Overview |
| Route from symptom to the right playbook | Decision Tree |
| Know what proof to collect | Evidence Map |
| Build a better investigation mindset | Mental Model |
| Get a 60-second triage summary | Quick Diagnosis Cards |
First 10 Minutes¶
| Checklist | Use When |
|---|---|
| Access | Endpoint unreachable, DNS mismatch, mount failure, private endpoint confusion |
| Performance | Slow transfers, latency spikes, 429/503, throughput drop |
| Security | 403, token rejection, RBAC/SAS confusion, auth method mismatch |
Playbooks¶
Access¶
- Cannot Access Storage Account
- Private Endpoint and DNS Issues
- File Share Mount Issues
- Public vs Private Access Confusion
Performance¶
Security¶
Investigation Order¶
- Classify the symptom as access, performance, or security.
- Run the matching first-10-minutes checklist.
- Open the most likely playbook.
- Collect evidence before making changes.
- Apply the smallest safe mitigation and re-test.