NMS‑Tools

Deterministic Monitoring & Diagnostic Utilities for Infrastructure‑Grade Environments

NMS‑Tools is a deterministic, audit‑transparent suite of monitoring and diagnostic utilities designed for engineers who require reproducible behavior, predictable output modes, and clean architectural boundaries.
Each tool integrates seamlessly with Nagios and other NMS platforms, providing consistent, structured visibility across distributed systems.

Overview

The suite focuses on clarity, reproducibility, and deterministic inspection of system state.
Every tool follows the same principles:

1. Determinism — same input → same output
2. Reproducibility — output can be regenerated at any time
3. Audit Transparency — no hidden state, no ambiguous behavior

Key Features

1. Deterministic output modes (Nagios, JSON, verbose)
2. Cross‑platform compatibility across major Linux distributions
3. Audit‑transparent diagnostics and state reporting
4. Strict separation between logic, output, and enforcement layers
5. Designed for integration with Nagios and other NMS platforms

Included Tools

• check_cert.py — deterministic certificate inspection with Nagios mode
• check_tls.py — TLS version, cipher, and chain validation
• check_http.py — deterministic HTTP/HTTPS endpoint checks
• check_system.py — system‑level diagnostics (CPU, memory, load)
• check_network.py — network reachability and latency checks

Deterministic Output Modes

• Nagios Mode — single‑line output, no extra text, strict formatting
• JSON Mode — structured machine‑readable output
• Verbose Mode — full diagnostics for human inspection

Architecture Overview

1. Input Layer

All tools accept explicit, validated parameters.
No implicit defaults, no hidden behavior.

2. Inspection Layer

Performs deterministic checks: certificates, TLS, HTTP, system metrics, or network state.
All logic is explicit and reproducible.

3. Output Layer

• Strict Nagios output contract
• JSON for automation pipelines
• Verbose diagnostics for engineers

4. Enforcement & Policy Layer

Tools enforce consistent behavior across environments, ensuring that monitoring results remain stable and predictable over time.

Current Status

• Version: 0.2.x
• Scope: Certificate, TLS, HTTP, system, and network checks
• Output Modes: Nagios, JSON, verbose
• Integration: Nagios‑ready
• Platform: Linux

Roadmap

Near‑Term

• Finalize strict Nagios mode for all tools
• Add OCSP and chain validation to TLS checks
• Expand certificate inspection helpers
• Improve JSON schema consistency across tools

Mid‑Term

• Unified CLI wrapper for all NMS‑Tools
• Automated test suite for deterministic output validation
• Documentation site with examples and integration guides

Long‑Term

• Distributed monitoring support
• Plugin‑based architecture for new checks
• Integration with deterministic update frameworks

Why NMS‑Tools Exists

Traditional monitoring tools often produce inconsistent output, hide important details, or behave differently across environments.
NMS‑Tools applies deterministic engineering principles:

1. explicit state
2. reproducible workflows
3. audit‑transparent diagnostics
4. strict output contracts
5. clean architectural boundaries

Links

• GitHub Repository
• Documentation
• Usage Examples
• Release Notes

Related Projects

• BotScanner
• licensegen