Oracle

Este documento describe la funcionalidad Oracle del discovery de PandoraFMS.

Introducción

Este plugin tiene como finalidad monitorizar bases de datos Oracle, mediante consultas que extraerán información sobre datos que son claves para conocer el rendimiento y estado de la bases de datos, como son el número de conexiones, número de consultas , estado de los reinicios, ratio de fragmentación y cache. Estos datos se verán reflejados en PandoraFMS, en módulos que aportaran el valor estadístico, dentro de un agente que representará a cada base de datos.

Este plugin está desarrollado para usarse con Pandora FMS Discovery, por lo que a diferencia de otros plugins no genera agentes por XML, si no que todo lo descubierto se devuelve en la salida JSON del plugin.

Prerrequisitos

Este plugin realiza conexiones remotas a las bases de datos a monitorizar, por lo que es necesario asegurar la conectividad entre el servidor de Pandora FMS y dichas bases de datos.

Parámetros y configuración

Parámetros

--conf Ruta al archivo de configuración
--target_databases Ruta al archivo de configuración que contiene los targets de las bases de datos
--target_agents Ruta al archivo de configuración que contiene los targets de los agentes
--custom_queries Ruta al archivo de configuración que contiene las consultas personalizadas


Archivo de configuración (--conf)

agents_group_id = < ID del grupo en el que se crearán los agentes >
interval = < Intervalo de monitorización de los agentes en segundos >
user = < Usuario de conexión >
password = < Contraseña >
threads = < Número de hilos que se usaran para la creación de agentes >
modules_prefix = < Prefijo de módulos >
execute_custom_queries = < Activar con 1 para habilitar el uso de consultas personalizadas >
analyze_connections = < Activar con 1 para habilitar la monitorización de conexiones >
engine_uptime = < Activar con 1 para habilitar la monitorización del tiempo en ejecución >
query_stats = < Activar con 1 para habilitar la moitorización de estadísticas de consultas >
check_tablespaces = < Activar con 1 para habilitar la monitorización de estadísticas de tablespaces >
fragmentation_ratio = < Activar con 1 para habilitar la monitorización de estadísticas de ratio de fragmentación >
cache_stats = < Activar con 1 para habilitar la monitorización de estadísticas de cache >
thick_mode = < Activar con 1 para habilitar la conexión en thick mode >
client_path = < Ruta del cliente. Sólo necesario en caso de utilizar el thick mode >

Ejemplo

agents_group_id = 10
interval = 300
user = sa 
password = HHgD85V@
threads = 1
modules_prefix = 
execute_custom_queries = 1
analyze_connections = 1
engine_uptime = 1
query_stats = 1
check_tablespaces = 1
fragmentation_ratio = 1
cache_stats = 1
thick_mode = 1
client_path = /usr/lib/oracle/21/client64/lib/

La instalacion estandar de instant client 19.8 se hace  en la ruta /usr/lib/oracle/19.8/client64/lib

Listado de bases de datos objetivo (--target_databases)

El contenido del fichero será un listado de bases de datos objetivo, separando cada base de datos por comas o por líneas. El formato para una base de datos podrá ser cualquiera de los siguientes:

ip/sid
ip:puerto/sid 
ip:puerto/service_name

En caso de no indicarse el puerto, se usará el puerto 1521 TCP por defecto para la conexión al objetivo.

Ejemplo

172.17.0.3:1521/FREEPDB1

Listado de agentes objetivo (--target_agents)

El contenido del fichero será un listado de bases de nombres de agentes, separando cada agente por comas o por líneas. Estos nombres de agentes se usarán para volcar la información de cada base de datos objetivo en el nombre de agente indicado correspondiente, en lugar de dejar que el plugin genere los nombres de agentes de forma automática.

La posición de cada nombre de agente en el listado debe coincidir con la posición de la base de datos objetivo en su propio listado, es decir, el nombre para la primera base de datos objetivo será el primer nombre de este listado, teniendo en cuenta que las líneas en blanco son ignoradas.

Ejemplo

agente1,,agente3
agente4
agente5,agente6,agente7,,agente9

Consultas personalizadas (--custom_queries)

Se debe introducir un módulo por cada consulta personalizada que se pretenda monitorizar. Los módulos deben seguir una estructura, que es la siguiente:

