> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Generate a Sysdiagnose in macOS

> Generate a sysdiagnose report on Mac computers for Apple Support troubleshooting. Collect system logs, crash reports, and diagnostic data from macOS.

<Callout icon="apple" color="#B84A7A" iconType="regular">This guide applies to Mac computers</Callout>

### About Sysdiagnose

A sysdiagnose in macOS is a powerful tool designed to help troubleshoot and debug complex system issues. It collects a wide range of diagnostic data from your Mac, making it invaluable for identifying performance problems, crashes, and other system anomalies. Sysdiagnoses can be generated using a few different methods, each of which may apply for different levels of user access.

### How It Works

Sysdiagnose collects comprehensive system information to help diagnose issues. The tool gathers performance data, logs, hardware information, and system state details that can be analyzed to identify problems or performance bottlenecks.

* [Generating a Sysdiagnose Using a Keyboard Shortcut](#generating-a-sysdiagnose-using-a-keyboard-shortcut)
* [Generating a Sysdiagnose Using the Command Line](#generating-a-sysdiagnose-using-the-command-line)
* [Generating a Sysdiagnose Using Activity Monitor](#generating-a-sysdiagnose-using-activity-monitor)

### What Sysdiagnose Collects

When you run sysdiagnose, it gathers an extensive array of information, including:

* **System-wide performance profiles** - Captures the state of running processes
* **Filesystem activity logs** - Reports on system calls and page faults related to filesystem usage
* **Process information** - Provides detailed data on running processes and memory usage
* **Kernel memory usage** - Includes data on kernel zones and loaded kernel extensions
* **System and crash logs** - Collects all relevant logs to help diagnose issues
* **Hardware and software configuration** - Similar to the System Information app, but more detailed
* **Network and power management data** - Details on current network status and power settings

### Generating a Sysdiagnose Using a Keyboard Shortcut

<Steps>
  <Step title="Open Finder">
    Click the **Finder icon** in the Dock to ensure that Finder is in the foreground.
  </Step>

  <Step title="Use keyboard shortcut">
    All at once, press **Command + Option + Shift + Control + Period (.)** on the keyboard.
  </Step>

  <Step title="Wait for completion">
    After a few moments, a Finder window should appear with a tar.gz file shown.
  </Step>

  <Step title="Provide to support">
    If the sysdiagnose was requested by Iru Endpoint Support, please zip it and provide the entire bundle.
  </Step>
</Steps>

### Generating a Sysdiagnose Using the Command Line

This method requires administrator privileges.

<Steps>
  <Step title="Launch Terminal and run command">
    Launch Terminal.app and enter the following command:

    ```
    sudo sysdiagnose -f ~/Desktop/
    ```
  </Step>

  <Step title="Wait for file generation">
    Wait a few moments for a file ending in .tar.gz to appear on the logged-in user's Desktop. If you logged into Terminal with a different user than is logged into the Mac, the file will be on the Terminal user's Desktop.
  </Step>

  <Step title="Provide to support">
    If the sysdiagnose was requested by Iru Endpoint Support, please zip it and provide the entire bundle.
  </Step>
</Steps>

### Generating a Sysdiagnose Using Activity Monitor

This method requires administrator privileges.

<Steps>
  <Step title="Open Activity Monitor">
    Open the Activity Monitor app on your Mac.
  </Step>

  <Step title="Access system diagnostics">
    Click the **ellipsis** at the top of the Activity Monitor window.

    Select **System Diagnostics...**

    <Frame>
      <img src="https://mintcdn.com/iru/qQl9m4UQwfP-FkWY/assets/media/images/jqjutc8estcs6u1nypa_9dfciaoudw0mmq.png?fit=max&auto=format&n=qQl9m4UQwfP-FkWY&q=85&s=8224382b79259705cf061230fed28283" alt="Activity Monitor interface showing the ellipsis menu with System Diagnostics option for generating sysdiagnose reports" width="1353" height="934" data-path="assets/media/images/jqjutc8estcs6u1nypa_9dfciaoudw0mmq.png" />
    </Frame>
  </Step>

  <Step title="Accept privacy agreement">
    Read through and accept the privacy agreement.
  </Step>

  <Step title="Wait for completion">
    Wait for the progress bar to complete. Once done, a Finder window should appear with a tar.gz file shown.
  </Step>

  <Step title="Provide to support">
    If the sysdiagnose was requested by Iru Endpoint Support, please zip it and provide the entire bundle.
  </Step>
</Steps>