# Event Triggered Reports

(Continued from [Creating a Report](/clarity/reports/create-report.md))

You can configure a report to be sent on an event by selecting **Send Report: On Event:**

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

You will then need to choose the event to trigger the report. You must select from among configured notifications, so you will need to configure one if you haven't already. In this example we'll configure a trigger for `Site 1/battery/1/lifetimeWh <= 100 Wh`. To do so start by searching for the `lifetimeWh` tag and clicking it:

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

In the menu that pops up, click **Tag Settings**:

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

Then in the Tag Settings Dialog that appears, click **Notifications**:

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

And in the Tag Notifications dialog that appears, click **Add Notification**:

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

Enter the following values for the notification condition:

<figure><img src="/files/2xcHK7iwSpnUM3nfgerD" alt=""><figcaption></figcaption></figure>

And then we'll change the severity from **Alarm** to **None**, since we only want to this to trigger our report, not send us an alarm notification:

<figure><img src="/files/0GfVkLdJWINzzinGxFsu" alt=""><figcaption></figcaption></figure>

Finally, click **OK** to create the trigger and click **OK** in the Tag Settings dialog:

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

Now we can connect this to our report. Under **Report End Event,** click **Choose Trigger**:

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

A **Select Trigger** dialog will appear that allows you to search for a trigger event among notifications you've configured. In this example we'll search for "lifetime":

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

Then click on the trigger row (trigger rows are blue) to select it:

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

Click **OK** and then you should see this trigger event displayed as the **Report End Event.** When this event occurs, it creates a report ending at the event time and sends it.

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

You can configure the **Report Length** to be either a **Fixed Time Length** before the **Report End Event**, or **Since Another Event**:

| Fixed Time Length                                                   | Since Another Event                                                 |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| <img src="/files/yPspdPe3dYRLNNM2Hyrs" alt="" data-size="original"> | <img src="/files/SM5WaZxAlTAguVYxkpPI" alt="" data-size="original"> |

If you select **Since Another Event**, you'll need to select the **Report Begin Event** in the same manner as you selected the end event, and enter the **Max Report Length** (if the begin and end events occur farther apart in time than the max report length, the report will only go back to the max report length amount of time before the end event).

Next enter the **Minimum Time Between Reports**. Clarity will not send reports more often than this time interval, even if the trigger event occurs more frequently:

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

The **Data Interval** controls the amount of time between individual data points in the report. For example with a Data Interval of **1 hour**, each row of the report will summarize one hour of historical data:

<figure><img src="/files/4yaXxeUtBvmmqYY6KH3C" alt=""><figcaption></figcaption></figure>

And you can select whether to include the **Average**, **Min**, and/or **Max** tag values for each data interval in the report:

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

To select email recipients, click the **+** button in the **Report Recipients** panel:

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

Then in the dialog that appears, check all the users and groups you want to receive emails:

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

After you click **OK** you should see the selected users and groups in the **Report Recipients** panel:

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

To download a sample of what the CSV report will look like, click **Download Sample** at the bottom of the form:

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

Finally, click **Save Settings** at the bottom of the page to create the report:

<figure><img src="/files/9NBkMy8pgTe5UeWycv0C" alt=""><figcaption></figcaption></figure>


---

# 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.jcore.io/clarity/reports/event-triggered-reports.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.