check_begin      --> Etiqueta de abertura del módulo
name             --> Nombre del módulo
description      --> Descripción del módulo.
operation        --> Tipo de operación 
datatype         --> Tipo de módulo
min_warning      --> Configuración del umbral mínimo de warning
max_warning      --> Configuración del umbral máximo de warning
str_warning      --> Configuración de string de warning
warning_inverse  --> Activar el intervalo inverso con 1 para umbral de warning
min_critical     --> Configuración del umbral mínimo de critical
max_critical     --> Configuración del umbral máximo de critical
str_critical     --> Configuración de string de critical
critical_inverse --> Activar el intervalo inverso con 1 para umbral de crítico
module_interval  --> Este intervalo se calcula como un multiplicador del intervalo del agente. 
target           --> Consulta personalizada
target_databases --> Agentes de bases de datos en los que se creará el módulo
check_end        --> Etiqueta de cierre del módulo

Ejemplo

check_begin
name Select 1
description Number of invalid objects
operation value
datatype generic_data
min_warning 5
target SELECT 1 FROM dual
target_databases all
check_end

check_begin
name NumeroConexiones
description Number of connections
operation value
datatype generic_data
min_warning 5
target SELECT COUNT(*) AS NumeroConexiones FROM v$session;
target_databases pandora
check_end

check_begin
name NumeroRegistros.files_table
description Invalid objects (detail)
operation full
datatype generic_data
target SELECT COUNT(*) AS NumeroRegistros FROM files;
target_databases pandora
check_end

Ejecución manual

El formato de la ejecución del plugin es el siguiente:

./pandora_oracle \
--conf < ruta al fichero de configuración > \
--target_databases < ruta al fichero de configuración que contiene las bases de datos objetivo > \
[ --target_agents < ruta al fichero de configuración de agentes > ] \
[ --custom_queries < ruta al fichero de configuración que contiene las consultas personalizas > ]

Por ejemplo:

./pandora_oracle \
--conf /usr/share/pandora_server/util/plugin/oracle.conf \
--target_databases /usr/share/pandora_server/util/plugin/targets.conf \
--target_agents /usr/share/pandora_server/util/plugin/target_agents.conf \
--custom_queries /usr/share/pandora_server/util/plugin/custom_queries.conf

 

Discovery

Este plugin puede integrarse con el Discovery de Pandora FMS.

Para ello se debe cargar el paquete ".disco" que puede descargar desde la librería de Pandora FMS:

https://pandorafms.com/library/ 

image-1687944670019.png

Una vez cargado, se podrán monitorizar entornos de Oracle creando tareas de Discovery desde la sección Management > Discovery > Applications.

image-1687944766442.png

Para cada tarea se solicitarán los siguientes datos mínimos:

image.png

También se podrá ajustar la configuración de la tarea para personalizar la monitorización deseada:

image-1684831045318.png

Las tareas que se completen exitosamente dispondrán de un sumario de ejecución con la siguiente información:

image-1684831085871.png


Las tareas que no se completen exitosamente dispondrán de un sumario de ejecución registrando los errores producidos.

Agentes y módulos generados por el plugin

El plugin creará un agente por cada base de datos objetivo. Ese agente contendrá los siguientes módulos

Si esta activado engine_uptime:

restart_detection Será 0 si se ha detectado un reinicio inesperado, y 1 de no ser este el caso.  Cuando un servidor se reinicia inesperadamente, puede haber una interrupción en el acceso a la base de datos y potencialmente se pueden perder transacciones o datos no guardados correctamente.

 

Si esta activado query_stats:

queries: select Número de consultas SELECT. Las consultas SELECT se utilizan para recuperar datos de la base de datos. Monitorizar las consultas SELECT te permite evaluar la eficiencia de las consultas y la optimización de los índices. Al identificar consultas SELECT lentas o ineficientes, puedes tomar medidas para mejorar su rendimiento, como añadir índices adecuados, optimizar las consultas o ajustar la configuración del servidor.
queriers: update Número de consultas UPDATE. Las consultas UPDATE se utilizan para modificar los datos existentes en la base de datos. Monitorizar las consultas UPDATE es importante para evaluar la frecuencia y la eficiencia de las actualizaciones de datos. Puedes identificar consultas UPDATE que afectan a un gran número de filas o que tienen un impacto significativo en el rendimiento del servidor. Esto te permite optimizar las consultas, revisar la estructura de las tablas o tomar medidas para reducir la carga generada por las actualizaciones.

queries: delete

