--- title: Integración de sistemas de monitorización externos url: https://doc.pstreamer.tv/es/manual/monitoring.html lang: es product: Perfect Streamer version: 1.13.3.445 --- # Integración de sistemas de monitorización externos *pss-metrics* — exportador universal de métricas para Perfect Streamer Un único script CLI en Python 3 que obtiene estadísticas de la API HTTP del servidor web de PSS y produce salida para los sistemas de monitorización más comunes: > - Zabbix (UserParameter, Low-Level Discovery, zabbix_sender trapper) > - Prometheus (formato de exposición de texto para el textfile collector) > - InfluxDB / Telegraf (line protocol o JSON para el input exec) > - JSON universal para scripts arbitrarios y comprobaciones de estado tipo Nagios El exportador es un único archivo autocontenido sin dependencias de terceros y utiliza solamente la biblioteca estándar de Python 3.6+ (*urllib*, *xml.etree*, *json*, *argparse*). ## Archivos ``` pss-metrics.py main CLI (executable) userparameter_pss.conf.example UserParameter template for Zabbix ``` ## Instalación El exportador se entrega en */opt/pss/monitoring/pss-metrics.py*. Asegúrese de tener instalado Python 3.6 o posterior: ``` # RHEL / Rocky / AlmaLinux yum install -y python3 # Debian / Ubuntu apt-get install -y python3 ``` No se requieren paquetes adicionales. ## Configuración Por defecto, *pss-metrics* se conecta a *http://127.0.0.1:43971* y detecta automáticamente el puerto desde */opt/pss/config/pss.json* (o */opt/pss/config/pss_default.json*). Los parámetros se pueden sobrescribir mediante variables de entorno, el archivo */etc/pss-metrics.conf* (formato *clave=valor*) o banderas de línea de comandos. Prioridad: CLI > env > archivo > valores por defecto. Variables admitidas: ``` PSS_URL full URL, e.g. http://10.0.0.1:43971 (auto by default) PSS_USER web server login (if authorization is enabled) PSS_PASS web server password PSS_TIMEOUT HTTP timeout, in seconds (default 5) PSS_CACHE_DIR cache directory (default /run/pss-metrics) PSS_CACHE_TTL cache TTL, in seconds (default 10) PSS_CA_BUNDLE path to CA bundle for HTTPS PSS_INSECURE 1 — disable TLS certificate verification PSS_VERBOSE 1 — log requests to stderr ``` Caché: cada ejecución realiza como mucho un HTTP GET por endpoint dentro de la ventana TTL. Con TTL=10 s incluso cientos de comprobaciones de UserParameter por minuto resultan en ~6 peticiones HTTP por minuto a PSS. ## Inicio rápido Comprobación de estado (códigos de salida estilo Nagios): ``` pss-metrics.py health # OK: total=42 running=15 stopped=27 unhealthy=0 version=1.12.2.430d ``` Descubrimiento LLD de Zabbix: ``` pss-metrics.py discover streams pss-metrics.py discover inputs --running-only pss-metrics.py discover outputs ``` Obtención de una sola métrica (para usar en UserParameter de Zabbix): ``` pss-metrics.py get summary.running pss-metrics.py get stream.10031.bitrate pss-metrics.py get input.10031.1.speed1 pss-metrics.py get output.10031.1.speed pss-metrics.py get sysmon.cpu.self-usage pss-metrics.py get server.server-version ``` Exportación completa: ``` pss-metrics.py dump --format=json pss-metrics.py dump --format=prometheus pss-metrics.py dump --format=influx pss-metrics.py dump --format=zabbix-trapper --zabbix-host=streamer-01 ``` ## Rutas de métricas *pss-metrics get* acepta una ruta separada por puntos. Una salida vacía significa «valor ausente» (por ejemplo, la métrica solo existe para flujos en ejecución). ``` server. e.g. server.server-version, server.uptime summary. total | running | stopped | unhealthy | input_bitrate_kbps | output_bitrate_kbps sysmon.cpu. self-usage | total-usage | cores sysmon.memory. self-usage-kb | available-kb | total-kb sysmon.netbw.. rx-bw | tx-bw (interface name as in XML) stream.. any attribute input... any attribute output... any attribute ``` Atributos útiles por flujo (de /data/stream/detail): ``` stream: state, state-str, bitrate, thread-usage, mpts input: speed1, recv-bytes, recv-packets, recv-err, stat-disc, stat-disc1, stat-scrambled, stat-scrambled1, health-state-good, health-status, check-status output: speed, sent-bytes, sent-packets, sent-err, uri, type ``` ## Integración con Zabbix Se admiten dos escenarios: elija el que se adapte a su entorno. 1. UserParameter estático + LLD (agente Zabbix v1 / v2) Copie *userparameter_pss.conf.example* a */etc/zabbix/zabbix_agentd.d/pss.conf*, reinicie *zabbix-agent* e importe en el servidor una plantilla con prototipos LLD que usen las claves *pss.discover*. Ejemplos de asignaciones: ``` UserParameter=pss.discover[*],/opt/pss/monitoring/pss-metrics.py discover $1 UserParameter=pss.get[*],/opt/pss/monitoring/pss-metrics.py get $1 UserParameter=pss.health,/opt/pss/monitoring/pss-metrics.py health ``` En el servidor Zabbix: ``` Discovery rule key: pss.discover[streams] Item prototype keys: pss.get[input.{#STREAM_ID}.1.speed1] pss.get[stream.{#STREAM_ID}.bitrate] pss.get[summary.unhealthy] ``` 2. Trapper (push) mediante zabbix_sender Ejecútelo por temporizador (cron / systemd) y canalice la salida: ``` /opt/pss/monitoring/pss-metrics.py dump --format=zabbix-trapper \ --zabbix-host="$(hostname)" \ | zabbix_sender -z zabbix.example.com -i - ``` ## Integración con Prometheus Dos opciones. 1. Textfile collector (recomendado para entornos one-shot). Ejecute una exportación periódica mediante systemd-timer o cron: ``` */1 * * * * /opt/pss/monitoring/pss-metrics.py dump --format=prometheus \ > /var/lib/node_exporter/textfile_collector/pss.prom.$$ \ && mv /var/lib/node_exporter/textfile_collector/pss.prom.$$ \ /var/lib/node_exporter/textfile_collector/pss.prom ``` *node_exporter* servirá el archivo mediante *–collector.textfile.directory*. 2. Scrape directo mediante un pequeño wrapper (por ejemplo *socat* + *pss-metrics dump*) o cualquier proxy HTTP de terceros que prefiera. ## Integración con Telegraf / InfluxDB Telegraf *inputs.exec*: ``` [[inputs.exec]] commands = ["/opt/pss/monitoring/pss-metrics.py dump --format=influx"] interval = "10s" timeout = "5s" data_format = "influx" ``` Para el parser JSON, utilice *–format=json* y configure *data_format = «json»* con las rutas de los campos. ## HTTPS y autenticación Si el servidor web de PSS opera detrás de HTTPS o está protegido con contraseña: ``` PSS_URL=https://streamer.example.com:8443 \ PSS_USER=monitor PSS_PASS=secret \ pss-metrics.py health ``` Certificados autofirmados: establezca *PSS_INSECURE=1* (no recomendado) o indique *PSS_CA_BUNDLE=/path/to/ca.pem*. ## Códigos de salida *pss-metrics* sigue la convención de Nagios: ``` 0 OK 1 WARNING (e.g. running streams report unhealthy) 2 CRITICAL (PSS is unreachable) 3 UNKNOWN (invalid arguments / internal error) ``` *get* y *dump* muestran una cadena vacía y terminan con código 0 cuando la entidad solicitada no existe — esto se corresponde con la expectativa de Zabbix de que un valor vacío se interpreta como «NOT_SUPPORTED» en lugar de como un fallo del agente. ## Diagnóstico ```bash pss-metrics.py -v health # log every HTTP request to stderr pss-metrics.py --cache-ttl=0 … # bypass cache while debugging rm -rf /run/pss-metrics # purge cache ```