docs: add 12-factor troubleshooting section
Metadata
Current evaluation
Merged. Adds a 12-factor app troubleshooting section covering log access for Juju, application, and MicroK8s, plus SSH debugging into Juju containers. Approved by two reviewers and passed CI checks.
Suggested action: —
No scores available.
Issue body
Add a troubleshooting section into the "Use a 12-factor app charm" page that covers how a user would access logs (Juju, application, MicroK8s) and how the user can SSH into the Juju container for more in-depth debugging.
Additional reviewers: @javierdelapuente @jdkandersson
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | — | Merged. Adds a 12-factor app troubleshooting section covering log access for Juju, application, and MicroK8s, plus SSH debugging into Juju containers. Approved by two reviewers and passed CI checks. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged documentation update adding a troubleshooting section to the Use a 12-factor app charm page. The update covers accessing Juju, application, and MicroK8s logs, and SSHing into Juju containers for in-depth debugging. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged documentation update adding a troubleshooting section to the 12-factor app charm guide. Covers accessing Juju, application, and MicroK8s logs, plus SSH debugging into Juju containers. Reviewed by @javierdelapuente and @jdkandersson. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #2352 docs: update 12-factor how-to guide on async apps | charmcraft | merged | Merged documentation update to the 12-factor async apps guide. Changes add a Django compatibility note, requirements.txt caption, assumed app name, and adjusted juju monitoring advice. Approved by two reviewers and passed CI checks. | |
| #2276 docs: Updates to the 12-factor tutorials | charmcraft | merged | Merged documentation updates across four 12-factor tutorials. Changes add rock and Juju model explanations, standardize instructional wording, and include context notes. Approved by reviewers and integrated. | |
| #2354 docs: Incorporate UX feedback into 12-factor tutorials | charmcraft | merged | Merged documentation updates to 12-factor tutorials based on UX feedback. Changes include switching code blocks to dropdowns, adding explicit paths, and clarifying MicroK8s and Juju setup. Approved by two reviewers and merged after CI validation. | |
| #2219 Docs: Add 12-factor how-to sections for integrations | charmcraft | merged | Merged documentation update adding three sections on integrating web app charms with databases, ingress, and observability. Approved by three reviewers, the change modifies one file with 50 additions and 2 deletions. | |
| #2241 Docs: Update 12-factor tutorials | charmcraft | merged | Merged documentation updates to the 12-factor tutorials. Changes add UX tips for charmcraft and juju status, update rockcraft output, note faster builds, and condense architecture text. Approved by two reviewers and passed CI. | |
| #2220 docs: 12-factor tutorial maintenance | charmcraft | merged | Merged documentation maintenance for 12-factor tutorials. Changes include numbered task lists, tildes for root directories, explicit paths in captions, and renaming visitors_app.py to app.py. Approved by two reviewers with passing CI. |