Pandora azure SQL

Plugin para monitorizar una base de datos AzureSQL

Introducción

Ver. 11-05-2022

Con este plugin se puede monitorizar una base de datos de azureSQL y sacar datos de esta.

Tipo: Plug-in de servidor

Matriz de compatibilidad

Sistemas donde se ha probado

CentOS 7, Fedora, rocky linux

Sistemas donde debería funcionar

Cualquier sistema linux 

 

Pre requisitos

Configuración previa

El plugin hace uso de un fichero en el que se pueden meter dos tipos de datos.

#credentials
tenant_id:<tenant-id>
client_id:<client-id>
secret:<secret>
#id resources
database_id:<database_resource_id>

Obtención de credenciales necesarias para el uso del plugin.

1. Credenciales para autenticar:

-Tenant id

-Client id

-Secret

2. ID de recurso

Es necesaria la id de cada recurso que monitoriza el plugin estas son :

- ID de recurso de la base de datos

Obtención de tenant id y client id.

1. Para obtener el tenant id y el client id, iremos al menú registro de aplicaciones dentro de active directory:

menu.png

2. Entraremos dentro de la aplicación.

menu2.png

3. En el menú de la aplicación aparecerá el tenant id y el client id.

menu3.png

4. Para encontrar el secreto iremos a certificados y secretos dentro del menu de active directory.

menu4.png

5. Dentro de este menú podremos ver las claves de secreto o generarlas (tiene que ser el valor de la clave, no la id)

menu5.png

 

Obtención de la id de recurso de la base de datos.

En la base de datos, en información general, podremos ver la id de recurso de la base de datos pinchando en Vista json.

image-1652285449723.png

 

 

Parámetros

Parámetro Descripción
--tentacle_port Puerto de tentacle.Por defecto 41121(opcional)
--tentacle_address Ip del servidor tentacle al que mandar los datos(opcional)
--agent_name Para ponerle un nombre al agente que contendrá los módulos , por defecto : "Azure SQL". (opcional)
--prefix_module Para ponerle un prefijo a los módulos por si se quieren diferencias de otras ejecuciones.(opcional)
--conf Path del archivo conf con las querys (obligatorio)
-g,--group Grupo de destino de Pandora FMS (opcional)
--data_dir Directorio de datos de Pandora FMS. Por defecto es /var/spool/pandora/data_in/ (opcional)
--as_agent_plugin Es opcional, si quieres que el plugin sea de agente y te meta los módulos en el agente de pandora, ejecuta esto con un 1 (opcional)

 

Ejecución manual

Ejemplo de ejecución manual:

./pandora_azuresql -c <path_conf>

image-1652284119687.png

./pandora_azure -c <path_conf> --as_agent_plugin 1 [--data_dir <path> --agent_name <nombre del agente>]

image-1652283880334.png

Configuración en PandoraFMS

Como plugin de servidor

Instalación desde consola

Para el registro del plugin, desde la consola, se debe ir al apartado "registrar plugin".

register_plugin.png

Daremos a seleccionar archivo.

register_plugin2.png

Seleccionaremos el fichero pspz2 que contiene el plugin

image-1652351401344.png

Nos saldrá un mensaje que indicará si se ha registrado correctamente

image-1652351503518.png

Una vez registrado el plugin, lo veremos en el apartado plugins.

serversingles.png

Pinchando en el título accederemos al menu del plugin.

image-1652351575064.png

En parámetros, veremos todos los del plugin, recordar que no todos son obligatorios, solo en los que así se especifíca

image-1652351615625.png

Abajo, en las macros de los parámetros podremos añadirles el valor requerido.

register5_azure.png

 

Instalación manual

Iremos a servidores > plugins:

image-1629974405286.png

Pinchamos en añadir: