https://github.com/jsdf/they-live
serverless server monitoring with near-zero running costs
https://github.com/jsdf/they-live
Last synced: 3 months ago
JSON representation
serverless server monitoring with near-zero running costs
- Host: GitHub
- URL: https://github.com/jsdf/they-live
- Owner: jsdf
- Created: 2017-04-05T06:40:09.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2022-12-06T20:57:56.000Z (over 2 years ago)
- Last Synced: 2024-04-09T22:09:07.829Z (about 1 year ago)
- Language: JavaScript
- Size: 47.9 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
THEY LIVE is a simple endpoint health monitor with email notifications, which
runs on AWS free tier services (Lambda, SimpleDB, SES), so it costs next-to-nothing to run.
### instructions
first, clone this repo
copy [config.default.js](config.default.js) to config.js and customise it:
```js
module.exports = {
region: 'us-east-1', // aws region for simpledb & ses
websites: {
// groups of websites can be defined to ping at different intervals.
// the keys of this object must match the 'group' parameter passed to the
// cron event in serverless.yml (see below)
oncePer10Mins: [
{
name: 'example-site', // unique site name
url: 'http://example.com/health', // endpoint to request for healthcheck
},
],
// another group which pings at a different interval
oncePerDay: [
{
name: 'other-site',
url: 'http://example.com/health2',
attempts: 3, // will retry this many times
interval: 15, // seconds between retries
},
],
},
notifyTo: ['[email protected]'], // email to notify of health changes
notifyFrom: '[email protected]', // email to send notification from
};
```
in [serverless.yml](serverless.yml) (note the 'group' param)
```yaml
functions:
cron:
handler: handler.cron
events:
- schedule:
rate: rate(10 minutes)
input:
group: oncePer10Mins
- schedule:
rate: rate(1 day)
input:
group: oncePerDay
```
run `yarn install` to install dependencies
run `aws configure` if you haven't already, to set up aws credentials
run `node migrate.js` to create the AWS SimpleDB 'domain' (basically a database)
verify your email address [in AWS SES console](https://console.aws.amazon.com/ses/home?region=us-east-1#verified-senders-email:)
deploy using serverless framework
```bash
yarn global add serverless # install globally
serverless deploy
```
watch for a successful invocation [in lambda console](https://console.aws.amazon.com/lambda/home?region=us-east-1#/functions/theylive-dev-cron?tab=monitoring). scroll down on this page to see the logs in cloudwatch
you can also test that it runs locally
```bash
yarn local --data='{"group": "oncePerDay"}'
```