mozzo 0.3.0

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

mozzo

A lightweight CLI 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
  • List service issue
  • 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
  • Disable alerting for a specific service
  • Disable alerting for all services on a host
  • Enable alerting for all services on a host
  • Enable alerting for a specific service
  • Toggle global alerts
  • Setting Ack or Downtime with a Custom Message
• Contributing

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.

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](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](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](https://raw.githubusercontent.com/sadsfae/mozzo/refs/heads/main/config.yml)
vim ~/.config/mozzo/config.yml

Your config.yml needs the following structure:

nagios_server: [https://nagios.example.com](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

List service issues

mozzo --service-issues [ --host host.example.com ]

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"

Disable alerting for a specific service

mozzo --disable-alerts --host host01.example.com --service "HTTP"

Disable alerting for all services on a host

mozzo --disable-alerts --host host01.example.com --all-services

Enable alerting for all services on a host

mozzo --enable-alerts --host host01.example.com --all-services

Enable alerting for a specific service

mozzo --enable-alerts --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"

Contributing

• Please open pull requests against the development branch
• I maintain an Ansible playbook to install Nagios Core here