> ## 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 Submit Iru Agent Diagnostics

> Submit Iru Agent diagnostic data for troubleshooting macOS and Windows issues. Collect logs, generate reports, and share them with support.

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

### About Iru Agent Diagnostics

The Iru Agent has a built-in tool for gathering and submitting detailed diagnostic data from your Mac to Iru Endpoint for troubleshooting. This data includes logs, operating system information, and other relevant details about your device, which helps the Iru Endpoint support team investigate behaviors and provide guidance to troubleshoot issues. For information on submitting macOS-specific diagnostics, please see our [How to Generate a Sysdiagnose in macOS](/en/endpoint/devices/device-configurations/apple/how-to-generate-a-sysdiagnose-in-macos) support article.

<Note>
  As of **April 8, 2026**, apps were updated from **Kandji** <img className="inline dark:hidden" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-light-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=3ac73eb9098c090ac2838a4902a70e35" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-light-icon.png" /><img className="hidden dark:inline" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-dark-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=1d4b643c8e1903aabdb072fdf211f2de" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-dark-icon.png" /> to **Iru** <img src="https://mintcdn.com/iru/8j4H0SpqtcKJ5JUM/assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg?fit=max&auto=format&n=8j4H0SpqtcKJ5JUM&q=85&s=befa6ce99e1df18d397deb65aec8edaf" alt="" style={{ display: 'inline', height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 -0.08em 0 0', padding: 0 }} width="14" height="15" data-path="assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg" /> branding. Submit Diagnostics has been updated to Iru branding. Please update **scripts, automations, and utilities** that still reference the old app names.
</Note>

### How to Submit Iru Agent Diagnostics

There are three ways to submit diagnostics from an Iru Endpoint-enrolled Mac: using the Iru menu bar, using Self Service, or using the command-line interface (CLI).

#### Submitting Diagnostics using the Iru menu bar

<Note>
  If the Iru menu bar icon is hidden, it can be revealed again from the Iru Self Service application.
</Note>

<Steps>
  <Step title="Access Iru menu">
    Select the **Iru jellyfish** from the menu bar.
  </Step>

  <Step title="Open Settings">
    Click the settings **gear**.

    <Frame>
      <img src="https://mintcdn.com/iru/49cA3ckigEsqbInf/assets/media/images/iru-menu-bar.png?fit=max&auto=format&n=49cA3ckigEsqbInf&q=85&s=8ac45e1ddfa4c4b63f1a375e25fa40f0" alt="Iru Endpoint menu bar showing the jellyfish icon and settings gear" width="1330" height="756" data-path="assets/media/images/iru-menu-bar.png" />
    </Frame>
  </Step>

  <Step title="Choose Submit Diagnostics">
    Choose **Submit Diagnostics...** from the dropdown menu.

    <Frame>
      <img src="https://mintcdn.com/iru/49cA3ckigEsqbInf/assets/media/images/iru-menu-bar-gear.png?fit=max&auto=format&n=49cA3ckigEsqbInf&q=85&s=bc30a111f2a1d94282d1f4590da3fd70" alt="Iru Endpoint settings menu open with Submit Diagnostics visible" width="1306" height="744" data-path="assets/media/images/iru-menu-bar-gear.png" />
    </Frame>
  </Step>

  <Step title="Add Comments (Optional)">
    Optionally, add comments describing the issue you're experiencing.
  </Step>

  <Step title="Submit Diagnostics">
    Click **Submit**.

    <Frame>
      <img src="https://mintcdn.com/iru/49cA3ckigEsqbInf/assets/media/images/iru-menu-bar-submit-diagnostics.png?fit=max&auto=format&n=49cA3ckigEsqbInf&q=85&s=0c83736d72e13815d89afbf481ed39da" alt="Iru Endpoint menu bar flow: Submit Diagnostics and submitting diagnostic data" width="892" height="572" data-path="assets/media/images/iru-menu-bar-submit-diagnostics.png" />
    </Frame>
  </Step>
</Steps>

#### Submitting Diagnostics using Iru Self Service

<Steps>
  <Step title="Open Self Service">
    Open the **Self Service** app.
  </Step>

  <Step title="Navigate to Device Info">
    Click **Device Info**.
  </Step>

  <Step title="Access Options Menu">
    Click the **ellipsis** next to Sync.
  </Step>

  <Step title="Select Submit Diagnostics">
    Select **Submit Diagnostics**.

    <Frame>
      <img src="https://mintcdn.com/iru/TjTgZOrl7Pjp2y4D/assets/media/images/zfizkc8gseucr0ovxl00fr9mfxgaxaimbw.png?fit=max&auto=format&n=TjTgZOrl7Pjp2y4D&q=85&s=12d277137243c8d6665d5d747ea9daaf" alt="Iru Self Service Device Info page showing the ellipsis menu with Submit Diagnostics option" width="2220" height="1569" data-path="assets/media/images/zfizkc8gseucr0ovxl00fr9mfxgaxaimbw.png" />
    </Frame>
  </Step>

  <Step title="Add Comments (Optional)">
    Optionally, add comments describing the issue you're experiencing.
  </Step>

  <Step title="Submit Diagnostics">
    Click **Submit**.

    <Frame>
      <img src="https://mintcdn.com/iru/49cA3ckigEsqbInf/assets/media/images/iru-self-service-submit-diagnostics-dialog.png?fit=max&auto=format&n=49cA3ckigEsqbInf&q=85&s=56101982d0516bf74357ee45e2f32dc7" alt="Submit diagnostics dialog with optional comments field and Cancel and Submit buttons for sending diagnostic data to Iru Endpoint" width="1024" height="737" data-path="assets/media/images/iru-self-service-submit-diagnostics-dialog.png" />
    </Frame>
  </Step>
</Steps>

#### Submitting Diagnostics using the Command-Line Interface

This method requires administrator privileges.

<Steps>
  <Step title="Open Terminal">
    Open **Terminal.app**.
  </Step>

  <Step title="Run Diagnostic Command">
    Run the following Terminal command, using `--comment` to add optional comments describing the issue you're experiencing:

    ```bash theme={null}
    sudo iru submit-diagnostics [--comment text]
    ```
  </Step>
</Steps>

### Data and Privacy Considerations

When a user submits diagnostics, the Iru Agent collects the following information from an enrolled Mac:

* System logs
* OS version
* Application inventory
* Device configuration details
* Network information
* Error messages and alerts

Iru Endpoint ensures that the diagnostic data collected is used solely for troubleshooting and improving device management and support, respecting user privacy. For more information on privacy with Iru Endpoint, see our [Privacy Policy](https://www.iru.com/legal/privacy/).