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/oracle-discovery/

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

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

• Oracle target string: Lista de objetivos Oracle a monitorizar por la tarea. Será una lista separada por comas o por líneas. Cada base de datos objetivo se podrá definir con el formato IP:PUERTO/SID o IP/SID. 
  
  

  También puede especificar una cadena DNS directamente.

   

  Ejemplo server standalone: 

   

  dsn=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sales1-srv)(PORT=1521))(CONNECT_DATA=(SID=ORCL)))       

  Ejemplo failover con dos servers :

   

  dsn=(DESCRIPTION=(FAILOVER=ON)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=sales1-srv)(PORT=1521) (CONNECT_TIMEOUT=5)(RETRY_COUNT=2))(ADDRESS=(PROTOCOL=TCP)(HOST=sales2-srv)(PORT=1521)(CONNECT_TIMEOUT=5)(RETRY_COUNT=2)))(CONNECT_DATA=(SID=ORCL)))

• User: Usuario de conexión a las bases de datos objetivo.
• Password: Contraseña del usuario indicado.
• Thick mode: Para habilitar el "thick mode". Solo es necesario este tipo de conexion en bases de datos oracle con versión 11 o anteriores
• Client path: Ruta del cliente de oracle. Solo es necesario en caso de habilitar el "thick mode". La instalacion estandar de instant client 19.8 se hace  en la ruta /usr/lib/oracle/19.8/client64/lib.
• Multitenant: Discover and monitor PDBs within a CDB: Solo aplicable a arquitecturas multitenant de Oracle (CDB/PDB); en entornos que no sean CBD, simplemente emitirá un warning.
• Create agent per PDB: Solo aplicable a arquitecturas multitenant (CDB/PDB) de Oracle. Si está marcada, se creará un agente por cada PDB en la instancia; de lo contrario, los módulos de cada PDB se incluirán en el agente principal de la instancia.
• Enable entities file re-scan interval: Activar intervalo de generacion de fichero de entidades, para monitorización Multitenant.
• Re-scan entities file interval: Intervalo de generación de fichero de entidades.

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

• Max threads: Para optimizar el tiempo de ejecución, se podrán configurar múltiples hilos para monitorizar los agentes de la tarea. Hay que tener en cuenta que configurar múltiples hilos puede aumentar el uso de CPU de la tarea.
• Target agent: Lista de agentes objetivo para los objetivos Oracle a monitorizar. Es decir, los nombres con los que se generarán los agentes de cada objetivo definido en la tarea. Será una lista separada por comas o por líneas. La posición de los nombres en la lista deberá coincidir con la posición de los objetivos Oracle en su lista, es decir, el primer nombre se usará para el primer objetivo y así sucesivamente. Si la lista se separa por líneas, las líneas en blanco se ignorarán. Si no se especifica un nombre de agente para un objetivo se usará su IP o FQDN como nombre del agente.
• Custom module prefix: Texto incluido como prefijo para los todos los nombres de módulos generados. Es útil para localizar los módulos generados por la tarea o distinguirlos de otros.
• Check engine uptime: Si se activa monitorizará el uptime de los objetivos.
• Retrieve query statistics: Si se activa monitorizará las estadísticas de consultas.
• Analyze connections: Si se activa monitorizará las conexiones.
• Calculate fragmentation ratio: Si se activa monitorizará el ratio de fragmentación.
• Monitor tablespaces: Si se activa monitorizará los tablespaces.
• Retrieve cache statistics: Si se activa monitorizará las estadísticas de caché.

• Execute custom queries: Si se activa permitirá ejecutar consultas personalizadas a cada objetivo Oracle.
• Custom queries: Bloque de configuración para definir las consultas personalizadas que se ejecutarán. Cada consulta generará un nuevo módulo para cada agente de la tarea.
• Define tresholds: Aqui se pueden definir los umbrales para los módulos generados (excepto los generados por consultas personalizadas). El formato es una definición de umbrales por línea y es el siguiente:
  
  

  < Patron regexp de coincidencia con nombre de módulos > = < Umbrales deseados en el modulo, separados por "|" >

  Por ejemplo:
  
  

  ^tablespace = min_warning 10|max_warning 20|min_critical 0|max_critical 10

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

• Total agents: Total de agentes generados por la tarea.
• Targets up: Total de objetivos a los que ha sido posible conectar.
• Targets down: Total de objetivos a los que no ha sido posible conectar.

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