Agentes y módulos generados por el plugin

El plugin creará un agente principal por cada objetivo PostgreSQL definido. Ese agente contendrá los siguientes módulos según la configuración activada.

El módulo POSTGRESQL connection se generará siempre, independientemente de los tokens activados, y reflejará la disponibilidad general de la instancia.

POSTGRESQL connection

**Disponibilidad de la instancia PostgreSQL.** Será 1 si se ha podido establecer la conexión con la instancia y 0 en caso contrario.

Si está activado engine_uptime:

restart detection

**Será 0 si se ha detectado un reinicio inesperado, y 1 en caso contrario.** Permite detectar reinicios inesperados del servicio PostgreSQL que puedan afectar a la disponibilidad de la base de datos o provocar interrupciones en el servicio.

Si está activado query_stats:

queries	**Número de consultas activas.** Permite conocer la carga actual de consultas activas sobre la instancia PostgreSQL.
insert	**Número de consultas INSERT activas.** Permite evaluar la actividad de inserción de datos y detectar posibles cargas elevadas de escritura.
delete	**Número de consultas DELETE activas.** Permite detectar operaciones de eliminación que puedan afectar al rendimiento.
update	**Número de consultas UPDATE activas.** Permite monitorizar operaciones de modificación de datos en curso.

Si está activado analyze_connections:

session usage

**Porcentaje de uso de conexiones respecto al máximo configurado.** Permite controlar el consumo de conexiones disponibles y detectar situaciones de saturación.

Si está activado cache_stats:

allocated buffer cache	**Total de buffers compartidos asignados.** Representa la memoria reservada por PostgreSQL para caché de datos.
backend used buffer cache	**Buffers utilizados por procesos backend.** Permite evaluar el uso de caché por procesos activos.
checkpoints buffer cache	**Buffers escritos por checkpoints.** Ayuda a analizar actividad de sincronización de datos a disco.
cleaned buffer cache	**Buffers limpiados por el proceso writer.** Permite evaluar actividad de limpieza de buffers.

Si está activado fragmentation_ratio:

fragmentation ratio

**Ratio medio estimado de fragmentación.** Un ratio elevado puede indicar desperdicio de espacio o degradación del rendimiento.

Si está activado scan_databases, el plugin descubrirá las bases de datos del objetivo PostgreSQL.

El módulo connection se generará siempre para cada base de datos descubierta.

Si está activado agent_per_database, se creará un agente independiente por cada base de datos descubierta. En caso contrario, los módulos se generarán en el agente principal utilizando el prefijo correspondiente al nombre de la base de datos.

Si está activado Storage statistics:

database size	**Tamaño total de la base de datos.** Permite controlar el crecimiento general del almacenamiento.
tables size	**Tamaño total ocupado por las tablas.** Permite analizar el espacio consumido por datos.
indexes size	**Tamaño total ocupado por índices.** Ayuda a detectar crecimiento excesivo de estructuras de indexación.
temp bytes	**Datos temporales escritos en disco.** Puede indicar operaciones pesadas de ordenación o procesamiento temporal.
temp files	**Ficheros temporales creados.** Ayuda a detectar carga elevada de operaciones temporales.

Si está activado Query performance:

long queries	**Consultas activas de larga duración.** Permite detectar consultas lentas o potencialmente problemáticas.
oldest query age	**Tiempo de ejecución de la consulta activa más antigua.** Útil para identificar bloqueos o procesos prolongados.
sequential scans	**Número de escaneos secuenciales.** Un valor elevado puede indicar falta de índices adecuados.
index scans	**Número de escaneos mediante índices.** Permite evaluar el uso eficiente de índices.
cache hit ratio	**Ratio de aciertos de caché.** Permite evaluar eficiencia del acceso a datos en memoria.

Si está activado Connections statistics:

active connections	**Número de conexiones activas.** Refleja actividad real de usuarios o procesos.
idle connections	**Número de conexiones inactivas.** Permite detectar sesiones abiertas sin actividad.
total connections	**Número total de conexiones.** Control global de consumo de conexiones por base de datos.

Si está activado Transaction statistics:

transactions	**Total de transacciones ejecutadas.** Refleja actividad transaccional general.
commits	**Transacciones confirmadas.** Indica operaciones completadas correctamente.
rollbacks	**Transacciones revertidas.** Puede indicar errores o cancelaciones.
rollback ratio	**Ratio de rollbacks.** Ayuda a detectar comportamientos anómalos.
deadlocks	**Deadlocks detectados.** Permite identificar conflictos de bloqueo.
conflicts	**Conflictos detectados.** Útil para evaluar concurrencia problemática.

Si está activado Table statistics:

table count	**Número de tablas de usuario.** Inventario estructural de la base de datos.
index count	**Número de índices de usuario.** Control de estructuras auxiliares.
live tuples	**Registros activos estimados.** Refleja volumen útil de datos.
dead tuples	**Registros obsoletos estimados.** Ayuda a detectar necesidad de VACUUM.
fragmentation ratio	**Fragmentación estimada de tablas.** Control del estado estructural de almacenamiento.

Si está activado Advanced performance:

blocks read	**Bloques leídos desde disco.** Permite medir acceso físico a almacenamiento.
blocks hit	**Bloques obtenidos desde caché.** Permite medir eficiencia del uso de memoria.

El plugin también creará un módulo por cada consulta personalizada definida en el fichero de configuración. Las consultas con target_scope=instances se asignarán al agente principal de la instancia y las que tengan target_scope=databases se asignarán a los agentes de las bases de datos correspondientes.

En versiones PostgreSQL 17 y superiores, los módulos "backend used buffer cache", "checkpoints buffer cache" y "cleaned buffer cache" no están disponibles.