Diagnose a failed AWS SAM deployment log

Analyze a saved AWS SAM or CloudFormation deployment log locally and produce a redacted report with targeted verification steps.

SAM Doctor recognizes common AWS SAM, CloudFormation, IAM, CDK, and GitHub Actions deployment failures. It produces a first-pass diagnosis with matched evidence and targeted, safe verification steps.
The tool reads a saved log locally. It does not require AWS credentials or upload log data; review the redacted report before sharing it.

Install SAM Doctor

Install the command-line tool in the Python environment you use for deployment troubleshooting.

python -m pip install sam-doctor
                                


Diagnose the saved deployment log

Run a local analysis and print a Markdown report suitable for a ticket or review thread.

sam-doctor diagnose deployment.log --format markdown

                                


Prepare a redacted support packet

Create a redacted excerpt and the context needed to report an unsupported failure without sharing the complete log.

sam-doctor request-packet deployment.log
                                


Created by:

Jacob Goldstein

Jacob Goldstein

Builds practical tooling for dependable AWS deployments.