> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sirius.menu/llms.txt
> Use this file to discover all available pages before exploring further.
# Uptime monitoring
> Give your window a Sentivel heartbeat and see whether your script is running, with no loop to write.
Rayfield Gen2 is out
NewA ground-up rebuild — faster, undetectable by design, and actively developed. Use it for new scripts instead of Rayfield (2022).
Read the Gen2 docs
→
Sentivel
Endorsed by RayfieldStatus pages and uptime monitoring for whatever you ship. Free to start.
Take a look
→
Rayfield can report whether your script is running. Give your window a [Sentivel](https://www.sentivel.com/?ref=sirius-docs) heartbeat, and Rayfield pings it when the window opens and every five minutes while it stays open. While people are running your script, the monitor stays green. If a game update breaks the script or your loader goes down, the pings stop, Sentivel alerts you, and your status page can show it.
```lua theme={null}
local Window = Rayfield:CreateWindow({
Name = "Example Hub",
Heartbeat = "https://www.sentivel.com/api/heartbeat/",
})
```
That's all you need to add. Rayfield handles the timing, runs every ping in the background, and stops when Rayfield is destroyed. A failed ping never slows down or breaks your script.
## Set it up
Sign in to [Sentivel](https://www.sentivel.com/?ref=sirius-docs) (it's free to start), open **Monitors**, click **Add a monitor**, and choose **Heartbeat**.
**Expected interval** is how often Sentivel expects a ping, and **Grace period** is the extra time it allows before counting the script as down. Rayfield pings every five minutes, so keep the defaults of **Every 5 minutes** and **1 minute**, or go longer. See [Quiet scripts](#quiet-scripts) before you settle on it.
Sentivel gives the monitor a ping URL of the form `https://www.sentivel.com/api/heartbeat/`. Copy the whole URL. Rayfield needs this link, not the monitor's ID.
Pass the URL as `Heartbeat` in `CreateWindow`.
```lua theme={null}
local Window = Rayfield:CreateWindow({
Name = "Example Hub",
Heartbeat = "https://www.sentivel.com/api/heartbeat/",
})
```
Add the monitor to a [Sentivel status page](https://docs.sentivel.com/guides/status-pages) and link it from your Discord. Players can check whether the script is working before they ask.
## Quiet scripts
A heartbeat can't tell the difference between a script that broke and a script that nobody has open. When no one is running your script, the pings stop just as they would after a failure.
Set the interval to match your traffic:
* **Someone almost always has it open:** **Every 5 minutes**. You find out about problems within minutes.
* **It has quiet stretches:** set the interval to the longest you would expect to go with nobody running it, such as **Every 6 hours** for a quiet night. You'll hear about a problem more slowly, but a quiet night won't show as an outage.
## What to expect
* **Pings last as long as Rayfield.** You get one ping when the window opens, after the key system if you use one, then one every five minutes. They stop when you call [`Rayfield:Destroy()`](/rayfield/windows#destroy-the-interface) or the script is run again.
* **Studio is skipped.** Playtests aren't real runs, so no ping is sent there. The link is still checked, so a typo shows up while you are building.
* **A bad link warns.** If the link isn't a Sentivel ping URL, Rayfield prints a warning saying what to paste instead and sends nothing. The full URL and the bare token both work, and stray spaces from a paste are fine.
* **An unknown heartbeat stops.** If Sentivel keeps saying the heartbeat doesn't exist, for example because you deleted the monitor or regenerated its URL, Rayfield prints a warning and stops pinging.
* **Only Sentivel.** `Heartbeat` refuses any other host, so it can't be used to make other requests.
[Secure mode](/rayfield/secure-mode) silences Rayfield's console output, including these warnings. Before you ship, run the script once without secure mode and check that the monitor's page says **First ping received**.
The ping URL ships inside your script, so anyone who reads the script can use it. Treat the monitor as a signal that people are running your script, not as proof. If the URL is being misused, click **Regenerate** next to it on the monitor's page and ship the new one.
## Reference
A `CreateWindow` setting. The monitor's ping URL, or just its token. Optional.
Monitor types, thresholds, and maintenance.