Commit Graph

520 Commits

Author SHA1 Message Date
Tony Murray
a1aaafa6ff Added ability to enable debug output with wrappers (#8830)
Now with optparse (python 2.3+)

Does not include your doc updates @laf 

If I get some time later, I'll add them, feel free to as well.

DO NOT DELETE THIS TEXT

#### Please note

> Please read this information carefully. You can run `./scripts/pre-commit.php` to check your code before submitting.

- [ ] Have you followed our [code guidelines?](http://docs.librenms.org/Developing/Code-Guidelines/)

#### Testers

If you would like to test this pull request then please run: `./scripts/github-apply <pr_id>`, i.e `./scripts/github-apply 5926`
2018-06-20 22:56:51 +01:00
Neil Lathwood
45f98872bb Revert "Ability to enable debug output with wrappers" (#8829)
Reverts librenms/librenms#8811
2018-06-16 14:32:28 +01:00
Tony Murray
fd77b23624 Added debug options to wrapper scripts to record output to logs/ dir (#8811)
* Ability to enable debug output with wrappers
Output is redirected to a per-device file in the log directory.

* Add warning

* Added some docs to help with debugging using this new option
2018-06-15 14:22:43 +01:00
Tony Murray
e736f5efec Updated YAML schema validation (#8808)
Changed some values to be explicitly boolean


DO NOT DELETE THIS TEXT

#### Please note

> Please read this information carefully. You can run `./scripts/pre-commit.php` to check your code before submitting.

- [x] Have you followed our [code guidelines?](http://docs.librenms.org/Developing/Code-Guidelines/)

#### Testers

If you would like to test this pull request then please run: `./scripts/github-apply <pr_id>`, i.e `./scripts/github-apply 5926`
2018-06-15 09:45:20 +01:00
mattie47
9ae1485a09 Added information on Rasbian snmpd setup for applications (#8813)
AS per https://community.librenms.org/t/raspbian-sudo-warnings/1880, raspbian does not use 'snmp' as the user for snmpd.

DO NOT DELETE THIS TEXT

#### Please note

> Please read this information carefully. You can run `./scripts/pre-commit.php` to check your code before submitting.

- [x] Have you followed our [code guidelines?](http://docs.librenms.org/Developing/Code-Guidelines/)

#### Testers

If you would like to test this pull request then please run: `./scripts/github-apply <pr_id>`, i.e `./scripts/github-apply 5926`
2018-06-13 21:23:27 +01:00
Neil Lathwood
08022aae7a api: Map LibreNMS OS' to known Oxidized models (#8758) 2018-05-24 22:08:44 -05:00
Scott Horsley
b6ed5751ec api: Allow more complete overrides on Oxidized output (#8633)
This patch provides the ability to override most aspects of the configuration output provided to Oxidized. This is now backwards compatible with any current groups defined previously but allows for extra features such as group overrides in Oxidized as well as IP changes (for hosts that are treated differently inside Oxidized), as well as ProxyHost additions. Of course, this goes further and allows for any flag that can be defined within Oxidized to be mapped in the config.

Examples

1) Define a group for these hosts
```php
$config['oxidized']['maps']['group']['sysname'][] = array('regex' => '/^(foo|bar)/', 'group' => 'myGroup');
$config['oxidized']['maps']['group']['sysname'][] = array('regex' => '/^(baz)/', 'group' => 'anotherGroup');
```
2) Provide a proxy host for these hosts to bounce through
```php
$config['oxidized']['maps']['ssh_proxy']['sysname'][] = array('regex' => '/foo/', 'ssh_proxy' => 'mySshProxyHost');
$config['oxidized']['maps']['ssh_proxy']['sysname'][] = array('regex' => '/bar/', 'ssh_proxy' => 'anotherSshProxyHost');
```
3) Allow overrides of IP addresses so the external DNS is not used for connections
```php
$config['oxidized']['maps']['ip']['sysname'][] = array('regex' => '/baz/', 'ip' => '10.10.0.23');
$config['oxidized']['maps']['ip']['sysname'][] = array('regex' => '/lala/', 'ip' => '192.168.0.243');
```
As already mentioned, this doesn't stop with the above examples.

DO NOT DELETE THIS TEXT

#### Please note

> Please read this information carefully. You can run `./scripts/pre-commit.php` to check your code before submitting.

- [x] Have you followed our [code guidelines?](http://docs.librenms.org/Developing/Code-Guidelines/)

#### Testers

If you would like to test this pull request then please run: `./scripts/github-apply <pr_id>`, i.e `./scripts/github-apply 5926`
2018-05-23 22:00:39 +01:00
TheGreatDoc
d8dd9c828e Update Weathermap.md (#8747)
Added prerquisite php pear
2018-05-23 21:55:08 +01:00
PipoCanaja
5c83d438c5 feature: Added plugin support in the Port page (#8665)
* Added new plugin menu_option in the "port" page, which contain hook calling public function port_container($device, $port) in plugins

* Cleaning after pre-commit error

* New method in Plugins.php to allow counting all plugins implementing a specific hook. This allow conditionnal display of the plugin menu_option in the port view.

* Typo after rebase

* Update plugins.inc.php

* Updating the documentation with device_overview_container and port_container hooks.
2018-05-22 08:11:27 +01:00
Tony Murray
99c74562a8 fix: Fixed hostname lookup for distributed poller on some platforms (#8727)
May cause warnings about poller not polling if the name doesn't match exactly as the old one.
Just delete from /pollers

DO NOT DELETE THIS TEXT

#### Please note

> Please read this information carefully. You can run `./scripts/pre-commit.php` to check your code before submitting.

- [x] Have you followed our [code guidelines?](http://docs.librenms.org/Developing/Code-Guidelines/)

#### Testers

If you would like to test this pull request then please run: `./scripts/github-apply <pr_id>`, i.e `./scripts/github-apply 5926`
2018-05-19 21:02:22 +01:00
Hans Erasmus
52544468b7 Fixed a few formatting problems on applications.md (#8716)
Some headers went "missing" in the previous PR, so fixed it now.
2018-05-15 07:37:11 -05:00
theherodied
a2e68f41dc docs: Updated MySQL application entry for clarification. (#8708)
* Updated MySQL entry.

Cleaned up MySQL entry. Had somewhat duplicated Agent entries that might cause confusion. One was before the snmp extend entry, and the other after. This might cause people to believe both are needed. I cleaned it up and merged the agent entries.

Added comment at top to clarify that only one detection method is needed.

* Fixed highlighting
2018-05-14 18:33:29 +01:00
Hans Erasmus
8ce423dd2d Expand the description of Application support (#8619)
* Expand the description of Application support

I was not aware that the applications can also be auto-discovered. I discovered it by chance, and when I mentioned it in discord channel, it seemed blatantly obvious to everyone else. Thought editing the docs might help future users.

* Update Applications.md

Changed a lot of instructions to make it more structured.

* Add files via upload

Addedimages to help with application extensions how-to.

* Update Applications.md

Added the file locations into master file.
2018-05-08 19:15:58 -05:00
VVelox
50935fff33 update docs to reflect SMART monitoring having the ability to use either device name or disk serial number (#8522)
* update to reflect changes to the SMART SNMP extend

* minor grammatical change

* update to reflect the default of SN and expand info on that all a bit
2018-04-27 22:49:30 +01:00
Hans Erasmus
0609d6eae0 Update Applications.md (#8617) 2018-04-25 21:01:02 +01:00
Hans Erasmus
5675964bab Clarify unbound extend OR agent (#8609)
* Update Applications.md

The snmp-extend method should really be advocated as the preferred method, as it is the easiest and quickest.

* Update Applications.md

* Update Applications.md

Is this what you meant?
2018-04-24 20:32:30 -05:00
Sander Steffann
65b8270936 feature: Added random entropy support for applications (#8555) 2018-04-13 17:42:14 +01:00
cchance27
09d6b2fd54 feature: Added Prometheus PushGateway metric support (#8437)
* Added Prometheus PushGateway support

* fixed formatting

* fix set_curl_proxy to correct variable

* add documentation

* Update Metric-Storage.md

* Update mkdocs.yml
2018-04-13 15:46:19 +01:00
Atroskelis
6a26ac6dac docs: Updated Oxidized.md to show use of arrays (#8547)
Wanted to clarify how the array in ignore_types and ignore_os works cause i personally was dense and added multiple lines which overwrote themselves.
2018-04-11 09:24:18 +01:00
Serphentas
bc5b0f84cc docs: Added doc for linux zfs application setup (#8546) 2018-04-11 09:15:04 +01:00
Wheel
c7827b6652 docs: Updated Graylog.md for 2.4 version (#8517)
* Update Graylog.md

Updatet to current version of graylog. And default ports

* Update Graylog.md
2018-04-09 20:51:28 +01:00
Wheel
d755b8c55e Update RRDCached.md (#8495) 2018-04-01 21:25:53 +01:00
Tony Murray
5c83aa1e28 refactor: LDAP debug output (#8434)
* LDAP debug
Updated LDAP and AD docs
ldap protocol default to v3 (so we don't have to set it all the time).  If this fails it should revert to v2.
ad was using auth_ad_timeout incorrectly (1 I think)

* Add option to list all users.
2018-03-29 11:40:27 +01:00
Wheel
3fb7f76aea docs: Update World-Map doc with examples (#8488) 2018-03-29 11:37:51 +01:00
Wheel
1b4e7b3680 docs: Debian stretch RRDcached settings (#8470)
* Debian stretch settings

* Update RRDCached.md

* Update RRDCached.md
2018-03-26 20:09:38 +01:00
Slashdoom
308d43f07a docs App doc fix (#8448)
* small fixes to apps doc

* small fixes to apps doc
2018-03-22 08:33:28 +00:00
Dag Bakke
69bedd0101 docs: Added info about client config options for suppressing/enabling FQDN info in syslogmsgs (#8396)
* Update Graylog.md

* Added some hints for configuring some syslog clients.
2018-03-15 21:46:50 +00:00
Kevin Krumm
c27c28f584 docs: fixed WeatherMapper style (#8395)
Helps with finding it.
2018-03-15 14:11:23 -05:00
Dag Bakke
4c0dc5c37b Update Applications.md (#8369)
Added a hint about removing /tmp/apache-snmp if the apache-stats.py script has been run manually. If run as root, it leaves behind a file which the user running snmpd cannot overwrite. Causing snmpd to not produce apache stats.
2018-03-13 20:12:02 +00:00
BlackDex
25b96c1ab3 Fixed markdown/layout of the examples (#8365) 2018-03-13 11:17:30 +00:00
Arzhel Younsi
7eda8d9989 feature: Added a irc_alert_short option to only send the alert title (#8312)
* Add a irc_alert_short option to only send the alert title

* Add doc for 'irc_alert_short'
2018-03-02 17:52:47 +00:00
BlackDex
5af51fa46f webui: Added auto width and height dimensions parameters to generic image dashboard widget (#8314)
Added the ability to substituted special parameters for width and height of the Generic-image widget to be added to an Image URL.
2018-03-01 22:12:46 +00:00
theherodied
6370b2931c docs: RRDCached-Security clearify security (#8302)
Clarify that additional security is only needed if you use a network socket instead of a unix socket. This might reduce confusion since the default directions on https://docs.librenms.org/#Extensions/RRDCached/ only setup unix sockets so no further steps are needed.

Source information found at: https://oss.oetiker.ch/rrdtool/doc/rrdcached.en.html#SECURITY_CONSIDERATIONS
2018-02-27 15:42:16 +00:00
Rémy Jacquin
8d4fca33b1 webui: Devices in maintenance show as blue on worldmap widget (#8207)
* Added new worldmap widget setting:
The user can chose how down devices under maintenance are shown
Signed-off-by: Rémy Jacquin <remy@remyj.fr>

* Added documentation related to this feature

Signed-off-by: Rémy Jacquin <remy@remyj.fr>

* Change icon to light blue and remove option
Reverted "Added new worldmap widget setting"
Signed-off-by: Rémy Jacquin <remy@remyj.fr>
2018-02-18 20:43:24 +00:00
Tom Sealey
63cc936f60 docs: Created Gateone 3rd party integration doc (#8229)
* Create Gateone.md

Doc for Gateone integration.
Credit to davama who wrote most of this.

f6a7e5973f

* Update Gateone.md

* Update mkdocs.yml

added gateone.md
2018-02-10 20:52:26 +00:00
Kevin Krumm
a4bc98e555 docs: update Dashbaord iframe (#8232)
updated doc with iframe using info from #PR8219
2018-02-08 10:32:01 -06:00
Kevin Krumm
a7fe7191ae docs: Fix for syslog-ng config in the docs (#8160)
* fix for syslog-ng config

I guess it didn't copy over correctly the last fix. It was reported to not be working I tested this and seems to be okay now at the time. It was showing 00:00 00 0000

* Update Syslog.md
2018-01-29 20:56:04 +00:00
Lutz Willek
881e0fe4c1 docs: Changed check_mk service from xinetd to systemd (#8101)
* changed check_mk service from xinetd to systemd

* added xinetd section
2018-01-26 20:51:45 +00:00
Kevin Krumm
ddc40fcea2 docs: fix syslog-ng config (#8136)
reported by jaager on discord.
2018-01-23 07:43:18 -06:00
barciella
afc6137146 Fixed documentation. This way autodiscovery with snmpv3 works (#8091) 2018-01-16 12:21:44 -06:00
Neil Lathwood
d26d142700 webui: Added Oxidized config validator (#7983)
* webui: Added Oxidized config validator

* final updates

* small changes like box height + indicate config is valid

* docs + small changes
2018-01-11 07:21:05 -06:00
Zmegolaz
eac128aca8 Fix: Override -H for check_load service. Fixed backslash escaping. (#8020)
* Added check_load.inc.php.

* Combined load graphs. Removed extra backslashes from all graphs. Escaped backslash in mysql file.

* Added a note about local only service checks to the docs.
2018-01-08 09:35:15 +01:00
crcro
c21e9c2f4a feature: Added powerdns dnsdist application (#7987)
* powerdns dnsdist app support

* fix conflict

* added doc

* fix new lines

* alphabetic order

* no data manipulation on host side
changed rrd from gauge to counter
2018-01-06 20:05:06 +00:00
Kevin Krumm
f82f6601a8 docs: Show importance attaching services to a device (#8026)
in librenms. Otherwise alerting on service it won't work. :)
2018-01-04 22:18:15 +00:00
Kevin Krumm
61f6f59ed3 docs: fix syslog-ng config (#7990)
syslog-ng config was reported to be having issues. Updated config.
2017-12-31 10:03:10 -06:00
VVelox
eaf70e96f6 feature: Added ZFS support for FreeBSD (#7938)
* add the ZFS graphs

* And now the ZFS non-graph stuff.

Still need to move it over to using JSON.

* Now uses JSON.

* use stripslashes as SNMPD loves to slash up the JSON

* Document ZFS.

* very minor formatting cleanup

* minor formatting cleanup and remove a bit of code from when I was mucking around debugging it all
2017-12-30 11:42:51 +00:00
VVelox
0e13e77c5f refactor: Fail2ban polling update and dropping of the FW checking (#7936)
* Update polling and drop the firewalled bit.

Since fail2ban on FreeBSD has moved to using anchors, the previous
issue of it dreking all over its self is no longer a problem.

And AFAIK it has never been an issue on Linux.

This also makes this script more cross platform as well instead.

* change the name of the graph of the total banned so people don't have to remove old file

* go back to the original RRD and just shove U into the no longer data area
2017-12-30 11:39:20 +00:00
Kevin Krumm
7b0c0c8ca7 docs: added new widgets to dashboard doc. (#7948)
* docs: added new widgets to dashboard doc. 

Storage Widget.
Server Stats Widget.

* Update Dashboards.md

* Update Dashboards.md
2017-12-23 13:30:33 -06:00
Kevin Krumm
1e0d7d8b07 docs: example address for the world map doc (#7947)
* docs: example address for the world map doc

* Update World-Map.md
2017-12-23 13:21:01 -06:00
Tony Murray
00f2abfad4 Stronger wording for MIB-based-polling doc (#7905) 2017-12-13 22:37:02 +00:00