Schedule a session
Hyground can start a session for you at a planned time. You get a schedule in two ways. Ask the agent for it in a session, or fill in the Create schedule dialog yourself.
What does a schedule do?
Hyground starts a session at the planned time of a schedule. It sends the message you saved in that schedule to the agent.
Every session from a schedule is a scheduled session. It is shared with every user of your installation from the start. See Sessions Hyground starts.
Notifications are off by default, including for schedules that already exist. Turn on Notify the schedule creator when a run completes in the Create schedule or Edit schedule dialog. The schedule creator then receives a notification after each successful or failed run. This setting also applies to Run now.
A new run notification replaces the creator's unread run notification for the same schedule. A notification that the agent sends during a run stays separate.
Ask the agent for a schedule
You do not need the dialog. Describe the schedule you want in any session. Name the task and the time.
An example message:
Create a schedule that checks the cluster for failing pods every morning at 09:00.
Write your own task and your own time instead.
The agent does not create the schedule immediately. It repeats the frequency, the message, and the first run time. It then waits for your confirmation. In the example below it also offers to change the message or the time.

Read the repeated details, and correct what is wrong. Confirm the schedule in your next message.

The reply of the agent can also show the time in a technical form. The Schedule column of the table shows the plain line, for example Every day at 09:00 (Europe/Berlin). See Where are the schedules? for that table.
Every user of your installation can read this schedule. Write nothing into the message that others must not read.
The agent can also change a schedule you name, except a system schedule. It can rename it, rewrite the message, move the times, and pause it.
The agent cannot delete a schedule, and it cannot start one immediately. Use the row menu for both. It sits in the Actions column of the schedules table. See Delete a schedule and What else is in the row menu?.
Edit with Hyground in the row menu starts the same path for a schedule that exists.
To check for exploited vulnerabilities every day, see Check for vulnerabilities and security events.
Where are the schedules?
Click the Session Scheduler icon in the left navigation. The Schedules page opens.
The page lists the schedules of every user of your installation. Every user can open and read them. Write nothing into Prompt that other users must not read.
To create, run, change, and delete schedules, your role needs the right to do so. This right covers the schedules of every user, but not a system schedule. Without it, the controls for these actions stay inactive. Their tooltip reads You don't have permission for this. Ask an administrator.
Without this right, the agent cannot create or change a schedule for you. See What are you allowed to do? for the permissions of your role.
The page opens in the Calendar view. It shows one week. Click a free slot to open the Create schedule dialog for a One-time session at that time. Click an entry to open that schedule.
The Calendar view shows only the schedules that are on. A schedule that is off has no entry. Use the Table view to find it.
An entry in the week shows the name of the schedule. Hold the pointer over the entry. The tooltip reads the name, the time, and how often the schedule runs.
A One-time schedule does not repeat. Its tooltip reads the name and the time.
A schedule that runs more often than every 6 hours has no entry in the week. It appears in the Frequent row at the top, in every day column. That entry shows a repeat icon, the name, and a short cadence such as every 1h. Its tooltip reads the name and how often the schedule runs, without a time.
Click Table in the top right corner for the list of all schedules. Click Calendar to go back.
Type in the Search schedules... box at the top of the page. Both views then show only the schedules whose name or Prompt contains your text.
In which order does the table list the schedules?
Hyground sorts the table for you. It lists every schedule that is on before every schedule that is off. Inside a group the nearest Next execution stands first. The rows that show a dash follow, in alphabetical order by Name.
A One-time schedule turns itself off after it has run. It then stands with the schedules that are off.
Click Name, Next execution, or Enabled in the header row to sort by that column. Click the same header again to reverse the order. Click it a third time for the standard order again.
Next execution keeps the rows with a dash at the end in both directions. The other two columns do not.
Create a schedule in the dialog
-
Click the Session Scheduler icon in the left navigation.
-
Click New schedule in the Session Scheduler panel. The Create schedule dialog opens.
-
Type a name in Name.
-
Type your message in Prompt.
-
Click Recurring or One-time under Schedule type.
-
For Recurring, choose an entry in the Frequency list.

