SAP

Este documento describe la funcionalidad SAP del discovery de PandoraFMS.

Introducción

Este documento tiene como objetivo la descripción de la monitorización de sistemas SAP con Pandora FMS a través del Discovery.

El plugin pandora_sap_deset como wrapper del plugin Deset_SAP_Plugin para su uso en Discovery, permite monitorizar sistemas y servidores SAP de manera remota sin necesidad de instalar nada en los equipos que alojan SAP, haciendo uso de funciones RFC (Remote Function Call).

Prerrequisitos

 

La carpeta lib que debe contener ficheros Deset_SAP_Plugin.jar, libsapjco3.so, sapjco3.jar y la carpeta jre (java runtime environment), debe de estar en la misma ruta en la que se ejecuta el plugin. Esta carpeta se adjunta con el plugin en el paquete que se puede descargar de la librería de Pandora FMS.

Dado que la monitorización se realiza desde fuera del sistema SAP, es necesario asegurar la comunicación con el mismo.

Haciendo uso de las funciones RFC, la conectividad se realiza desde el equipo que ejecuta el plugin (por ejemplo, el servidor de Pandora FMS) y el gateway del sistema SAP a través del puerto 33XX TCP, siendo XX el numero del sistema SAP al que se conecta (por defecto el 3300 TCP). Por lo tanto el rango de puertos de conexión posible irá desde el 3300 al 3399.

Para poder ejecutar las funciones RFC del sistema SAP será necesario contar con un usuario y su contraseña.

Este usuario debe ser de tipo “B-Sistema” (System) en versiones SAP ECC o S/4HANA, o de tipo “C-Comunicación / CPI-C/RFC” en versiones de SAP anteriores.

Se recomienda que el usuario sea de tipo "B-Sistema" siempre que sea posible ya que para este tipo de usuarios no caducan sus contraseñas, lo cual en el caso de suceder obligaría a cambiarlas también en la configuración del plugin en Pandora FMS.

Para la creación del usuario en el sistema SAP, será necesario que tenga los siguientes objetos de autorización:

Deset_SAP_Plugin es exclusivo para clientes de Pandora FMS Enterprise que lo hayan contratado. Por ello es necesario contar con una clave de licencia válida para ejecutar el plugin.

Para obtener una licencia válida, contacte con el equipo de Pandora FMS en:

https://pandorafms.com/es/

Parámetros y configuración

Parámetros

--conf Ruta al archivo de configuración
--custom_modules Ruta al archivo en el que se deben de definir los módulos personalizados

Archivo de configuración (--conf)

El contenido del fichero será el siguiente:

agents_group_id = < ID del grupo en el que se creará el agente de la tarea >
threads = < Número de hilos que se usaran para la creación de módulos >
interval = < Intervalo de monitorización del agente en segundos >
server = < IP del servidor SAP >
client = < Número de cliente SAP >
system = < Número de sistema SAP >
license = < Código de la licencia >
credentials = < Base 64 del JSON con las credenciales >
agent = < Nombre de agente objetivo >
modules = < Lista JSON de módulos predefinidos a monitorizar >

Ejemplo

agents_group_id = 10
threads = 5
interval = 300
server = 192.168.80.191
client = 001
system = 00
license = 022220743456700424
credentials = asJ1c2VyIjoiGBTREjUiLCJwYXNzd29yZCI6IklOKJNJQUwifQ==
agent = SAP_R3
modules = [192,195]

Credenciales

Las credenciales que se deben introducir en la opción "credentials" del archivo de configuración descrito anteriormente son un código base 64 de un JSON con el siguiente formato:

{"user":"< usuario >","password":"< contraseña >"}

Ejemplo JSON

{"user":"SAP_USER","password":"JhGBf76@db!"}

Este JSON debería convertirse a base 64 y el resultado sería una cadena como la siguiente, que es la que se debería introducir en la opción "credentials" del fichero de configuración :

eyJ1c2VyIjoiU0FQX1VTRVIiLCJwYXNzd29yZCI6IkpoR0JmNzZAZGIhIn0=

Listado de módulos personalizados (--custom_modules)

El contenido del fichero será un listado de módulos, separando la creación de cada uno en líneas diferentes. Para la creación de estos se debe usar este formato:

< Nombre módulo >;< Tipo de módulo >;< Parámetros de creación de módulo de SAP >

Ejemplo

SAP info;generic_data_string;-m 120
SAP Mem Max;generic_data;-m 101
SAP Login users;generic_data_string;-m 103

La lista de módulos disponibles y los parámetros que se deben usar para cada uno viene definido en la documentación adjunta del plugin de SAP ubicado en la librería de Pandora FMS, localizable en el siguiente enlace : https://pandorafms.com/library/sap-r3-monitoring-agent/

 

Ejecución manual

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

./pandora_sap_deset \
--conf < ruta al fichero de configuración > \
[ --custom_modules < ruta al fichero que contiene el listado de módulos personalizados a monitorizar > ] 

Por ejemplo:

./pandora_sap_deset \
--conf /usr/share/pandora_server/util/plugin/sap.conf \
--custom_modules /usr/share/pandora_server/util/plugin/sap_custom_modules.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-1687944659047.png

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

image-1687944773252.png

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

image-1684835243175.png

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

<nombre_modulo>;<tipo_modulo>;<definicion_chequeo>

Por ejemplo:

SAP info;generic_data_string;-m 120

image-1686146755320.png

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

image-1684835265625.png

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

SAP View

Permite visualizar el estado general de los servidores SAP:

image-1684837464823.png

Esta vista muestra un panel con los módulos SAP disponibles del agente SAP seleccionado. Puede seleccionar el tiempo de refresco y el intervalo a mostrar en las gráficas.

Módulos generados por el plugin

El plugin creará un agente para el servidor objetivo. Ese agente contendrá los siguientes módulos predefinidos (si se han incluido en la opción "modules" en el fichero de configuracion):

Average time of SAPGUI response 102
Dialog Logged users 103
SAP Idoc erroneus 104
SAP IDOC OK 105
SAP Dumps 109
SAP List lock 111
SAP Cancel Jobs 113
Number of Update WPs in error 116
SAP Batch input erroneus 121
SAP WP without active restart 150
SAP WP stopped 151
SAP Login OK 160
SYSFAIL, delivery attempts tRFC wrong entries number 192
SYSFAIL, queue qRFC INPUT, wrong entries number 195

El plugin también creará un módulo por cada módulo personalizado definido en el fichero de configuración al que se llama usando el parámetro --custom_modules.

La lista de módulos totales disponibles que pueden incluirse en la monitorización de módulos personalizada viene definida en la documentación adjunta del plugin de SAP ubicado en la librería de Pandora, localizable en el siguiente enlace:  https://pandorafms.com/library/wp-content/uploads/2022/03/Guia_instalacion_SAP_EN.Anexos_v4.pdf