ISPDowntimeMonitor

Monitor and notify if ISP reports any services for a given address non-operational.

Note! This is currently supported for addresses that have telenor as their ISP.

Setup

If this is your first node project jump to Node and Yarn setup below.

After the repo is cloned, navigate to it:

cd ISPDowntimeMonitor/

Install required packages:

yarn

If you don't have mongo running, run it using docker:

mkdir -p $HOME/docker/mongodb/
sudo docker run -d --name mongodb -p 27017:27017 -v $HOME/docker/mongodb:/data/db mongo

Install docker from: https://docs.docker.com/get-docker/.

Note! The folderpath $HOME/docker/mongodb/ can be change to any other folder.

Config

Create a local configuration file from the included example config:

cp config.js.example config.js

To be notified when any services are down you need to fill in a gmail email and password and a recipient email address. It is highly adviced (and required if 2FA is enabled) to create a unique App Password at: https://myaccount.google.com/apppasswords.

Go to the ISP's page for checking service status by address https://www.telenor.no/privat/kundeservice/dmf/. After entering your address copy the pages url.

If my information was:

• sender: no-reply@midboe.com
• password: pass123
• recipient: kevin@midboe.com
• search url: https://www.telenor.no/privat/kundeservice/dmf/sok/168443300

then my config would look like:

module.exports = {
  senderEmail: 'no-reply@midboe.com',
  senderPassword: 'pass123',
  recipientEmail: 'kevin@midboe.com',
  url: 'https://www.telenor.no/privat/kundeservice/dmf/sok/168443300',
  debug: false
}

Optional

Debug set to true for debug logs.
Can also set pdfFilename to overwrite filename prefix (default: telenor-downtime).

Usage

We have two commands start & scrape. Start boots express serving the website for visual representation of downtime data; and Scrape for checking and logging contents of ISP monitor page.

Start the webserver:

yarn start

Open http://localhost:3000/ in your browser.

Run the scraper:

yarn scrape

This saves a pdf of the page to pdfExports/ within the project folder, and logs the uptime status to the database.

Running as a service

If running on any linux platform you should have systemd installed. We want to create a service that both runs & restarts our webserver if necessary and that runs our scrape command on a scheduled interval.

Remember to replace YOUR_PROJECT_DIRECTORY with the full path to where you have the ISPDowntimeMonitor/ folder.

Service for running start server command:

# /etc/systemd/system/ispmonitor.service

[Unit]
Description=ISP monitor daemon

[Service]
WorkingDirectory=YOUR_PROJECT_DIRECTORY
ExecStart=/usr/bin/yarn start
 ExecStartPre=/usr/bin/docker start mongodb

# Restart service after 10 seconds if node service crashes
RestartSec=10
Restart=always

# Output to syslog
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=ispmonitor

[Install]
WantedBy=multi-user.target

Timer service for running scrape command:

# /etc/systemd/system/isp-scraper.service

[Unit]
Description=Run scraper for isp monitor every 30 minutes.

[Service]
Type=oneshot
WorkingDirectory=YOUR_PROJECT_DIRECTORY
ExecStart=/usr/bin/yarn scrape

# Output to syslog
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=ispmonitor-scraper

[Install]
WantedBy=multi-user.target

and

# /etc/systemd/system/isp-scraper.timer

[Unit]
Description=Run scraper for isp monitor every 30 minutes.

[Timer]
OnCalendar=*-*-* *:0/30:0
AccuracySec=1s

[Install]
WantedBy=timers.target

To enable both services on startup run:

sudo systemctl enable ispmonitor.service
sudo systemctl enable ispmonitor-scraper.service

Node and yarn setup

Node

We need node to run our javascript and yarn as our package manager to install required javascript packages. First check if you have node installed with by running node -v in your terminal.

If not check out nodejs.org's download page here: https://nodejs.org/en/download/package-manager/.

Ubuntu/raspberry pi users can add node to apt following these instructions: https://github.com/nodesource/distributions/blob/master/README.md#installation-instructions

Yarn

To get yarn check their site for always up-to-date info here https://classic.yarnpkg.com/en/docs/install/#mac-stable.

One of the easiest ways to install Yarn on macOS and generic Unix environments is via their shell script. You can install Yarn by running the following code in your terminal:

curl -o- -L https://yarnpkg.com/install.sh | bash

We are done! Jump back up to continue project setup!