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.

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, and it waits for your confirmation. In the example below it also asks which cluster to check, because the message left that open.

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 and change this schedule. Write nothing into the message that others must not read.

The agent can also change a schedule you name. 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.

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 a schedule, change it, run it, and delete it. Write nothing into Prompt that other users must not read.

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.

Click Table in the top right corner for the list of all schedules. Click Calendar to go back.

Create a schedule in the dialog

1. Click the Session Scheduler icon in the left navigation.

2. Click New schedule in the Session Scheduler panel. The Create schedule dialog opens.

3. Type a name in Name.

4. Type your message in Prompt.

5. Click Recurring or One-time under Schedule type.

6. For Recurring, choose an entry in the Frequency list.

   

7. For Recurring, fill in the fields the frequency shows, for example Time.

8. For One-time, choose a date and a time in Run at.

9. 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, 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.
• 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.

Type @ to pick a cluster. The list opens only when your installation manages several clusters.

Pause and resume a schedule

1. Click the Session Scheduler icon in the left navigation.

2. Click Table in the top right corner.

3. 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.

Only a Recurring schedule has this switch. A One-time schedule has none. Delete a one-time schedule to stop it.

Delete a schedule

1. Click the Session Scheduler icon in the left navigation.

2. Click Table in the top right corner.

3. Click the three dots icon in the Actions column of the row.

4. Click Delete.

   

5. Click Delete in the Delete schedule dialog.

Hyground shows Schedule deleted. You cannot undo this.

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.

Read the sessions of a schedule

1. Click the Session Scheduler icon in the left navigation.
2. Click Table in the top right corner.
3. Click the row of the schedule. The detail page opens.
4. 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. 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.

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 All schedules list above the table to see one schedule only. See What does the Sessions page show? for the search box and the Date range field.