# Performance debugging

If you encounter performance issues with hostware, follow these steps to check if the root cause is really hostware and how the problem could be solved:

{% stepper %}
{% step %}

### Enable the debug bar

In the hostware administration, navigate to *`Settings > Debug`* and click the "Enable debugbar" button. This will make an internal debug bar visible to just you. No worries, customers wont see this.

<figure><img src="/files/WvZKOU4BHm4ho60KDXjE" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Perform the related action

Perform the action which makes performance issues. After the page has loaded, the debugbar will provide useful loading informations.
{% endstep %}

{% step %}

### Read performance

<figure><img src="/files/ecELSI96sO4CVyHVCjan" alt=""><figcaption></figcaption></figure>

Open the debugbar (small icon bottom left) and click on the "queries" tab (2). This will show all database queries. On the top right of that tab (3), you can see the execution time just of the sql queries. If this number is too high (more than 200ms), this would be a problem. Check if your mariadb needs optimization.

On the top right (1), you can see the overall page load time. This is the entire time for the hostware server to load the page. If this number is reasonable (a few 100 ms for regular pages), but the page still loads long, the performance issue **is not** on the hostware side, but your local computer.

{% endstep %}
{% endstepper %}


---

# 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.hostware.io/system-and-configuration/troubleshooting-and-questions/performance-debugging.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.
