Nagios output

nagios_out

Emit a Nagios-formatted output line with status code and job name. If the second argument contains '=', it is treated as performance data; otherwise a '-' separator is inserted before the message. $this_job is used as the service description. If not set by the caller, defaults to the invoking script's basename.

Arguments

  • $1 (string): Status code or prefix (e.g. 0, 1, 2, 3, P)
  • $2 (string): Message or performance data string
  • ... (string): Optional: additional lines

Exit codes

  • 0: Always

Output on stdout

  • Nagios-formatted status line(s)

nagios_auto

Emit a Nagios performance data output line, using nagios_long for multiple args.

Arguments

  • ... (string): Message or performance data

Exit codes

  • 0: Always

Output on stdout

  • Nagios-formatted output

nagios_ok

Emit a Nagios OK (status 0) output line. Accepts -r/--return to return 0 after output, or -x/--exit to exit 0.

Arguments

  • $1 (string): Optional: -r/--return or -x/--exit
  • ... (string): Message or performance data

Exit codes

  • 0: Always

Output on stdout

  • Nagios OK output

nagios_warn

Emit a Nagios WARNING (status 1) output line. Accepts -r/--return to return 1 after output, or -x/--exit to exit 1.

Arguments

  • $1 (string): Optional: -r/--return or -x/--exit
  • ... (string): Message or performance data

Exit codes

  • 0: Always

Output on stdout

  • Nagios WARNING output

nagios_crit

Emit a Nagios CRITICAL (status 2) output line. Accepts -r/--return to return 2 after output, or -x/--exit to exit 2.

Arguments

  • $1 (string): Optional: -r/--return or -x/--exit
  • ... (string): Message or performance data

Exit codes

  • 0: Always

Output on stdout

  • Nagios CRITICAL output

nagios_unknown

Emit a Nagios UNKNOWN (status 3) output line. Accepts -r/--return to return 3 after output, or -x/--exit to exit 3.

Arguments

  • $1 (string): Optional: -r/--return or -x/--exit
  • ... (string): Message or performance data

Exit codes

  • 0: Always

Output on stdout

  • Nagios UNKNOWN output

nagios_long

Convert newlines to literal '\n' for Nagios multi-line output format. Reads from stdin.

Exit codes

  • 0: Always

Output on stdout

  • Input with actual newlines replaced by the literal string \n