mozzo 0.4.1

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

mozzo

A lightweight CLI for acknowledging and managing Nagios Core alerts and reporting via its native CGI scripts.

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, generate service/host uptime reporting and view statuses without needing to install specialized Nagios libraries or scrape HTML.

[!NOTE] This is compatible with Nagios Core 4.4.x and not been tested with 4.5.x

Table of Contents

• 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 or 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
  • Acknowledging all Unhandled Issues
• Service Reporting and Uptime
  • Listing all Services by Host
  • Listing Service Details by Host
  • Uptime Reporting
    • Report Uptime by Service
    • Report Uptime by Host
  • Exporting Report Data
• Contributing

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 needs 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 or 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"

Acknowledging all Unhandled Issues

• This bash one-liner can ack all unhandled issues in one swoop.

mozzo --unhandled | grep -E -i "critical|warning" | while read -r level host arrow service; do mozzo --ack --host "$host" --service "$service"; done

Service Reporting and Uptime

• We also support reporting for uptime per host and per service based on Nagios archivejson.cgi

Listing all Services by Host

mozzo --status --host host01.example.com

Listing Service Details by Host

mozzo --status --host host01.example.com --service "DNS"

Uptime Reporting

[!NOTE] Default uptime reporting is 365 days if --days is not specified.

Report Uptime by Service

mozzo --status --host host01.example.com --service "DNS" --uptime --days 180

Report Uptime by Host

mozzo --status --host host01.example.com --uptime

Exporting Report Data

• You can export in both JSON and CSV

mozzo --status --host host01.example.com --service "DNS" --uptime --format json > /tmp/host01_dns.json

mozzo --status --host host01.example.com --service "HTTP" --uptime --format csv > /tmp/host01_http_json

Contributing

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