# Trace Data

Trace data can be retrieved from any long-running server. It creates a step-by-step trace of how your rule set is being processed by the <code class="expression">space.vars.X\_Agent\_Name\_Single</code>. This is particularly useful for finding problems in web application rule sets.

To start a trace, simply click the **Start trace** button on the server status page as shown below.

<figure><img src="https://2423451286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F42mDa58RoaDxb6t8mbaI%2Fuploads%2Fgit-blob-a482724e46894eed6856216745178ec7a784085a%2Fimage.png?alt=media" alt=""><figcaption><p>Start trace button</p></figcaption></figure>

Once the trace is in progress, you will see the status screen change as shown.

<figure><img src="https://2423451286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F42mDa58RoaDxb6t8mbaI%2Fuploads%2Fgit-blob-4a0d007e3ab161ed7c41da6afb6ea54782528238%2Fimage.png?alt=media" alt=""><figcaption><p>Server IN trace mode</p></figcaption></figure>

The trace mode will be active for a maximum of 20 transactions, after which it will automatically turn off.

To retrieve and view the trace data, simply click the Get trace data button and supply a repository and file name.

<figure><img src="https://2423451286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F42mDa58RoaDxb6t8mbaI%2Fuploads%2Fgit-blob-063201913919fe2d41c8be90f14d77aea1c0dad4%2Fimage.png?alt=media" alt=""><figcaption><p>Retrieve button</p></figcaption></figure>

Once the trace data has been retrieved, you can view it by selecting it in the administration tree.

<figure><img src="https://2423451286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F42mDa58RoaDxb6t8mbaI%2Fuploads%2Fgit-blob-fcc61c683967c190252e5ffa0271d605f04ce369%2Fimage.png?alt=media" alt=""><figcaption><p>Trace data folder</p></figcaption></figure>

The view of the trace can also be downloaded or deleted *(as shown below)*.

<figure><img src="https://2423451286-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F42mDa58RoaDxb6t8mbaI%2Fuploads%2Fgit-blob-5939af472c73fbbc7bec78c22ece3bff2e4988b5%2Fimage.png?alt=media" alt=""><figcaption><p>Delete or Download trace</p></figcaption></figure>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Understanding the Trace</td><td></td><td></td><td><a href="trace-data/understanding-the-trace">understanding-the-trace</a></td></tr></tbody></table>
