Upmon

A cloud-native, distributed uptime monitor written in Go

⚠️ Upmon is currently being actively developed. Until it reaches v1.0.0 breaking changes may occur in minor versions.

Upmon is a service for monitoring uptime. It is distributed and built around a gossip mechanism, providing eventual consistency. By easily creating a cluster of uptime monitors, a failure-tolerant uptime monitoring service may be deployed in minutes.

Quickstart

Upcoming.

Features

Deployable as a single node or an entire cluster
Support for monitoring via pings, TCP sockets, HTTP requests and more
Easily extensible to provide new monitoring capabilities
Simple (optional) API for monitoring the status of services

Documentation

Please view the docs on GitHub pages or see them in the docs folder.

To view them offline in your browser, first install docsify by executing npm install --global docsify-cli and then run docsify serve docs in the project's folder.

Contributing

Any help with the project is more than welcome. The project is still in its infancy and not recommended for production.

Development

Dependencies beyond Go and Make:

Go tools (installed by running make install-tools)
- stringer - used to generate the String() method for iotas
Other
- openapi-generator - used to generate the models and client for the REST API

# Clone the repository
https://github.com/AlexGustafsson/upmon.git && cd upmon

# Show available commands
make help

## Dependencies

# Install tools such as stringer
make install-tools

## Building

# Build the server
make build

# Generate API clients etc.
make generate

## Code quality

# Format code
make format
# Lint code
make lint
# Vet the code
make vet
# Check the code for security issues
make gosec

## Testing

# Run tests
make test