# Tornado Troubleshooting & Feedback

## Tornado Log Files <a href="#tornado-log-files-location-guide" id="tornado-log-files-location-guide"></a>

### Log File Locations: <a href="#log-file-locations" id="log-file-locations"></a>

* **Windows**

  `./ (Application running directory)`
* macOS

  `~/Library/Application Support/Tornado/`
* Linux

  `./ (Application running directory)`

### Log File Names & Content <a href="#log-files" id="log-files"></a>

1. Main Log File: `TORNADO.Log.txt`
   * Application level logs
   * General operation information
   * Error messages
2. Process Log File: `TORNADO.Process.Log.txt`
   * Detailed process logs
   * stderr outputs
   * System level messages

### Log Levels <a href="#log-levels" id="log-levels"></a>

* DEBUG: Detailed debugging information
* INFO: General information messages
* WARNING: Warning messages
* ERROR: Error messages
* FATAL: Critical errors
* PANIC: System crash situations

## HTTP Trace

<figure><img src="https://1662683669-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnA8kGzryHKp7UhDaLtzW%2Fuploads%2Fgit-blob-3f9b45c88890ca75b135063d5dd4d284d225b4b4%2Ftornado_troubleshooting_x26_feedback_http_trace_toggled_on.png?alt=media" alt=""><figcaption><p>Tornado Troubleshooting &#x26; Feedback: HTTP Trace toggled on</p></figcaption></figure>

### **Enabling HTTP Trace (Optional)**

**What is HTTP Trace?**\
HTTP Trace is a diagnostic tool that logs detailed data about cloud communication. While not required for basic feedback, it helps diagnose complex technical issues.

**When to Enable HTTP Trace**\
Enable HTTP Trace if you’re experiencing:

* Authentication issues
* Problems with specific collectors
* Unexpected errors
* Performance-related concerns

**How to Enable HTTP Trace**

1. Open the Tornado application.
2. Go to **Settings** from the top menu.
3. Locate the **HTTP Trace** option.
4. Toggle the switch to enable it.

**Before Enabling HTTP Trace**

* Logs will include detailed data on API communication.
* Ensure you have enough disk space.
* Be aware that enabling HTTP Trace may slightly impact performance.

**What HTTP Trace Captures**

* API request and response details
* Authentication workflows
* Collection progress logs
* Error details and stack traces
* Network communication logs

***

### **Submitting Feedback**

<figure><img src="https://1662683669-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnA8kGzryHKp7UhDaLtzW%2Fuploads%2Fgit-blob-bec1ebdc38551d56e66674cb986b73b5fef9466f%2Ftornado-faqs-001.png?alt=media" alt=""><figcaption><p>Tornado Troubleshooting &#x26; Feedback: The Feedback form</p></figcaption></figure>

#### **Automatic Log Collection** Tornado automatically gathers essential diagnostic data, including:

* Application logs
* Error messages
* Collection statuses
* System configurations
* Task execution details
* Authentication statuses

#### **Steps to Submit Feedback**

1. **Enable HTTP Trace (Optional):**
   * Only if requested by the support team or for complex technical issues.
2. **Send Feedback:**
   * Click the **Send Feedback** button in the application.
   * Add comments if necessary (optional).
3. **Submit:**
   * Tornado automatically attaches all necessary diagnostic data, so you don’t need to add anything extra.

#### **What’s Included in Logs**

* Collection progress and statuses
* Error messages and warnings
* Authentication details
* System configuration data
* Selected collector and setting details
* Task execution logs

***

#### **After Submission**

* Our team will review your logs and analyze reported issues.
* You’ll receive a response via email with solutions or further instructions if necessary.

***

### **Important Notes**

**Privacy & Security**

* Logs include only technical details—no personal data is captured.
* All logs and communications are encrypted.
* Logs are automatically cleaned up after use.

**Best Practices**

* Enable HTTP Trace before reproducing an issue.
* Keep it enabled during the entire troubleshooting session.
* Disable HTTP Trace once the issue is resolved.
* Submit feedback promptly after encountering issues.

For urgent concerns or critical investigations, contact our support team directly through official channels.