-
For Recurring, fill in the fields the frequency shows, for example Time.
-
For One-time, choose a date and a time in Run at.
-
Click Save.
Hyground shows Schedule created. Click Table in the top right corner to see the new schedule in the list.
You cannot change Schedule type later. Create a second schedule instead.
Which Frequency can you choose?
Frequency offers Every X minutes, Hourly, Every X hours, Daily, Weekly, and Monthly. Each choice shows its own fields:
- Every X minutes shows Run every. You choose 5, 10, 15, 20, or 30 minutes.
- Hourly shows At minute.
- Every X hours shows Run every and At minute. Run every offers 2, 3, 4, 6, 8, and 12 hours. A schedule the agent created can use another value. The list then also offers that value. The schedule runs from midnight. Run every 6 hours runs at 00:00, 06:00, 12:00, and 18:00.
- Daily shows Time.
- Weekly shows Days of the week and Time. The buttons Weekdays, Weekends, and Every day set the days for you.
- Monthly shows Day of the month and Time. The day list offers 1 to 28.
A line under the fields describes the result, for example Every day at 09:00. Hyground shows the name of the time zone in parentheses after it. A recurring schedule runs in the time zone of your installation, not the one of your computer.
The same line appears in the Schedule column of the table.
What do you write in the Prompt field?
Write in Prompt as you write a message to the agent. The session starts empty, so that message carries the whole task. See Write a good message.
Type / in Prompt to pick a skill. Hyground offers
the matching entries while you type. See Run a skill.
The list also offers your private skills. A scheduled session cannot use one. Share the skill before you pick it here.
Type @ to pick a cluster or a cluster group. The
list opens only when your installation manages several clusters. It is the same
list the message box offers. See
Address several clusters at once.
Pause and resume a schedule
-
Click the Session Scheduler icon in the left navigation.
-
Click Table in the top right corner.
-
Turn off the switch in the Enabled column. The switch turns light blue.

