# 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="/files/ZnHGSU2haH2h1Xd7H7fr" 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="/files/AnSQU7B57E3E61YbUlBT" 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="/files/mGyHu3njqPeFpPPJvQj0" 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="/files/x3BEo97VPbVyUUKuhTqb" 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="/files/tLzMICrF5K6jl79Avr9T" 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="/pages/1LczT9HpJB9x4h2rRtub">/pages/1LczT9HpJB9x4h2rRtub</a></td></tr></tbody></table>


---

# 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.tomorrowx.com/cap/product-reference/trace-data.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.