Skip to content
serverless server monitoring with near-zero running costs
JavaScript Shell
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.flowconfig
.gitignore
README.md
aws-ses-policy.json
aws-simpledb-policy.json
config.default.js
db.js
format.sh
handler.js
migrate.js
notify.js
options.js
package.json
serverless.yml
yarn.lock

README.md

THEY LIVE

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 to config.js and customise it:

module.exports = {
  region: 'us-east-1', // aws region for simpledb & ses
  websites: [
    {
      name: 'example-site', // unique site name
      url: 'http://example.com/health', // endpoint to request for healthcheck
    },
  ],
  notifyTo: ['someguy@example.com'], // email to notify of health changes
  notifyFrom: 'someguy@example.com', // email to send notification from
};

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

deploy using serverless framework

yarn global add serverless # install globally
serverless deploy

watch for a successful invocation in lambda console

you can also test that it runs locally

# assuming you've installed serverless globally
yarn run local
You can’t perform that action at this time.