app: bird2 set timeformat protocols (#15292)

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
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

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.
### SNMP Extend
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'
```
@ -406,12 +408,32 @@ extend bird2 '/usr/bin/sudo /usr/sbin/birdc -r show protocols all'
```
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`_
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.
## Certificate
A small python3 script that checks age and remaining validity of certificates