check_paloalto 0.1.5

check_paloalto is a Nagios/Icinga plugin for Palo Alto Next Generation Firewalls. It is written in Python and based on the PA REST API.

nagios_check_paloalto is a Nagios/Icinga plugin for Palo Alto Next Generation Firewalls. It is written in Python and based on the PA REST API.

Tested on:

• PA-500 v6.0.1 - v6.0.9

• PA-3050 v6.0.9 - 7.0.0

Documentation

http://nagios-check-paloalto.readthedocs.org/en/latest/

Quickstart

Please make sure you have python-dev and libxslt1-dev installed on your machine.

To install nagios_check_paloalto:

$ pip install check_paloalto

or use:

$ pip3 install check_paloalto

The plugin requires a token to get information from the PA-REST-API. Please see the following link for more information: http://nagios-check-paloalto.readthedocs.org/en/latest/configuration.html#token

Usage

Command-line usage:

usage: check_paloalto [-h] [-H HOST] [-T TOKEN] [-v] [-t TIMEOUT]
                  {diskspace,certificates,load,useragent,environmental,sessinfo,thermal,throughput}
                  ...

positional arguments:
  {diskspace,certificates,load,useragent,environmental,sessinfo,thermal,throughput}
    diskspace           Checks used diskspace.
    certificates        Checks the certificate store for expiring
                        certificates: Outputs is a warning, if a certificate
                        is in range.
    load                Checks the CPU load.
    useragent           Checks for running useragents.
    environmental       Checks if an alarm is found.
    sessinfo            Checks important session parameters.
    thermal             Checks the temperature.
    throughput          Checks the throughput.

optional arguments:
  -h, --help            show this help message and exit

Connection:
  -H HOST, --host HOST  PaloAlto Server Hostname
  -T TOKEN, --token TOKEN
                        Generated Token for REST-API access

Debug:
  -v, --verbose         increase output verbosity (use up to 3 times)
  -t TIMEOUT, --timeout TIMEOUT
                        abort check execution after so many seconds (use 0 for
                        no timeout)

History

0.1.5 (2016-29-04)

• Fixed a argparse bug

0.1.4 (2016-29-04)

• Added functionality to monitor state of the user-agents

• Added script timeout switch

• Improved error handling

• Improved functionality of sessinfo command

0.1.3 (2015-14-09)

• Disabled warnings for insecure requests to support older installations: https://urllib3.readthedocs.org/en/latest/security.html

0.1.2 (2015-14-09)

• Fixed a bug for parsing args in python3.

• Enabled warnings for insecure requests: https://urllib3.readthedocs.org/en/latest/security.html

• Changed format for setup.cfg.

• Updated docs.

0.1.1 (2015-10-09)

• Support Python 2.7, 3.3, 3.4.

• Support PyPi.

• Included tests.

• Improved performance.

• Improved output and debugging.