nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius,...
Transcript of nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius,...
![Page 1: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/1.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛Release 0.3.2
Ralph Offinger
May 30, 2017
![Page 2: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/2.jpg)
![Page 3: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/3.jpg)
Contents
1 nagios_check_paloalto: a Nagios/Icinga Plugin 31.1 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.2 Quickstart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.3 Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2 Installation 5
3 Configuration 73.1 Token . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73.2 Nagios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
4 Usage 94.1 diskspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104.2 certificates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104.3 load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104.4 environmental . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114.5 sessinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114.6 thermal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114.7 throughput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124.8 useragents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
5 Contributing 135.1 Types of Contributions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135.2 Get Started! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145.3 Virtual development environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155.4 Pull Request Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
6 Credits 176.1 Development Lead . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176.2 Contributors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
7 History 19
8 0.3.2 (2017-16-05) 21
9 0.3.1 (2017-10-03) 23
10 0.3 (2017-27-02) 25
i
![Page 4: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/4.jpg)
11 0.1.6 (2016-06-05) 27
12 0.1.5 (2016-29-04) 29
13 0.1.4 (2016-29-04) 31
14 0.1.3 (2015-14-09) 33
15 0.1.2 (2015-14-09) 35
16 0.1.1 (2015-10-09) 37
17 Indices and tables 39
ii
![Page 5: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/5.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
Contents:
Contents 1
![Page 6: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/6.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
2 Contents
![Page 7: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/7.jpg)
CHAPTER 1
nagios_check_paloalto: a Nagios/Icinga Plugin
nagios_check_paloalto is a Nagios/Icinga plugin for Palo Alto Next Generation Firewalls. It is written in Python andbased on the PA REST API.
Tested on:
• PA-500 v6.0.1 - v6.0.9
• PA-3050 v6.0.9 - 7.1.9
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 --upgrade
or use:
$ pip3 install check_paloalto --upgrade
The plugin requires a token to get information from the PA-REST-API. Please see the following link for more infor-mation: http://nagios-check-paloalto.readthedocs.org/en/latest/configuration.html#token
3
![Page 8: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/8.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
Usage
Command-line usage:
usage: check_paloalto [-h] -H HOST -T TOKEN [-v] [-t TIMEOUT] [--reset][--version]{diskspace,certificates,load,useragent,environmental,sessinfo,
→˓thermal,throughput}...
positional arguments:{diskspace,certificates,load,useragent,environmental,sessinfo,thermal,throughput}diskspace check used diskspace.certificates check the certificate store for expiring certificates:
Outputs is a warning, if a certificate is in range.load check the CPU load.useragent check for running useragents.environmental check if an alarm is found.sessinfo check important session parameters.thermal check the temperature.throughput check 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 forno timeout)
--reset Deletes the cookie file for the throughput check.
Info:--version show program's version number and exit
4 Chapter 1. nagios_check_paloalto: a Nagios/Icinga Plugin
![Page 9: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/9.jpg)
CHAPTER 2
Installation
Simply install check_paloalto:
$ pip install check_paloalto
or use:
$ pip3 install check_paloalto
5
![Page 10: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/10.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
6 Chapter 2. Installation
![Page 11: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/11.jpg)
CHAPTER 3
Configuration
Token
The REST API requires a token to get information. This token must be generated once:
1. Create a "monitoring role" in the PA.2. Disable everything in the WEB UI tab within that role3. Enable "Operational requests" in the XML API tab and disable everything else4. Ensure that the tab "Command line" is "None"5. Create a new Admin user who uses that custom role and for best practices choose at→˓least 20 length password without special characters other than '_-'6. Generating the token is easy. To do that login to your PA with the monitoring user
and open:https://x.x.x.x/api/?type=keygen&user=YOUR-USERNAME&password=YOUR-PASSWORD(replace YOUR-USERNAME with the username created in step 5. and YOUR-PASSWORD→˓accordingly)
Nagios
define command {command_name check_paloaltocommand_line /usr/local/bin/check_paloalto}
7
![Page 12: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/12.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
8 Chapter 3. Configuration
![Page 13: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/13.jpg)
CHAPTER 4
Usage
Command-line usage:
usage: check_paloalto [-h] -H HOST -T TOKEN [-v] [-t TIMEOUT] [--reset][--version]{diskspace,certificates,load,useragent,environmental,sessinfo,
→˓thermal,throughput}...
positional arguments:{diskspace,certificates,load,useragent,environmental,sessinfo,thermal,throughput}diskspace check used diskspace.certificates check the certificate store for expiring certificates:
Outputs is a warning, if a certificate is in range.load check the CPU load.useragent check for running useragents.environmental check if an alarm is found.sessinfo check important session parameters.thermal check the temperature.throughput check 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 forno timeout)
--reset Deletes the cookie file for the throughput check.
9
![Page 14: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/14.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
Info:--version show program's version number and exit
To check your Palo Alto Firewall, there are several commands available.
diskspace
usage:
usage: check_paloalto diskspace [-h] [-w WARN] [-c CRIT]
optional arguments:-h, --help show this help message and exit-w WARN, --warn WARN Warning if diskspace is greater. (default: 85)-c CRIT, --crit CRIT Critical if disksace is greater. (default: 95)
example:
$ check_paloalto -H HOST -T TOKEN diskspace$ DISKSPACE OK - sda2: 70%, sda5: 51%, sda6: 58%, sda8: 78% | sda2=70%;85;95 sda5=51%;→˓85;95 sda6=58%;85;95 sda8=78%;85;95
certificates
usage:
usage: check_paloalto certificates [-h] [-ex EXCLUDE] [-r RANGE]
optional arguments:-h, --help show this help message and exit-ex EXCLUDE, --exclude EXCLUDE
Exclude certificates from check by name.-r RANGE, --range RANGE
Warning if days until certificate expiration is inrange: Represents a threshold range. The generalformat is "[@][start:][end] (default: 0:20)
example:
$ check_paloalto -H HOST -T TOKEN certificates$ CERTIFICATE WARNING - Certificate1 expires in 8 days
load
usage:
usage: check_paloalto load [-h] [-w WARN] [-c CRIT]
optional arguments:-h, --help show this help message and exit
10 Chapter 4. Usage
![Page 15: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/15.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
-w WARN, --warn WARN Warning if CPU load is greater. (default: 85)-c CRIT, --crit CRIT Critical if CPU load is greater. (default: 95)
example:
$ check_paloalto -H HOST -T TOKEN load$ LOAD OK - CPU0: 0.0%, CPU1: 1.0%, CPU2: 4.0%, CPU3: 5.0%, CPU4: 6.0%, CPU5: 5.0% |→˓CPU0=0.0%;85;95;0;100 CPU1=1.0%;85;95;0;100 CPU2=4.0%;85;95;0;100 CPU3=5.0%;85;95;0;→˓100 CPU4=6.0%;85;95;0;100 CPU5=5.0%;85;95;0;100
environmental
usage:
usage: check_paloalto environmental [-h]
optional arguments:-h, --help show this help message and exit
example:
$ check_paloalto -H HOST -T TOKEN environmental$ ENVIRONMENTAL OK - No alarms found.
sessinfo
usage:
usage: check_paloalto sessinfo [-h]
optional arguments:-h, --help show this help message and exit
example:
$ check_paloalto -H HOST -T TOKEN sessinfo$ SESSINFO OK - Active sessions: 6582 / Throughput (kbps): 24304 | session=6582;20000;→˓50000;0;262142 throughput_kbps=24304;;;0
thermal
usage:
usage: check_paloalto thermal [-h] [-w WARN] [-c CRIT]
optional arguments:-h, --help show this help message and exit-w WARN, --warn WARN Warning if temperature is greater. (default: 40)-c CRIT, --crit CRIT Critical if temperature is greater. (default: 45)
4.4. environmental 11
![Page 16: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/16.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
example:
$ check_paloalto -H HOST -T TOKEN thermal$ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33→˓degrees Celsius, Temperature @ Cavium is 36 degrees Celsius, Temperature @ Intel→˓PHY is 24 degrees Celsius | 'Temperature @ Cavium'=36.5;40;45;5.0;60.0 'Temperature→˓@ Intel PHY'=24.2;40;45;5.0;60.0 'Temperature @ Ocelot'=29.9;40;45;5.0;60.0→˓'Temperature @ Switch'=33.8;40;45;5.0;60.0
throughput
usage:
usage: check_paloalto throughput [-h] -i [INTERFACE]
optional arguments:-h, --help show this help message and exit-i [INTERFACE], --interface [INTERFACE]
PA interface name, seperate by comma.
example:
$ check_paloalto -H HOST -T TOKEN throughput -i ethernet1/1$ THROUGHPUT OK - Input is 5.74 Mb/s - Output is 11.81 Mb/s | 'in_bps_ethernet1/1→˓'=5743432.0;;;0 'out_bps_ethernet1/1'=11807524.0;;;0
$ check_paloalto -H HOST -T TOKEN throughput -i ethernet1/1,ethernet1/2$ THROUGHPUT OK - Input is 44.12 Mb/s - Output is 24.59 Mb/s | 'in_bps_ethernet1/1→˓'=5895616.0;;;0 'in_bps_ethernet1/2'=38225768.0;;;0 'out_bps_ethernet1/1'=15926620.→˓0;;;0 'out_bps_ethernet1/2'=8661100.0;;;0
To get all available names of your interfaces, please have a look at https://www.paloaltonetworks.com/documentation/61/pan-os/pan-os/getting-started/configure-interfaces-and-zones.html
useragents
usage:
usage: check_paloalto useragent [-h] [-w WARN] [-c CRIT]
optional arguments:-h, --help show this help message and exit-w WARN, --warn WARN Warning if agent is not responding for a given amount
of seconds. (default: 60)-c CRIT, --crit CRIT Critical if agent is not responding for a given amount
of seconds. (default: 240)
example:
$ check_paloalto -H HOST -T TOKEN useragent$ USERAGENT OK - All agents are connected and responding. | 'Agent: Agent1 -→˓HOST1(vsys: vsys1) Host: 192.168.1.1(192.168.1.1):5007'=1;60;240
12 Chapter 4. Usage
![Page 17: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/17.jpg)
CHAPTER 5
Contributing
Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.
You can contribute in many ways:
Types of Contributions
Report Bugs
Report bugs at https://github.com/ralph-hm/nagios_check_paloalto/issues.
If you are reporting a bug, please include:
• Your operating system name and version.
• Any details about your local setup that might be helpful in troubleshooting.
• Detailed steps to reproduce the bug.
Fix Bugs
Look through the GitHub issues for bugs. Anything tagged with “bug” is open to whoever wants to implement it.
Implement Features
Look through the GitHub issues for features. Anything tagged with “feature” is open to whoever wants to implementit.
13
![Page 18: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/18.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
Write Documentation
nagios_check_paloalto could always use more documentation, whether as part of the official nagios_check_paloaltodocs, in docstrings, or even on the web in blog posts, articles, and such.
Submit Feedback
The best way to send feedback is to file an issue at https://github.com/ralph-hm/nagios_check_paloalto/issues.
If you are proposing a feature:
• Explain in detail how it would work.
• Keep the scope as narrow as possible, to make it easier to implement.
• Remember that this is a volunteer-driven project, and that contributions are welcome :)
Get Started!
Ready to contribute? Here’s how to set up nagios_check_paloalto for local development.
1. Fork the nagios_check_paloalto repo on GitHub.
2. Clone your fork locally:
$ git clone [email protected]:your_name_here/nagios_check_paloalto.git
3. Install your local copy into a virtualenv. Assuming you have virtualenvwrapper installed, this is how you set upyour fork for local development:
$ mkvirtualenv nagios_check_paloalto$ cd nagios_check_paloalto/$ python setup.py develop
4. Create a branch for local development:
$ git checkout -b name-of-your-bugfix-or-feature
Now you can make your changes locally.
5. When you’re done making changes, check that your changes pass flake8 and the tests, including testing otherPython versions with tox:
$ make test-all
To get flake8 and tox, just pip install them into your virtualenv.
6. Commit your changes and push your branch to GitHub:
$ git add .$ git commit -m "Your detailed description of your changes."$ git push origin name-of-your-bugfix-or-feature
7. Submit a pull request through the GitHub website.
14 Chapter 5. Contributing
![Page 19: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/19.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
Virtual development environment
You can use Vagrant to start a virtual development environment, where all the necessary dependencies are alreadyinstalled.
Please have a look at the Vagrantfile.
Pull Request Guidelines
Before you submit a pull request, check that it meets these guidelines:
1. The pull request should include tests.
2. If the pull request adds functionality, the docs should be updated. Put your new functionality into a functionwith a docstring, and add the feature to the list in README.rst.
3. The pull request should work for Python 2.6, 2.7, 3.3, and 3.4, and for PyPy. Check https://travis-ci.org/ralph-hm/nagios_check_paloalto/pull_requests and make sure that the tests pass for all supported Python ver-sions.
5.3. Virtual development environment 15
![Page 20: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/20.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
16 Chapter 5. Contributing
![Page 21: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/21.jpg)
CHAPTER 6
Credits
Development Lead
• Ralph Offinger <[email protected]>
Contributors
• Thomas Fischer <[email protected]>
17
![Page 22: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/22.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
18 Chapter 6. Credits
![Page 23: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/23.jpg)
CHAPTER 7
History
19
![Page 24: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/24.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
20 Chapter 7. History
![Page 25: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/25.jpg)
CHAPTER 8
0.3.2 (2017-16-05)
• Fixed issue #8: Measuring throughput on multiple identically configured PA’s fails
21
![Page 26: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/26.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
22 Chapter 8. 0.3.2 (2017-16-05)
![Page 27: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/27.jpg)
CHAPTER 9
0.3.1 (2017-10-03)
• Improvement: It is no longer necessary to reset the internal cookie when upgrading PA.
• Renamed performance data label for throughput command.
• Removed the the unit of measurement (UOM) for throughput command
23
![Page 28: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/28.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
24 Chapter 9. 0.3.1 (2017-10-03)
![Page 29: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/29.jpg)
CHAPTER 10
0.3 (2017-27-02)
• Support for Python 3.5 added
• Minor code improvements
• Changed the the unit of measurement (UOM) according to official Nagios-Documentation (thanks to Ios77)
25
![Page 30: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/30.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
26 Chapter 10. 0.3 (2017-27-02)
![Page 31: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/31.jpg)
CHAPTER 11
0.1.6 (2016-06-05)
• Added script version switch
• Improved error handling
• Updated documentation
• Upgraded dependencies
27
![Page 32: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/32.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
28 Chapter 11. 0.1.6 (2016-06-05)
![Page 33: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/33.jpg)
CHAPTER 12
0.1.5 (2016-29-04)
• Fixed a argparse bug
29
![Page 34: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/34.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
30 Chapter 12. 0.1.5 (2016-29-04)
![Page 35: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/35.jpg)
CHAPTER 13
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
31
![Page 36: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/36.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
32 Chapter 13. 0.1.4 (2016-29-04)
![Page 37: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/37.jpg)
CHAPTER 14
0.1.3 (2015-14-09)
• Disabled warnings for insecure requests to support older installations: https://urllib3.readthedocs.org/en/latest/security.html
33
![Page 38: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/38.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
34 Chapter 14. 0.1.3 (2015-14-09)
![Page 39: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/39.jpg)
CHAPTER 15
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.
35
![Page 40: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/40.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
36 Chapter 15. 0.1.2 (2015-14-09)
![Page 41: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/41.jpg)
CHAPTER 16
0.1.1 (2015-10-09)
• Support Python 2.7, 3.3, 3.4.
• Support PyPi.
• Included tests.
• Improved performance.
• Improved output and debugging.
37
![Page 42: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/42.jpg)
nagios𝑐ℎ𝑒𝑐𝑘𝑝𝑎𝑙𝑜𝑎𝑙𝑡𝑜𝐷𝑜𝑐𝑢𝑚𝑒𝑛𝑡𝑎𝑡𝑖𝑜𝑛,𝑅𝑒𝑙𝑒𝑎𝑠𝑒0.3.2
38 Chapter 16. 0.1.1 (2015-10-09)
![Page 43: nagios ℎ - Read the Docs · $ THERMAL OK - Temperature @ Ocelot is 29 degrees Celsius, Temperature @ Switch is 33 ... nagios_check_paloalto could always use more documentation,](https://reader031.fdocuments.in/reader031/viewer/2022022019/5b996a3309d3f29c338c427d/html5/thumbnails/43.jpg)
CHAPTER 17
Indices and tables
• genindex
• modindex
• search
39