# Generate scheduled events

{% hint style="info" %}
See the changelog of the **Tick** Listener type [here](/listeners/tick-listener.md).
{% endhint %}

{% hint style="warning" %}
Note that this Listener is only available in certain Tenants. [Get in touch with us](https://www.onum.com) if you don't see it and want to access it.
{% endhint %}

## Overview

The **Tick** Listener allows you to emit events on a defined schedule.

## Prerequisites

{% hint style="warning" %}
In order to use this Listener, you must activate the environment variable in your distributor using docker compose (`TICK_GENERATOR_ENABLED`)
{% endhint %}

## Onum Setup

{% stepper %}
{% step %}
Log in to your Onum tenant and click **Listeners > New listener**.
{% endstep %}

{% step %}
Double-click the **Tick** Listener.
{% endstep %}

{% step %}
Enter a **Name** for the new Listener. Optionally, add a **Description** and some **Tags** to identify the Listener.
{% endstep %}

{% step %}
Add as many tick events as required to emit.

* Select the **Schedule Type Interval**<mark style="color:red;">**\***</mark>  type to use for the intervals between sending events.
* Enter the **Interval value**<mark style="color:red;">**\***</mark> number of seconds/minutes/hours to wait for.
* The **Interval Unit**<mark style="color:red;">**\***</mark> the number corresponds to: seconds, minutes, hours.
* Enter the **Number of events**<mark style="color:red;">**\***</mark>  to emit.
* Enter what the **Event body**<mark style="color:red;">**\***</mark> will contain, e.g. the fields.
  {% endstep %}

{% step %}
Finally, click **Create labels**. Optionally, you can set labels to be used for internal Onum routing of data. By default, data will be set as **Unlabeled**. Click **Create listener** when you're done.

{% hint style="info" %}
Learn more about labels in [this article](/the-workspace/listeners/labels.md).
{% endhint %}
{% endstep %}
{% endstepper %}

Click **Create listener** when you're done.


---

# 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.onum.com/the-workspace/listeners/listener-integrations/generate-scheduled-events.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.
