README
¶
Statup - Web and App Status Monitoring for Any Type of Project
View Wiki | Demo
API | Docker | EC2 | Heroku | Mac | Linux | Windows | Plugins
Statup - Status Page & Monitoring Server
An easy to use Status Page for your websites and applications. Statup will automatically fetch the application and render a beautiful status page with tons of features for you to build an even better status page. This Status Page generator allows you to use MySQL, Postgres, or SQLite on multiple operating systems.
A Future-Proof Status Page
Statup strives to remain future-proof and remain intact if a failure is created. Your Statup service should not be running on the same instance you're trying to monitor. If your server crashes your Status Page should still remaining online to notify your users of downtime.
Lightweight and Fast
Statup is a very lightweight application and is available for Linux, Mac, and Windows. The Docker image is only ~16Mb so you know that this application won't be filling up your hard drive space. The Status binary for all other OS's is ~17Mb at most.
No Requirements
Statup is built in Go Language so all you need is the precompile binary based on your operating system. You won't need to install anything extra once you have the Statup binary installed. You can even run Statup on a Raspberry Pi.
Custom SASS Styling
Statup will allow you to completely customize your Status Page using SASS styling with easy to use variables. The Docker image actually contains a prebuilt SASS binary so you won't even need to setup anything!
Mobile View is Gorgeous
Your status page will be optimized for mobile and desktop viewers. Statup has a full width edge to edge view, which you can also edit to meet your requirements.
Run on Any Server
Whether you're a Docker fan-boy or a AWS EC2 master, Statup gives you multiple options to simply get running. Our Amazon AMI image is only 8Gb and will automatically update to the most stable version of Statup. Running on an EC2 server might be the most cost effective way to host your own Statup Status Page. The server runs on the smallest EC2 instance (t2.nano) AWS has to offer, which only costs around $4.60 USD a month for your dedicated Status Page. Want to run it on your own Docker server? Awesome! Statup has multiple docker-compose.yml files to work with. Statup can automatically create a SSL Certification for your status page.
Slack, Email, Twilio and more
Statup includes email notification via SMTP and Slack integration using Incoming Webhook. Insert the webhook URL into the Settings page in Statup and enable the Slack integration. Anytime a service fails, you're channel that you specified on Slack will receive a message.
User Created Plugins and Notifiers
View the Plugin Wiki to see detailed information about Golang Plugins. Statup isn't just another Status Page for your applications, it's a framework that allows you to create your own plugins to interact with every element of your status page. Notifier's can also be create with only 1 golang file. Plugin are created in Golang using the statup/plugin golang package. The plugin package has a list of interfaces/events to accept into your own plugin application.
Easy to use Dashboard
Having a straight forward dashboard makes Statup that much better. Monitor your websites and applications with a basic HTTP GET request, or add a POST request with your own JSON to post to the endpoint.
Exporting Static HTML
If you want to use Statup as a CLI application without running a server, you can export your status page to a static HTML. This export tool is very useful for people who want to export their HTML and upload/commit it to Github Pages or an FTP server.
statup export
index.html will be created in the current directory with CDN URL's for assets.Run on Docker
Use the Statup Docker Image to create a status page in seconds. Checkout the Docker Wiki to view more details on how to get started using Docker.
docker run -it -p 8080:8080 hunterlong/statup
There are multiple ways to startup a Statup server. You want to make sure Statup is on it's own instance that is not on the same server as the applications you wish to monitor. It doesn't look good when your Status Page goes down, I recommend a small EC2 instance so you can set it, and forget it.
Docker Compose
In this folder there is a standard docker-compose file that include nginx, postgres, and Statup.
docker-compose up -d
Docker Compose with Automatic SSL
You can automatically start a Statup server with automatic SSL encryption using this docker-compose file. First point your domain's DNS to the Statup server, and then run this docker-compose command with DOMAIN and EMAIL. Email is for letsencrypt services.
LETSENCRYPT_HOST=mydomain.com \
LETSENCRYPT_EMAIL=info@mydomain.com \
docker-compose -f docker-compose-ssl.yml up -d
Once your instance has started, it will take a moment to get your SSL certificate. Make sure you have a A or CNAME record on your domain that points to the IP/DNS of your server running Statup.
Run on EC2 Server
Running Statup on the smallest EC2 server is very quick using the AWS AMI Image. Checkout the AWS Wiki to see a step by step guide on how to get your EC2 Statup service online.
Create the AWS Security Groups with the commands below, Statup will expose port 80 and 443.
aws ec2 create-security-group --group-name StatupPublicHTTP \
--description "Statup HTTP Server on port 80 and 443"
# will response back a Group ID. Copy ID and use it for --group-id below.
aws ec2 authorize-security-group-ingress \
--group-id sg-7e8b830f --protocol tcp \
--port 80 --cidr 0.0.0.0/0
aws ec2 authorize-security-group-ingress \
--group-id sg-7e8b830f --protocol tcp \
--port 443 --cidr 0.0.0.0/0
aws ec2 run-instances \
--image-id ami-7be8a103 \
--count 1 --instance-type t2.nano \
--key-name MYKEYHERE \
--security-group-ids sg-7e8b830f
The AWS-CLI command below will automatically create an EC2 server and create an SSL certificate from Lets Encrypt, for free.
wget https://raw.githubusercontent.com/hunterlong/statup/master/servers/ec2-ssl.sh
# Edit ec2-ssl.sh and insert your domain you want to use, then run command below.
# Use the Security Group ID that you used above for --security-group-ids
aws ec2 run-instances \
--user-data file://ec2-ssl.sh \
--image-id ami-7be8a103 \
--count 1 --instance-type t2.nano \
--key-name MYKEYHERE \
--security-group-ids sg-7e8b830f
Prometheus Exporter
Statup includes a Prometheus Exporter so you can have even more monitoring power with your services. The Prometheus exporter can be seen on /metrics, simply create another exporter in your prometheus config. Use your Statup API Secret for the Authorization Bearer header, the /metrics URL is dedicated for Prometheus and requires the correct API Secret has Authorization header.
scrape_configs:
- job_name: 'statup'
bearer_token: 'MY API SECRET HERE'
static_configs:
- targets: ['statup:8080']
Contributing
Statup accepts Push Requests! Feel free to add your own features and notifiers. You probably want to checkout the Notifier Wiki to get a better understanding on how to create your own notification methods for failing/successful services. Testing on Statup will test each function on MySQL, Postgres, and SQLite. I recommend you run a MySQL and a Postgres Docker image for testing.
Documentation
¶
Overview ¶
Package statup is a server monitoring application that includs a status page server. Visit the Statup repo at https://github.com/hunterlong/statup to get a full understanding of what this application can do.
Install Statup ¶
Statup is available for Mac, Linux and Windows 64x. You can download the tar.gz file or use a couple other methods. Download the latest release at https://github.com/hunterlong/statup/releases/latest or view below. If you're on windows, download the zip file from the latest releases link.
// MacOS using homebrew brew tap hunterlong/statup brew install statup // Linux installation bash <(curl -s https://assets.statup.io/install.sh) statup version
Docker ¶
Statup can be built in many way, the best way is to use Docker!
docker run -it -p 8080:8080 hunterlong/statup
Enjoy Statup and tell me any issues you might be having on Github. https://github.com/hunterlong
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package main for building the Statup CLI binary application.
|
Package main for building the Statup CLI binary application. |
|
Package core contains the main functionality of Statup.
|
Package core contains the main functionality of Statup. |
|
notifier
Package notifier contains the main functionality for the Statup Notification system Example Notifier Below is an example of a Notifier with multiple Form values to custom your inputs.
|
Package notifier contains the main functionality for the Statup Notification system Example Notifier Below is an example of a Notifier with multiple Form values to custom your inputs. |
|
dev
|
|
|
Package handlers contains the HTTP server along with the requests and routes.
|
Package handlers contains the HTTP server along with the requests and routes. |
|
Package notifiers holds all the notifiers for Statup, which also includes user created notifiers that have been accepted in a Push Request.
|
Package notifiers holds all the notifiers for Statup, which also includes user created notifiers that have been accepted in a Push Request. |
|
Package plugin contains the interfaces to build your own Golang Plugin that will receive triggers on Statup events.
|
Package plugin contains the interfaces to build your own Golang Plugin that will receive triggers on Statup events. |
|
Package source holds all the assets for Statup.
|
Package source holds all the assets for Statup. |
|
Package types contains all of the structs for objects in Statup including services, hits, failures, Core, and others.
|
Package types contains all of the structs for objects in Statup including services, hits, failures, Core, and others. |
|
Package utils contains common methods used in most packages in Statup.
|
Package utils contains common methods used in most packages in Statup. |