ZMON source code on GitHub is no longer in active development. Zalando will no longer actively review issues or merge pull-requests.

ZMON is still being used at Zalando and serves us well for many purposes. We are now deeper into our observability journey and understand better that we need other telemetry sources and tools to elevate our understanding of the systems we operate. We support the OpenTelemetry initiative and recommended others starting their journey to begin there.

If members of the community are interested in continuing developing ZMON, consider forking it. Please review the licence before you do.

ZMON Demo Installation

Scripts to install a single node ZMON for demonstration purposes. Theses scripts are used to bootstrap our public ZMON demo https://demo.zmon.io/.

Usage

You can access the ZMON Controller frontend at https://demo.zmon.io/ with your GitHub credentials.

You can use the ZMON CLI to add and update check and alert definitions via the REST API, you need a personal GitHub access token for this:

$ echo "url: https://demo.zmon.io/api/v1\ntoken: <YOUR-GITHUB-TOKEN>" > ~/.zmon-cli.yaml
$ sudo pip3 install --upgrade zmon-cli
$ zmon entities  # try REST API, list entities

More information can be found in our ZMON Documentation.

Installation

Requirements:

• Clean, empty VM or root server
• Ubuntu 15.10 (might work with other versions too)

$ sudo apt-get install git
$ git clone https://github.com/zalando/zmon-demo.git
$ cd zmon-demo
$ sudo ./install.sh

The script will start a Docker "bootstrap" image which will start all required ZMON components as Docker containers.

Known Issues

• The boostrap script is not yet completely portable, i.e. it will only work for https://demo.zmon.io/

Let's Encrypt SSL

How to renew SSL certs for the zmon.io and demo.zmon.io domains:

$ docker stop zmon-httpd  # make sure the HTTP port is "free"
$ ./letsencrypt-auto renew
$ docker start zmon-httpd