By default, uptime is checked every 5 minutes and response time graphs and endpoints are updated every 24 hours. You can also manually trigger an update, for example after setting up your repository. Manual triggers are powered by workflow triggers on GitHub Actions.
Upptime has several workflows that are run on different intervals, all of which you can also manually trigger:
This workflow is triggered after you edit the configuration file, and runs alls steps: checking uptime, tracking response time, updating the README, and generating graphs. If you want to "force" Upptime to run everything once (for example, after you've set up the template or after you've made a configuration change), you can manually trigger Setup CI.
This workflow runs once every 5 minutes and checks if your websites are up. If they are down, it creates a new issue in your repository. This same workflow also closes any issues after your websites have come back up. If you want to manually make sure that all your endpoints are currently up, you can trigger this workflow.
Update Template CI
This workflow runs once a week and updates the internal code of Upptime to make sure you're always on the latest version. This is important because Upptime is still in development and may include new design updates and feature changes including important security updates.
Static Site CI
This workflow builds and deploys your status page website using GitHub Pages. It reads from your configuration and builds the Svelte/Sapper website, then deploys is to the
gh-pages branch and triggers a re-build on GitHub Pages. By default, this runs once every week, but you can manually run it, for example after updating your configuration or setting up the template.
This workflow runs once every day and generates response time graphs from the recorded data. These PNG images are stored in the
graphs directory and embedded on the project's README. You can manually run this to regenerate those images.
Response Time CI
This workflow records the reponse time of each endpoint and commits it to git history, which is why it runs once every day. You can manually trigger it if you want to record the response time manually.
This workflow also runs once every day and updates the README of your project with a summary of the response times and generated graphs. You can manually trigger it to update your project's README.md file.
To manually trigger an update, you can use the GitHub UI or API.
Using the GitHub UI
First, click on the "Actions" tab of your GitHub repository. You will reach the URL https://github.com/user/repo/actions, where
user is your GitHub username and
repo is the name of the repository.
On the left sidebar under "Workflows", click on the workflow you want to trigger, for example "Setup CI":
You will see the message "This workflow has a
workflow_dispatch event trigger.". Click on the "Run workflow" button on the right. Keep the default branch select and click on "Run workflow":
Using the GitHub API
If you want to programmatically trigger updates, you can use the GitHub REST API's repository dispatch events by triggering an event in your repository called
For more information, read this article on the GitHub website: Create a repository dispatch event.