> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/knowledge-base/english/pulsar/how-do-i-configure-the-tiered-caching-of-pulsar-data-in-enginsight.md).

# How do I configure the tiered caching of Pulsar data in Enginsight?

If the Enginsight API is unavailable, Enginsight allows you to configure the tiered caching of Pulsar data, known as Tiered Transaction Logs.

This means that data is cached uncompressed up to a certain size. In the next tier, the data stored so far is compressed to save disk space. In the final tier, data is deleted once it reaches a specific age to prevent it from taking up too much disk space.

You can define the thresholds for these tiers in the Pulsar configuration file.

***

## Configuration on Linux Hosts

Follow these steps on a Linux host:

{% stepper %}
{% step %}
Log in to the Linux host whose Pulsar configuration file you want to adjust.
{% endstep %}

{% step %}
Open the Pulsar configuration file using the following command:

```
sudo nano /opt/enginsight/pulsar/config.json
```

{% endstep %}

{% step %}
Add the `tieredTransactionLog` section to the file and adjust the specified values if needed:

```
"tieredTransactionLog": {
  "coldStorageThreshold": 1073741824,
  "deletionThreshold": 10737418240,
  "deletionAge": "168h"
}
```

<table><thead><tr><th width="200.1328125">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>coldStorageThreshold</code></td><td><p>Specifies the cache size in bytes up to which Pulsar data is cached uncompressed.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default size is <strong>1073741824</strong> bytes, or 1 GB.</p></div><p>After the specified threshold is exceeded, the cached data is compressed and archived.</p></td></tr><tr><td><code>deletionThreshold</code></td><td><p>Specifies the total size in bytes of all cached and archived Pulsar data. When this threshold is exceeded, the oldest data is deleted.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default size is <strong>10737418240</strong> bytes, or 10 GB.</p></div></td></tr><tr><td><code>deletionAge</code></td><td><p>Specifies the maximum age of cached and archived Pulsar data.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default maximum age is <strong>168h</strong>, or 7 days.</p></div><p>The value can be specified as a string using the time units <strong>ns</strong> (nanoseconds), <strong>us</strong> (or <strong>µs</strong>; microseconds), <strong>ms</strong> (milliseconds), <strong>s</strong> (seconds), <strong>m</strong> (minutes), or <strong>h</strong> (hours). Alternatively, it can be specified as a number, without quotation marks, in nanoseconds.</p></td></tr></tbody></table>
{% endstep %}

{% step %}
Save the configuration file (**Ctrl** + **o**) and confirm the save process. Close the file (**Ctrl** + **x**).
{% endstep %}

{% step %}
Restart the Pulsar using the following command:

```
sudo systemctl restart ngs-pulsar
```

{% endstep %}
{% endstepper %}

***

## Configuration on Windows Hosts

Follow these steps on a Windows host:

{% stepper %}
{% step %}
Log in to the Windows host whose Pulsar configuration file you want to adjust as an administrator.
{% endstep %}

{% step %}
Navigate to the Pulsar installation directory and open the Pulsar configuration file:

```
C:\Programme\Enginsight\Pulsar\config.json
```

{% endstep %}

{% step %}
Add the `tieredTransactionLog` section to the file and adjust the specified values if needed:

```
"tieredTransactionLog": {
  "coldStorageThreshold": 1073741824,
  "deletionThreshold": 10737418240,
  "deletionAge": "168h"
}
```

<table><thead><tr><th width="200.1328125">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>coldStorageThreshold</code></td><td><p>Specifies the cache size in bytes up to which Pulsar data is cached uncompressed.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default size is <strong>1073741824</strong> bytes, or 1 GB.</p></div><p>After the specified threshold is exceeded, the cached data is compressed and archived.</p></td></tr><tr><td><code>deletionThreshold</code></td><td><p>Specifies the total size, in bytes, of all cached and archived Pulsar data. When this threshold is exceeded, the oldest data is deleted.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default size is <strong>10737418240</strong> bytes, or 10 GB.</p></div></td></tr><tr><td><code>deletionAge</code></td><td><p>Specifies the maximum age of cached and archived Pulsar data.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default maximum age is <strong>168h</strong>, or 7 days.</p></div><p>The value can be specified as a string using the time units <strong>ns</strong> (nanoseconds), <strong>us</strong> (or <strong>µs</strong>; microseconds), <strong>ms</strong> (milliseconds), <strong>s</strong> (seconds), <strong>m</strong> (minutes), or <strong>h</strong> (hours). Alternatively, it can be specified as a number, without quotation marks, in nanoseconds.</p></td></tr></tbody></table>
{% endstep %}

{% step %}
Save the file and confirm the save process if necessary. Close the file.
{% endstep %}

{% step %}
Restart the Pulsar.

1. To do this, press the **Windows** key + **R** and enter *services.msc* in the window that opens.
2. Right-click the **Enginsight Pulsar** service.
3. In the context menu that opens, select **All Tasks** → **Restart**.
   {% endstep %}
   {% endstepper %}

***