Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/neatnik/website-monitor
A simple website or web service monitor
https://github.com/neatnik/website-monitor
hacktoberfest monitoring
Last synced: 10 days ago
JSON representation
A simple website or web service monitor
- Host: GitHub
- URL: https://github.com/neatnik/website-monitor
- Owner: neatnik
- License: mit
- Created: 2022-12-22T22:30:02.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-25T20:52:05.000Z (9 months ago)
- Last Synced: 2024-08-01T12:32:05.815Z (3 months ago)
- Topics: hacktoberfest, monitoring
- Language: PHP
- Homepage: https://broke.lol
- Size: 179 KB
- Stars: 190
- Watchers: 3
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Website Monitor
This is a simple website monitor, inspired by [broke.lol](https://broke.lol).
![A screenshot of the website monitor](screen.png)
## Usage
Upload everything to your web server (except the `screen.png` file, which isn’t needed). Make sure that PHP has permission to write to the `monitors` directory (this is where monitor data is stored).
Open `monitors.json` and add whatever websites you’d like you monitor. The format is a key-value pair, with the key being the “display name” of the website, and the value being the URL that will be checked. For example:
```
{
"example.com": "https:\/\/example.com",
"wikipedia.org": "https:\/\/www.wikipedia.org"
}
```To automate your monitoring, you can add something like this to your crontab:
```
* * * * * /usr/bin/php -f /path/to/monitor.php >/dev/null 2>&1
```You can display a specific message for each monitored resource by creating a Markdown file in the `updates` directory that uses the same display name for the resource (and has a `.md` extension). For example, if you want to display some text near the `example.com` resource, you’d add a file called `example.com.md` within the `updates` directory.
You can display various incident messages by placing a Markdown file in the `incidents` directory. By default, any file there will be treated as an informational message (shown in gray). If you prepend `alert_` in the file name, the message will be treated as an alert (shown in red). And if you prepend `notice_`, it’ll be treated as a notice (shown in yellow).
This project uses [Parsedown](https://parsedown.org), a truly excellent Markdown rendering tool.