Step 4 – Activate Your First Check

A check is an automated test that octoja runs on a device at regular intervals. For example, a Disk Space check watches how full your drives are and flags it when free space is running low. Checks are the foundation of monitoring in octoja.

Before you start

• You need at least one device with the agent installed and connected (see Step 3).

Steps

1. Go to Configuration → Check Library in the left sidebar.
2. Browse the available checks. For your first check, Disk Space or Disk I/O are good choices — they run on Windows, Linux and macOS, and every field arrives pre-filled. The walkthrough below activates Disk I/O as an example; the flow is the same for any check.
3. The Check Library is a read-only catalog for browsing the available checks — each entry shows the check's name, description, category, author, supported platforms and how often it runs, and clicking one opens its details. Search the list, narrow it with the All Categories and All Platforms filters, and switch between Card view and Table view with the buttons above the list. You configure a check (its Display Name and threshold fields) later, when you add it to a device in steps 6–8.
4. Now go to Devices in the sidebar, and click on the device you want to monitor.
5. Click the Checks tab on the device detail page.
6. Click Add Check and select the check type you chose (the walkthrough below uses Disk I/O).
7. Fill in the check-specific fields on the Configuration tab. Every check has a Display Name, pre-filled with the check's own name; the remaining inputs depend on the check you picked. The Alert tab is where you attach an alert configuration later. For Disk Space, the fields are:

8. Click Add Check to confirm.
9. Wait for the first check interval to pass, then return to the device's Checks tab to see the result. Every check runs on its own schedule — Disk I/O every 5 minutes, Disk Space every 60 — and the Check Library lists the interval for each one.

The walkthrough below shows the full activation flow on a fresh device — Devices page, device detail, Checks tab, Add Check, picking Disk I/O, confirming, and the new check appearing in the list:

What the statuses mean

Here is what the Checks tab looks like once a few checks are running:

Tip: If a check stays without a result for more than a few minutes, open the device detail page and confirm the agent is still online — the Online / Offline pill in the device header shows the current connection state.

Recommended first checks

For every available check and its guide, see How checks work and the Checks reference tab.

Next step

Continue to Step 5 – Get an Overview at a Glance.

You have covered the basics — explore what else octoja can do, for example Monitor Device Performance Live or Deploy Software to Devices.