How do I collect a system diagnosis report to share with Support to troubleshoot issues with my Amazon EC2 macOS instance?

Resolution

To collect a system diagnosis report, you must run the sysdiagnose command when the issue occurs, or immediately after the issue occurs. This command captures debugging and log information that's required to identify the root cause of the issue

To run sysdiagnose, complete the following steps:

1. Use SSH or screen sharing to connect your EC2 macOS instance.

2. If you're connected with screen sharing, then launch the terminal: /Applications/Utilities/Terminal.app. If you use SSH, then proceed to the next step.

3. To run sysdiagnose, enter the following command:

   sudo /usr/bin/sysdiagnose -b -u -A sysdiagnose-$(hostname).tar.gz -f ~/

4. If prompted, enter your administrator password.

5. To capture the system diagnosis report, press Enter or Return. After sysdiagnose completes its process, you receive a gzipped tarball archive in your home directory. The file name looks similar to the following example: ~/sysdiagnose-hostname.tar.gz.
   Note: If you don't specify a directory when you run sysdiagnose, then you can find the file in /private/var/tmp or /private/tmp.

6. The sysdiagnose process might take up to ten minutes. To share the file with Support, use the Amazon Simple Storage Service (Amazon S3) uploader to upload the sysdiagnose archive to your support case.

Example sysdiagnose output:

sudo /usr/bin/sysdiagnose -b -u -A sysdiagnose-$(hostname).tar.gz -f ~/

Progress:
[|||||||||||||||||||||||||||||||||||||||100%|||||||||||||||||||||||||||||||||||]

Output available at '/Users/ec2-user/ip-172-31-5-1.ec2.internal-sysdiagnose.tar.gz'.

Related information

Profiles and logs on the Apple website