# Mangle Troubleshooting Guide

This guide will help you to diagnose common issues with Mangle deployment and operation and determine what information to collect for further debugging.

## General Support Information <a href="#general-support-information" id="general-support-information"></a>

This information about the environment and events that occurred leading to the failure *should be included in every support request to assist in debugging*.

*Basic Information*

REQUIRED:

* Endpoint type:
* Details of Fault that was injected:
* Type of Deployment: OVA, Container (Single Node), Container (Multi Node), Container (Multi Node with HA Proxy)
* What stage of the Mangle lifecycle are you running into the issue?
* Attach the Mangle support bundle

OPTIONAL, but helpful:

* IP address of Mangle:
* Hostname of Mangle:
* IP address of Endpoint:
* Hostname of Endpoint:

*Detailed Information*

* What operation was being performed when the failure was noticed?
* Provide information from the `Support Information` section of the appropriate Mangle Lifecycle stage
* Provide additional detail as necessary

### Mangle Support Bundle <a href="#mangle-support-bundle" id="mangle-support-bundle"></a>

Please run `/etc/vmware/support/mangle-support.sh` and provide the resulting file to support. This script gathers application state and log information and is the best tool for gathering comprehensive support information. Provide this output for all support requests along with the *Support Information* from the corresponding stage of the Appliance Lifecycle.

The location of the resulting log bundle is shown in the script output, similar to this example:

```
Created log bundle /storage/log/mangle_logs_2018-01-01-00-01-00.tar.gz
```

Provide this `.tar.gz` file to support.

## Mangle Lifecycle <a href="#mangle-lifecycle" id="mangle-lifecycle"></a>

It is important to determine what stage in the appliance lifecycle you are at when encountering issues so that targeted troubleshooting steps can be followed. Please use the links below to identify what stage the failure is in, to apply the appropriate troubleshooting steps, and to provide the appropriate troubleshooting information for support.


---

# Agent Instructions: 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.bluekeys.org/guide/qualite-logicielle/introduction-mangle-chaos-engineering/mangle-troubleshooting-guide.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.