Parámetros
Modo simple
| --urls | |
| --user | nombre del usuario si el |
| --password | contraseña si el |
| --ssl | para verificar si |
| --prefix | prefijo para los nombres de los módulos, opcional |
| --transfer_mode | |
| --tentacle_ip | |
| --tentacle_port | puerto del |
| --interval | intervalo de monitorización en segundos, opcional |
| --allow_list | expresión regular para incluir únicamente los módulos cuyo nombre coincida, opcional |
| --deny_list | expresión regular para excluir módulos cuyo nombre coincida, opcional |
| --monitor_frontends | monitorizar filas de tipo frontend (type=0), opcional |
| --monitor_backends | monitorizar filas de tipo backend (type=1), opcional |
| --monitor_servers | monitorizar filas de tipo server (type=2), opcional |
Modo avanzado
| --conf | ruta del archivo de configuración |
| --conf_targets | ruta del archivo con las URLs de HAProxy (obligatorio al usar --conf) |
Archivo de configuración (--conf)
urls= url del servidor de apache
agent_name= nombre del agente opcional
module_prefix= nombre de prefix para los modulos opcional
username= nombre del usuario si el servidorendpoint de apache loHAProxy requiere autenticación básica, opcional
password= contraseña si el servidorendpoint de apache loHAProxy requiere autenticación básica, opcional
verify_ssl= para verificar si quierela las urlURL tiene certicadocertificado httpsHTTPS o nono, opcional
prefix= prefijo para los nombres de los módulos, opcional
transfer_mode= nombre del modo de tranferenciatransferencia de datos (native o tentacle), opcional
tentacle_ip= ip del tentacletentacle, opcional
tentacle_port= puerto del tantacletentacle, opcional
agents_group= nombre del grupo de agentes al que se asignarán los agentes creados, opcional
agents_group_id= id del grupo de agentes al que se asignarán los agentes creados, opcional
interval= intervalo de monitorización en segundos, opcional
allow_list= expresión regular para incluir únicamente los módulos cuyo nombre coincida, opcional
deny_list= expresión regular para excluir módulos cuyo nombre coincida, opcional
monitor_frontends= monitorizar filas de tipo frontend (type=0), opcional
monitor_backends= monitorizar filas de tipo backend (type=1), opcional
monitor_servers= monitorizar filas de tipo server (type=2), opcional
Ejemplo
urls=https://192.168.0.1/example
agent_name=example
module_prefix=apache[CONF]
username=admin
password=12345
verify_ssl=true
prefix=haproxy_
transfer_mode=tentaclenative
tentacle_ip=127.0.0.1
tentacle_port=41121
interval=300
allow_list=
deny_list=.*_wredis|.*_wretr
monitor_frontends=true
monitor_backends=true
monitor_servers=true
Archivo de targets (--conf_targets):
http://192.168.0.10:8404/stats
http://192.168.0.11:8404/stats
Ejecución manual
El formato de la ejecución del plugin es el siguiente:
./pandora_haproxy --urls <urls del endpoint de HAProxy separadas por comas> --user <usuario> --password <contraseña> --ssl <true|false> --prefix <prefijo> --transfer_mode <native|tentacle> --tentacle_ip <ip del tentacle> --tentacle_port <puerto del tentacle> --interval <intervalo> --allow_list <regex> --deny_list <regex> --monitor_frontends <true|false> --monitor_backends <true|false> --monitor_servers <true|false> --conf <ruta al fichero de configuración> --conf_targets <ruta al fichero de URLs>
Ejemplos:
para ejecutar el modo simple
./pandora_haproxy --urls http://192.168.0.10:8404/stats,http://192.168.0.11:8404/stats --user admin --password 12345 --ssl false --transfer_mode native --tentacle_ip 127.0.0.1 --tentacle_port 41121
para ejecutar el modo avanzado
./pandora_haproxy --conf /etc/pandora/haproxy.conf --conf_targets /etc/pandora/haproxy_targets.conf
La ejecución devolverá una salida en formato JSON con información sobre la ejecución, y generará un fichero XML por cada agente monitorizado (en modo tentacle) que enviará al servidor de Pandora FMS por el método de transferencia indicado en la configuración. En modo native los datos se exponen en el campo monitoring_data del JSON de salida para que los consuma el servidor de Discovery.