Turn the switch on again to resume the schedule. The switch is orange while the schedule runs.
Next execution counts down to the next session while the schedule runs. It shows a dash while the schedule is off.
In the standard order, a schedule you turn off moves behind every schedule that is on. See In which order does the table list the schedules?.
Only a Recurring schedule has this switch. A One-time schedule has none. Delete a one-time schedule to stop it.
Delete a schedule
-
Click the Session Scheduler icon in the left navigation.
-
Click Table in the top right corner.
-
Click the three dots icon in the Actions column of the row.
-
Click Delete.
-
Click Delete in the Delete schedule dialog.
Hyground shows Schedule deleted. You cannot undo this.
You cannot delete a system schedule.
What else is in the row menu?
- Run now starts a session immediately. The planned times stay as they are.
- Edit with Hyground opens a new session. The agent describes the schedule and waits for your instructions.
- Edit manually opens the Edit schedule dialog with the fields of the schedule.
The row menu of a system schedule offers only Run now.
What is a system schedule?
A system schedule shows the tag System with a lock icon. The tag stands next to its name in the table. On its detail page, the tag stands next to Recurring.
In the Calendar view, the entry of a system schedule shows a lock icon before the name. Its tooltip also reads System schedule.
Nobody can edit or delete a system schedule. Its row menu offers only Run now. Its detail page offers only the Enabled switch and Run now.
To turn a system schedule on or off or to run it, your role needs a separate right. Administrators have it. Without it, the switch, the row menu, and Run now stay inactive. Their tooltip reads Only administrators can turn system schedules on or off or run them.
A new version of Hyground can change the name, the message, or the frequency of a system schedule. It can also remove the schedule, or turn it on or off. After an administrator turns the schedule on or off, new versions keep that choice while they include the schedule.
Whose permissions does a scheduled session use?
A scheduled session acts as the owner of its schedule. The agent can use what the owner can use at the time of the run. When the owner may not use an integration, the agent's call to it is denied.
Run now also acts as the owner, not as you. When you change a schedule, you become its owner.
A schedule whose Last modified reads Hyground has no owner. Its sessions can use every integration until somebody changes the schedule. A system schedule can also use every integration.
Why does a schedule need a takeover?
The owner of a schedule is the user who last changed it. Hyground shows that user in Last modified on the table and on the detail page.
A schedule needs a takeover when its owner no longer exists. When your installation uses roles, a second case applies. The owner no longer has the right to create, run, change, and delete schedules. This can happen when an administrator removes the owner's account, or changes their role.
Only a person can create or change a schedule. Do it in the web UI, or ask for it in a session in the web UI. The agent cannot create or change a schedule when you ask in Slack, Microsoft Teams, or email, or in a scheduled session.
An earlier version of Hyground could create or change a schedule without a person. Last modified then reads Hyground. Such a schedule keeps running without a takeover until somebody changes it or takes it over.
A schedule that needs a takeover does not run. Hyground skips its planned runs. A skipped run of a One-time schedule does not come back. Schedule it again after you take it over.
You can only take over or delete a schedule that needs a takeover. Hyground refuses Run now and every change, including the Enabled switch, until somebody takes the schedule over.
You see a schedule that needs a takeover in three places:
- In the Calendar view, its entry is tinted in a warning color and shows a warning icon.
- In the Table view, a Needs takeover tag stands next to its name.
- On its detail page, a warning banner explains that the schedule does not run.
When you change a schedule, you become its owner.
A system schedule never needs a takeover. If your installation reads users from an external identity service, no schedule needs a takeover.
Take over a schedule
- Open the schedule's detail page. Click its row in the Table view.
- Click Take over in the warning banner. This button shows only when you have the right to create, run, change, and delete schedules.
- Read Current owner and the full Prompt in the dialog.
- Click Take over in the dialog.
After you take over a schedule, you are its owner and it runs again. You are responsible for its Prompt. Before you confirm, also check what the Prompt reads from outside Hyground, for example from a connected system.
If somebody changes the Prompt while your dialog is open, Hyground does not accept your confirmation. It closes the dialog and shows the current state of the schedule. Review it again before you act.
You cannot take over a system schedule. See Why does a schedule need a takeover?.
Read the sessions of a schedule
- Click the Session Scheduler icon in the left navigation.
- Click Table in the top right corner.
- Click the row of the schedule. The detail page opens.
- Click a row in the Last sessions table.
The detail page repeats Name, Prompt, and Schedule. It also shows Created, Last modified, and Next execution. Created and Last modified name the user behind each date. The name reads Hyground for a system schedule. It also reads Hyground when an earlier version of Hyground created or changed the schedule without a person. The user behind Last modified is also the schedule's owner. See Why does a schedule need a takeover?.
For a Recurring schedule the card also holds the Enabled switch. The buttons Run now, Edit with Hyground, Edit manually, and Delete schedule stand under that card. A system schedule shows only Run now.
Last sessions lists the sessions of this schedule with the time in the Started at column. Click the refresh icon above the table for the newest state.
To see the sessions of every schedule, click Sessions in the Session Scheduler panel. The Sessions from schedules page opens. Use the Filter by schedule list at the top of the page to see one schedule only. See What does the Sessions page show? for the search box and the Date range field.
Can the agent check something again in the same session?
Yes. Ask the agent to watch a task. Unlike a schedule, a watch starts no new session.
An example message:
Check the rollout of the payment service every 10 minutes for the next 2 hours.
Name the interval and the end in your message. You can also type the
skill command /watch and write the task after
it. See Run a skill in a session.
Each check adds a reply to the session without a message from you. The reply reports what changed since the last check.
The interval is at least 5 minutes. A watch lasts at most 24 hours. Use a schedule for a task that must repeat after that.
A session holds one watch. A new watch replaces the running one.
The watch ends after its last check. It ends earlier when one of these happens:
- You ask the agent to stop the watch.
- The agent finds that the process it watches is finished, for example a rollout.
- Any user in the session clicks Stop while a check runs.
- Another user sends a message into the session. The watch then ends instead of running its next check.
The Home page lists the running watches in the sessions you own. See What do the timeline and the running watches show?.
Only the owner of the session can start a watch. The agent cannot start one when Hyground did not identify you personally. See Which account are you signed in as?.