> For the complete documentation index, see [llms.txt](https://docs.vergeos-demo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vergeos-demo.com/knowledge-base/troubleshooting/generating-system-diagnostics.md).

# Generating System Diagnostics

VergeOS support may request that a system administrator generate a system diagnostics file for detailed logs from the platform. The diagnostic file will include detailed logs from all nodes in a system and package it into a single compressed file which can easily be then uploaded to support automatically or downloaded to be sent via email or a 3rd party file-sharing service.

Here are the steps to create and download a System Diagnostics file.

1. **Log in** to the **parent/root** environment. The diagnostics file needs to be generated at the **Parent environment**, rather than a **Tenant**.
2. From the top menu, select \*\*System > **Dashboard**
3. On the **System dashboard**, in the left navigation menu, **click System Diagnostics**
4. From the **System Diagnostics**, in the left navigation menu, **click New Report**
5. Once inside the **New System Diagnostic Report**, complete the **Name**, **Description**, and **check the "Send diagnostic information to VergeOS support**, then click **Submit** at the bottom. This will generate a compressed file of system logs.
6. Wait while the compressed log file is built. The status column will show the status as **'Building"** then on to **'Sending to Support'**.
7. When it is finished, the status will change to **'Sent to Support'**.
8. When sending completes, you can also download the file to your local computer.

***

{% hint style="info" %}
**Document Information**

* Last Updated: 2024-08-29
* vergeOS Version: 4.12.6
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vergeos-demo.com/knowledge-base/troubleshooting/generating-system-diagnostics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.