Número de consultas DELETE. Las consultas DELETE se utilizan para eliminar datos de la base de datos. Monitorizar las consultas DELETE es útil para evaluar la frecuencia y la eficiencia de las eliminaciones de datos. Puedes identificar consultas DELETE que afectan a un gran número de filas o que tienen un impacto significativo en el rendimiento del servidor. Esto te permite optimizar las consultas, revisar la estructura de las tablas o tomar medidas para reducir la carga generada por las eliminaciones.
queries: insert Número de consultas INSERT. Las consultas INSERT se utilizan para insertar nuevos datos en la base de datos. Monitorizar las consultas INSERT te permite evaluar la frecuencia y la eficiencia de las inserciones de datos. Puedes identificar consultas INSERT que están generando una alta carga en el servidor o que podrían estar causando problemas de rendimiento. Esto te permite optimizar las consultas, revisar la estructura de las tablas o considerar estrategias de inserción diferida para mejorar el rendimiento en entornos de alta concurrencia.

 

Si esta activado analyze_connections:

session usage Número de conexiones actuales respecto al total de conexiones máximas.  La monitorización del uso de sesiones en SQL Server es importante para optimizar el rendimiento, identificar problemas de bloqueo, mejorar la seguridad y auditoría, y planificar eficientemente los recursos del servidor.

 

Si esta activado cache_stats:

 

cache hit ratio (dictionary) El ratio de cache del diccionario. El "Cache Hit Ratio (Dictionary)" se refiere a la proporción de solicitudes de acceso a los datos del diccionario de Oracle que se resuelven utilizando datos almacenados en la caché en comparación con las solicitudes que requieren acceso al disco. El diccionario de Oracle contiene información sobre la estructura de la base de datos, los objetos, los metadatos y otros detalles importantes. Un alto ratio de aciertos (hit ratio) indica que la mayoría de las solicitudes de acceso al diccionario se resuelven utilizando datos en la caché, lo que mejora el rendimiento del sistema al evitar acceso al disco.
cache hit ratio (library) El ratio de cache de la librería. El "Cache Hit Ratio (Library)" se refiere a la proporción de solicitudes de acceso a los procedimientos, funciones y paquetes de Oracle almacenados en la caché de la biblioteca compartida. La caché de la biblioteca compartida almacena el código compilado de los programas y consultas SQL ejecutadas con frecuencia. Un alto ratio de aciertos indica que la mayoría de las solicitudes se resuelven utilizando código almacenado en la caché, lo que evita la necesidad de recompilar y mejora el rendimiento al reducir el tiempo de ejecución.
cache hit ratio (buffer) El ratio de cache del buffer. El "Cache Hit Ratio (Buffer)" se refiere a la proporción de solicitudes de acceso a los bloques de datos almacenados en el caché del buffer de Oracle que se resuelven utilizando datos en la caché en comparación con las solicitudes que requieren acceso al disco. El caché del buffer almacena los bloques de datos que se leen o modifican con frecuencia. Un alto ratio de aciertos indica que la mayoría de las solicitudes de acceso a los datos se resuelven utilizando bloques almacenados en la caché del buffer, lo que reduce la necesidad de acceder al disco y mejora el rendimiento general del sistema.

 

Si esta activado check_tablespaces:

 

tablespace <nombre tabla> free Porcentage de uso en GB. Es importante monitorizar el "tablespace free" en Oracle para tener un seguimiento de la cantidad de espacio disponible en los tablespaces. Esto permite gestionar de manera proactiva el crecimiento del espacio de almacenamiento y evitar problemas de espacio insuficiente que puedan afectar la funcionalidad de la base de datos. Al monitorear el tablespace free, se pueden tomar acciones como agregar más espacio de almacenamiento o realizar ajustes en las configuraciones para garantizar que haya suficiente espacio disponible.
tablespace <nombre tabla> status Estado de la tabla, 1 si esta online y 0 de no ser el caso. La monitorización del "tablespace status" en Oracle es fundamental para evaluar la salud y el estado de los tablespaces. Proporciona información sobre la integridad estructural de los tablespaces, incluyendo la existencia de errores o problemas de corrupción. Al monitorear el tablespace status, se pueden detectar problemas tempranamente y tomar medidas para solucionarlos, como restaurar desde backups o realizar tareas de recuperación. Esto garantiza la continuidad y la estabilidad de la base de datos, evitando la pérdida de datos o el deterioro del rendimiento debido a problemas en los tablespaces.

 

Si esta activado fragmentation_ratio:

 

fragmentation ratio El ratio de fragmentación. El Fragmentation Ratio en Oracle Database es un valor que indica la cantidad de espacio desperdiciado debido a la fragmentación en una estructura de datos. Un Fragmentation Ratio alto indica una mayor fragmentación y un mayor desperdicio de espacio, lo que puede afectar el rendimiento del sistema.

 

El plugin también creará un módulo por cada consulta personalizada definida en el fichero de configuración.