---
title: "How to Submit Kandji Agent Diagnostics"
slug: "how-to-submit-kandji-agent-diagnostics"
updated: 2025-04-22T17:02:44Z
published: 2025-04-22T17:02:44Z
canonical: "support.kandji.io/how-to-submit-kandji-agent-diagnostics"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.kandji.io/kb/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Submit Kandji Agent Diagnostics

### What are Kandji Agent Diagnostics?

The Kandji Agent has a built-in tool for gathering and submitting detailed diagnostic data from your Mac to Kandji for troubleshooting. This data includes logs, operating system information, and other relevant details about your device, which helps the Kandji 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](/v1/docs/how-to-generate-a-sysdiagnose-in-macos) support article.

### How to Submit Kandji Agent Diagnostics

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

#### Submitting Diagnostics using the Kandji Menu Bar

> [!NOTE]
> If the Kandji menu bar icon is hidden, it can be revealed again from the Kandji Self Service application.

1. Select the **Kandji bee** from the menu bar.
2. Click the settings **gear**.
3. Choose **Submit Diagnostics...** from the dropdown menu.**![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/-2c6u5qjgngy7hprwp5s39cxcowcvk3u4q.png)**
4. Optionally, add comments describing the issue you're experiencing.
5. Click **Submit**. ![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/f_p4be0zpxfwewauddch_3waamfelw83aq.png)

#### Submitting Diagnostics using Kandji Self Service

1. Open the **Self Service** app.
2. Click **Device Info**.
3. Click the **ellipses** next to Sync.
4. Select **Submit Diagnostics**. ![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/zfizkc8gseucr0ovxl00fr9mfxgaxaimbw.png)
5. Optionally, add comments describing the issue you're experiencing.
6. Click **Submit**. ![](https://cdn.document360.io/0844b095-d720-4a7b-bb17-ec97d9bc6e41/Images/Documentation/f_p4be0zpxfwewauddch_3waamfelw83aq.png)

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

This method requires administrator privileges.

1. Open **Terminal.app**
2. Run the following Terminal command, using --comment to add optional comments describing the issue you're experiencing:

```bash
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

Kandji 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 Kandji, see our [Privacy Policy](https://www.kandji.io/legal/privacy/).