/upptime

⬆️ Uptime monitor and status page powered by GitHub

MIT LicenseMIT

Upptime

Upptime (https://upptime.js.org) is the open-source uptime monitor and status page, powered entirely by GitHub Actions and Issues.

Uptime CI Response Time CI Graphs CI Static Site CI Summary CI

📈 Live Status: 🟨 Partial outage

URL Status History Response Time Uptime
Google 🟩 Up google.yml Response time graph 87ms Uptime 100.00%
Wikipedia 🟩 Up wikipedia.yml Response time graph 133ms Uptime 100.00%
Hacker News 🟩 Up hacker-news.yml Response time graph 341ms Uptime 100.00%
Broken Site 🟥 Down broken-site.yml Response time graph 0ms Uptime 98.31%
Secret Site 🟩 Up secret-site.yml Response time graph 49ms Uptime 100.00%

This README is also available in 🇧🇷 Brazilian Portuguese

⭐ 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 are 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 are 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

Screenshot of status website

💝 Who's using Upptime

avioli/ionata.com.au-uptime crazyuploader/upp dlunch/upptime fjoker/upptime KieranHolroyd/monitoring absk1317/uptime whistlerbrad/uptime kong67/status jeongsk/upptime shamoon/mswd-upptime gwanryo/upptime bigwing/upptime PH4NTOMiki/uptime-checker doggy0425/monitoring codal-ayush/upptime phg98/upptime nhammond101/upptime jsjsjsjsjsjsjsjs/uptime lightcyde/upptime tavy315/upptime fmmaia/fmAtAllUptime theleetax/uptime Linkspring/upptime level7in/uptime.level7in.com empmdk/upptime David-A-James/upptime amblerkr/upptime godong9/gdgo jeongbeom324/upptime_test SOLPLPARTY/upptime tadacodes/tada-uptime Garagist/upptime HoscoHarding/P-ginasPrueba bbonkr/uptime giftcardbd/status Jolg42/upptime joecof/symmetrical-succotash richardtape/ubcupptime 9min/upptime jjeaby/mew ChrAlpha/upptimes fullprofile/status_monitor xoff1337/xoff1337 BotSauce/status ffsh/uptime RafGamer/rafgamer-status Melangebox/status nazgu1/uptime OswaldLabsOpenSource/status jeremywall/v2-api-status ton-actions/freeton-status lincolnthedev/status JonathanTreffler/status kyupark/upptime picchiosat/HBLink-Uptime cubi-io/upptime ludicroushq/upptime Cyclize/Status brianjhanson/upptime-test jacobdubail/wo-monitor Crstian19/Upptime hada-io/upptime jeyraof/otzil-upptime cocktail-lucas/cocktail-upptime fixator10/status kt-chelsea/status koj-co/status jiri-moc/Hexio-Services-Uptime-Monitor RitsuProject/ritsu-status AnandChowdhary/status chowdhary-org/status espressotutorials/et-status Cleverclip/status mapeaks/mapeaks.github.io intakefoods/status.intakefoods.kr sebastianroming/status.webmonkey.io EnsembleTravelGroup/EnsembleTravelUpptime arkk4/services.arkk4.com upptime/.github ImMaax/uptime huskar-org/uptime c0ball/Uptime Okkido/status jgamblin/upptime baealex/upptime M17-Project/upptime Voffkin1337/60x7upptime butteryoon/liveseeyou stethoscope-js/status belhyun/yonsei-upptime mikesprague/skydark-status snapwiki/SnapWikiUptime eartharoid-bot/status humanscape/service-status mue/status wakatime/statuspage

👩‍💻 Documentation

  1. How it works
  2. Getting started
  3. Configuration
  4. Triggers
  5. Notifications
  6. Badges
  7. Packages
  8. Contributing

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 #15). 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.

Screenshot of GitHub issue Screenshot of incident page

Commits for response time

Four times per day, another workflow runs and records the response time of your websites. This data is commited 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.

Screenshot of GitHub commits Screenshot of live status

📄 License

Koj

An open source project by Koj.
Furnish your home in style, for as low as CHF175/month →