upptime/upptime
- August 8, 2020
- View on GitHub
- JSON
- 15,640 stars
- 15,640 watchers
- 889 forks
Upptime (https://upptime.js.org) is the open-source uptime monitor and status page, powered entirely by GitHub Actions, Issues, and Pages. Itโs made with ๐ by Anand Chowdhary, supported by Pabio.
I find Upptime an incredible clever usage of [GitHub Actions]. You essentially get a free configurable uptime monitor for whatever you want. โ CSS Tricks
Upptime is used by 1,000+ people and teams to ensure they know when their endpoints go down.
๐ Live Status: ๐ง Partial outage
URL | Status | History | Response Time | Uptime |
---|---|---|---|---|
๐ฉ Up | google.yml | 95ms | 100.00% | |
Wikipedia | ๐ฉ Up | wikipedia.yml | 885ms | 100.00% |
Hacker News | ๐ฉ Up | hacker-news.yml | 351ms | 100.00% |
Test Broken Site | ๐ฅ Down | test-broken-site.yml | 0ms | 0.00% |
IPv6 test | ๐ฅ Down | i-pv6-test.yml | 0ms | 0.00% |
โญ How it works
- GitHub Actions is used as an uptime monitor
- Every 5 minutes, a workflow visits your website to make sure itโs up
- Response time is recorded every 6 hours and committed to git
- Graphs of response time are generated every day
- GitHub Issues is used for incident reports
- An issue is opened if an endpoint is down
- People from your team are assigned to the issue
- Incidents reports are posted as issue comments
- Issues are locked so non-members cannot comment on them
- Issues are closed automatically when your site comes back up
- Slack notifications are sent on updates
- GitHub Pages is used for the status website
- A simple, beautiful, and accessible PWA is generated
- Built with Svelte and Sapper
- Fetches data from this repository using the GitHub API
Upptime is not affiliated to or endorsed by GitHub.
๐ฉโ๐ป Documentation
- How it works
- Getting started
- Configuration
- Triggers
- Notifications
- Badges
- Packages
- Contributing
- Frequently Asked Questions
Concepts
Issues as incidents
When the GitHub Actions workflow detects that one of your URLs is down, it automatically opens a GitHub issue (example issue #67). You can add incident reports to this issue by adding comments. When your site comes back up, the issue will be closed automatically as well.
Commits for response time
Four times per day, another workflow runs and records the response time of your websites. This data is committed to GitHub, so itโs available in the commit history of each file (example commit history). Then, the GitHub API is used to graph the response time history of each endpoint and to track when a site went down.
๐ License
- Code: MIT ยฉ Anand Chowdhary, supported by Pabio
- Data in the
./history
directory: Open Database License