HOWIS

Fullstack project to check a website's status from a number of different lambda functions.

_{(Yes, it's a play on the misspelling of WHOIS)}

Demo

You can try out the Project here

Design

The backend is built using AWS SAM, utilising various AWS services, which can be seen in the diagram below.

Each health check lambda function will send a HEAD request to a given domain and store the results of these requests in a DynamoDB table.

The frontend is using Preact + Vite, deployed using Vercel.

Lighthouse Report

Infrastructure Diagram

API Endpoints

POST /up?site=<site_url>

GET /status?id=<item_id>

NOTE: The third lambda function is triggered by AWS SNS, and does not have a publicly accessible API endpoint

Setup

Ensure that you have a SAM CLI installed by running

sam --version

Then clone the repository and deploy the backend

git clone https://github.com/rua-iri/HOWIS

cd aws_lambda

make deploy

Then run the frontend locally

cd preact_frontend

npm install

cp .example.env .env

npm run dev

NOTE: You should populate the environment file with your own API's base url