Skip to main content
This guide applies to Mac computers

​
About Kandji Agent Diagnostics

The Kandji 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 support article.

​
How to Submit Kandji Agent Diagnostics

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

​
Submitting Diagnostics using the Kandji Menu Bar

If the Kandji menu bar icon is hidden, it can be revealed again from the Kandji Self Service application.
1

Access Kandji Menu

Select the Kandji bee from the menu bar.
2

Open Settings

Click the settings gear.
3

Choose Submit Diagnostics

Choose Submit Diagnostics… from the dropdown menu.
Kandji menu bar interface showing the settings gear icon and Submit Diagnostics option in the dropdown menu
4

Add Comments (Optional)

Optionally, add comments describing the issue you’re experiencing.
5

Submit Diagnostics

Click Submit.
Kandji Agent diagnostics submission dialog showing the comment field and Submit button for sending diagnostic data

​
Submitting Diagnostics using Kandji Self Service

1

Open Self Service

Open the Self Service app.
2

Navigate to Device Info

Click Device Info.
3

Access Options Menu

Click the ellipses next to Sync.
4

Select Submit Diagnostics

Select Submit Diagnostics.
Kandji Self Service Device Info page showing the ellipses menu with Submit Diagnostics option
5

Add Comments (Optional)

Optionally, add comments describing the issue you’re experiencing.
6

Submit Diagnostics

Click Submit.
Kandji Agent diagnostics submission dialog showing the comment field and Submit button for sending diagnostic data

​
Submitting Diagnostics using the Command-Line Interface

This method requires administrator privileges.
1

Open Terminal

Open Terminal.app.
2

Run Diagnostic Command

Run the following Terminal command, using --comment to add optional comments describing the issue you’re experiencing:
sudo kandji submit-diagnostics [--comment text]

​
Data and Privacy Considerations

When a user submits diagnostics, the Kandji 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.