> For the complete documentation index, see [llms.txt](https://inscada.gitbook.io/ins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://inscada.gitbook.io/ins/en-1/user-interface/variable-history.md).

# Variable History

On the Variable History screen, you can filter the historical records of your variables from the database. From the filter screen on the right side, you can select the desired variables with Project-> Connection-> Device-> Frame-> Variables parameters and set a date range from the date range section.

inSCADA shows all data in the database according to the parameters entered in the filter screen as timestamped on a grid screen as shown in the following figure.

![](/files/-LjIODe-XEei3J5EpnAo)

The Type parameter on the filter screen determines the period in which the data will be retrieved from the database. Options;

* Usual : Retrieves all data from the database in the relevant date range without grouping.
* Hourly veya Daily : Retrieves the data in the database in groups of one hour or one day by taking the start datetime as offset in the relevant date range. You can see the min, max, avg, last, first, max diff, integral and count calculations of the grouped data in your grid.

![Variable History Hourly](/files/-LjIRJ_doxFY-ALGKdze)

{% hint style="info" %}
When you look at the figure above, you will see that the date ranges are progressed in one hour steps from the start time.
{% endhint %}

![Variable History Daily](/files/-LjIRuSp2xE5IguR7_KS)

{% hint style="info" %}
If you look at the figure above, you will see that the date ranges are progressed in one-day steps from the start time.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://inscada.gitbook.io/ins/en-1/user-interface/variable-history.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.