mirror/librenms-librenms
1
0
Fork 0
mirror of https://github.com/librenms/librenms.git synced 2024-10-07 16:52:45 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

app: bird2 set timeformat protocols (#15292)

Browse Source 
By default "iso show ms" is used. Which is not compatible
with the timeformat parsing used. Add a note to the doc
specifying it is important to set the timeformat used
in the timeformat protocol output.
This commit is contained in:
ch
2023-09-24 22:11:08 +02:00
committed by GitHub
parent 5c9f3c80e5
commit 292a37523c
1 changed files with 24 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
doc/Extensions/Applications.md
View File

@@ -396,7 +396,9 @@ Due to the lack of SNMP support in the BIRD daemon, this application extracts al
This application supports both IPv4 and IPv6 Peer processing. This application supports both IPv4 and IPv6 Peer processing.
### SNMP Extend ### SNMP Extend
1. Edit your snmpd.conf file (usually /etc/snmp/snmpd.conf) and add: 1. Edit your snmpd.conf file (usually /etc/snmp/snmpd.conf) and add:
``` ```
extend bird2 '/usr/bin/sudo /usr/sbin/birdc -r show protocols all' extend bird2 '/usr/bin/sudo /usr/sbin/birdc -r show protocols all'
``` ```
@@ -406,12 +408,32 @@ extend bird2 '/usr/bin/sudo /usr/sbin/birdc -r show protocols all'
``` ```
Debian-snmp ALL=(ALL) NOPASSWD: /usr/sbin/birdc Debian-snmp ALL=(ALL) NOPASSWD: /usr/sbin/birdc
``` ```
_If your snmp daemon is running on a user that isnt `Debian-snmp` make sure that user has the correct permission to execute `birdc`_ _If your snmp daemon is running on a user that isnt `Debian-snmp` make sure that user has the correct permission to execute `birdc`_
3. Restart snmpd on your host
3. Verify the time format for bird2 is defined. Otherwise `iso short
ms` (hh:mm:ss) is the default value that will be used. Which is not
compatible with the datetime parsing logic used to parse the output
from the bird show command. `timeformat protocol` is the one
important to be defibned for the bird2 app parsing logic to work.
Example starting point using Bird2 shorthand `iso long` (YYYY-MM-DD hh:mm:ss):
```
timeformat base iso long;
timeformat log iso long;
timeformat protocol iso long;
timeformat route iso long;
```
*Timezone can be manually specified, example "%F %T %z" (YYYY-MM-DD
hh:mm:ss +11:45). See the [Bird
2 docs](https://bird.network.cz/?get_doc&v=20&f=bird-3.html) for more information*
4. Restart snmpd on your host
The application should be auto-discovered as described at the top of the page. If it is not, please follow the steps set out under `SNMP Extend` heading top of page. The application should be auto-discovered as described at the top of the page. If it is not, please follow the steps set out under `SNMP Extend` heading top of page.
## Certificate ## Certificate
A small python3 script that checks age and remaining validity of certificates A small python3 script that checks age and remaining validity of certificates