mozzo 0.2.0

A command-line assistant for acknowledging and managing Nagios Core alerts.

mozzo

A lightweight command-line assistant for acknowledging and managing Nagios Core alerts via its native CGI scripts.

Table of Contents

• About
• Installation
  • Option 1: Run from source (Standalone)
  • Option 2: Install via pip
  • Option 3: Install via Pypi
• Configuration
• Usage
  • View Nagios process status
  • List unhandled/alerting services
  • Acknowledge a specific service
  • Acknowledge a host and all its services
  • Set downtime for a specific host
  • Set downtime for a host and all its services
  • Set downtime for a specific service
  • Toggle global alerts
  • Setting Ack or Downtime with a Custom Message
• License

About

Mozzo interacts with Nagios Core (4.x) via cmd.cgi and statusjson.cgi using standard HTTPS requests. It allows you to acknowledge alerts, schedule downtime, and view statuses without needing to install specialized Nagios libraries or scrape HTML.

a Mozzo is Neapolitan for a young helper who does menial tasks on a ship and is quick to acknowledge things.

Installation

Option 1: Run from source (Standalone)

You can clone the repository and run the script directly:

git clone https://github.com/sadsfae/mozzo.git
cd mozzo
chmod +x mozzo.py
./mozzo.py --help

Option 2: Install via pip

Install globally or in a virtual environment to make the mozzo command available anywhere:

git clone https://github.com/sadsfae/mozzo.git
cd mozzo
pip install .
mozzo --help

Option 3: Install via Pypi

python -m venv mozzo
. !$/bin/activate
pip install mozzo

Configuration

Mozzo requires a configuration file named config.yml. It will search for this file in the following order:

1. ~/.config/mozzo/config.yml
2. ./config.yml (Current directory)
3. /etc/mozzo/config.yml

[!TIP] Copy the example config.yml and edit it first.

mkdir -p ~/.config/mozzo
curl -s -o ~/.config/mozzo/config.yml https://raw.githubusercontent.com/sadsfae/mozzo/refs/heads/main/config.yml
vim ~/.config/mozzo/config.yml

Your config.yml should have the following structure:

nagios_server: https://nagios.example.com
nagios_cgi_path: /nagios/cgi-bin
nagios_username: nagiosadmin
nagios_password: mysecurepassword
default_downtime: 120 # in minutes
verify_ssl: false
date_format: "%m-%d-%Y %H:%M:%S"

Usage

[!IMPORTANT] You can run mozzo (if installed) or ./mozzo.py or python mozzo.py (if running from source).

View Nagios process status

mozzo --status

List unhandled/alerting services

mozzo --unhandled

Acknowledge a specific service

mozzo --ack --host host01.example.com --service "HTTP"

Acknowledge a host and all its services

mozzo --ack --host host01.example.com --all-services

Set downtime for a specific host

mozzo --set-downtime --host host01.example.com

Set downtime for a host and all its services

mozzo --set-downtime --host host01.example.com --all-services

Set downtime for a specific service

mozzo --set-downtime --host host01.example.com --service "HTTP"

Toggle global alerts

mozzo --disable-alerts
mozzo --enable-alerts

Setting Ack or Downtime with a Custom Message

mozzo --ack --host host01.example.com --message "Acknowledged per ticket INC-12345"
mozzo --set-downtime --host host01.example.com --all-services -m "Patching window"

License

This project is licensed under the GPLv3 License - see the LICENSE file for details. Author: Will Foster ([e-mail]).