This repository provides a working example to learn and test Robot Framework automation - the test scripting language used by Robotmk for Synthetic Monitoring in Checkmk.
This is the easiest way to run the example — no local installation needed. Just click the button below:
→ How to run the example in Codespace
What is a GitHub Codespace?
A Codespace is a browser-based development environment (VS Code) hosted by GitHub — no local installation needed.
To run Robot Framework suites manually, refer to the Robotmk blog post with the step-by-step instructions for RCC:
→ How to Run Robot Framework Examples with RCC
→ Troubleshooting RCC
It is the suite learners run in Robotmk Academy's Checkmk Synthetic Monitoring Quickstart — the first test they see, before they have written a line themselves. The course carries it from here all the way into Checkmk, so the shape of this file is part of the teaching material: it is read line by line in module 3, changed in module 4, and extended in module 5.
If you change it, change it knowing that.
It asks one question, the way a guest would ask it: can somebody still buy a burger?
The target is Roboland, a point-of-sale application for an amusement park, built for exactly this purpose. The suite opens the order counter, clicks an item, enters cash, submits, and checks that the order really got a number.
Four lines in the test case, each one a sentence you can read aloud. That is deliberate — a first example that needs explaining is not a first example.
The key comes from the environment, never from the file. roboland.robot is
checked into a repository, and a key pasted into it gets committed the first time
somebody is not paying attention. If ROBOLAND_KEY is missing, the suite says so
in plain words rather than failing on a selector ten seconds later.
export ROBOLAND_KEY=your-five-groups # free at https://demo.robotmk.orgThe browser is visible. ${HEADLESS} is False, because the point of the
first run is watching it happen. Checkmk will run it headless later.
It resets the workspace before it orders. Without that, the booth slowly runs out of buns, orders get blocked, and the test turns red while the application is perfectly healthy. Real applications rarely offer a reset button — the course comes back to what you do then.
It fails when the journey fails. A counter whose page loads, whose total adds up, and whose button quietly does nothing will fail here — and that is precisely the outage the course opens with.
| Library | Version |
|---|---|
| Python | 3.12 |
| Node.js | 22.11.0 |
| Robot Framework | 7.4 |
| robotframework-browser | 19.14.2 |
Also try the other RF example suites, they all work in the Codespace environment.
🪲 Found a bug or have a suggestion?
→ Open an issue or submit a pull request — contributions are welcome.
📖 Want to go deeper? Want ot get a certified professional?
→ I offer Synthetic Monitoring Trainings or book a free call.
Simon Meggle — Founder of Robotmk, Product Manager Synthetic Monitoring at Checkmk
This repository is automatically synced from elabit/robotmk-starter. Do not edit files here directly — changes will be overwritten on the next sync. Last sync:
ca44ab8