# Azure Microsoft Compute

# Introducción

**Este plugin tiene como finalidad monitorizar intancias y regiones de Azure Microsoft Compute**, mediante métricas claves referentes al CPU, redes, IOPS y discos que son esenciales para llevar un control y seguimiento de estas máquinas y para garantizar un rendimiento óptimo, solucionar problemas, planificar el escalado, cumplir con los SLAs y mejorar la seguridad.

El plugin se conecta al API de Azure y monitoriza zonas e instancias mediante las métricas anteriormente mencionadas, generando un agente para cada zona e instancia via XML que envía al servidor de pandora.

# Matriz de compatibilidad

<table border="1" id="bkmrk-sistemas-donde-se-ha-1" style="width: 647px;"><tbody><tr><td style="width: 306px;">**Sistemas donde se ha probado**</td><td style="width: 341px;">Rocky linux, Fedora 34</td></tr><tr><td style="width: 306px;">**Sistemas donde funciona**</td><td style="width: 341px;">Cualquier sistema linux</td></tr></tbody></table>

# Prerrequisitos

- Conectividad a la API de Azure

El plugin es un binario que contiene las dependencias empaquetadas por lo que no es necesaria la instalación de ningún tipo de dependencia para su uso.

- Permisos

Para hacer las solicitudes a través de la api, la cuenta utilizada para autenticar en la ejecución requiere de unos determinados permisos.

<span style="text-decoration: underline;">Asignación de permisos</span>

Debe asignar un rol a la cuenta con la que vaya a operar la *app*, para ello acceda a **Home** y entre en **Suscription**:

[![image-1687444674025.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/scaled-1680-/image-1687444674025.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/image-1687444674025.png)

Dentro de la suscripción, seleccione **Access control (IAM)**:

[![image-1687444709078.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/scaled-1680-/image-1687444709078.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/image-1687444709078.png)

Se agregará una nueva asignación de rol en la debe seleccionar **Reader** para la *app* creada:

[![image-1687444741413.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/scaled-1680-/image-1687444741413.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/image-1687444741413.png)

**Guarde los cambios pulsando *Save*** .

A partir de ese momento podrá conectar con el servicio y hacer solicitudes a través de este plugin.

# Parámetros y configuración

**Parámetros**

<table border="1" id="bkmrk---conf-ruta-al-archi" style="width: 516px;"><tbody><tr><td style="width: 113px;">--conf</td><td style="width: 403px;">Ruta al archivo de configuración</td></tr></tbody></table>

<div id="bkmrk-archivo-de-configura"><div><div>**Archivo de configuración (--conf)**</div></div></div><div id="bkmrk-"></div>```
agents_group_name  = < Nombre del grupo de destino para los agentes creados >
threads            = < Número de hilos de ejecución, cada zona/instancia se repartirá equitativamente en el número de hilos >
interval           = < Intervalo en segundos para los agentes y para el analisis de métricas >
transfer_mode      = < Modo de transferencia, tentacle o local >
tentacle_ip        = < IP de la máquina destino para los agentes creados >
tentacle_port      = < Puerto de tentacle, por defecto : 41121 >
tentacle_opts      = < Opciones adicionales de tentacle client >
data_dir           = < (Solo se activa si el transfer_mode es local) Ruta de destino para los XML de cada agente, por defecto "/var/spool/pandora/data_in/" >

advance_monitoring = < Activar con 1 para habilitar monitorización generalizada (estos módulos solo se crearán en los agentes de las instancias que esten en ejecución) >
cpu_summary        = < Activar con 1 para habilitar la monitorización del CPU >
iops_summary       = < Activar con 1 para habilitar la monitorización IOPS  >
disk_summary       = < Activar con 1 para habilitar la monitorización de discos >
network_summary    = < Activar con 1 para habilitar la monitorización de redes  >

stats_agent        = < Activar con 1 para habilitar un agente global que monitorizará en base a la tarea creada y los parámetros utilizados >
stats_agent_name   = < Nombre para el agente que se activa con el parámetro "stats_agent". Si no utiliza y "stats_agent" esta habilitado, el agente se llamará "azure" por defecto > >

azure_zones          = < Lista con las zonas a monitorizar (cuando se marca una zona para monitorizar, automaticamente monitoriza todas las instancias que encuentre dentro de esa zona) >
azure_instances =    = < Lista con las instancias a monitorizar >

creds_b64 = < Credenciales en base64 del archivo JSON para autenticar >
```

<span style="text-decoration: underline;">Ejemplo</span>

```
agents_group_name  = azure
interval           = 3600
threads            = 5
transfer_mode      = tentacle
tentacle_client    = tentacle_client
tentacle_ip        = 172.42.42.101
tentacle_port      = 41121
data_dir           = /var/spool/pandora/data_in/

advance_monitoring = 1
cpu_summary        = 1
iops_summary       = 1
disk_summary       = 1
network_summary    = 1

stats_agent        = 1
stats_agent_name   = azureCloud

azure_zones = ["uksouth","ukwest"]
azure_instances = ["instance-1","instance-2","instance-3",instance-4"]


creds_b64 = oiZJDNNJKCDJndkdKDNJDKDKNDhjdkdmdNHFJFKfFMFNFJFKk5IinDJFJKFKfmnfDHHDKDKDldjjDfmFJFNFFMNFNFMFNFmFNFFJJFmf==
```

# Ejecución manual

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

```shell
./pandora_azure_mc --conf < ruta al fichero de configuración >
```

Por ejemplo:

```shell
./pandora_azure_mc --conf /usr/share/pandora_server/util/plugin/azure.conf
```

La ejecución devolverá una salida en formato JSON con información sobre la ejecución, y generará un fichero XML para cada agente monitorizado que enviará al servidor de Pandora FMS por el método de transferencia indicado en la configuración.

Por ejemplo:

```JSON
{"summary": {"Total agents": 35, "Zones agents": 5, "Instances agents": 29}}
```

# 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/](https://pandorafms.com/library/)

[![image-1687944710118.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/scaled-1680-/image-1687944710118.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/image-1687944710118.png)

Una vez cargado, se podrán monitorizar entornos de Azure Microsoft Compute creando tareas de *Discovery* desde la sección *Management &gt; Discovery &gt; Cloud*.

[![image-1687944813607.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/scaled-1680-/image-1687944813607.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/image-1687944813607.png)

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

- **Azure credentials**: Credenciales de conexión al API de Microsoft Azure a usar por la tarea. Se deben registrar previamente en el almacén de credenciales de Pandora FMS.
- **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.
- **Tentacle IP**: IP del servidor de Tentacle al que enviar los datos de los agentes. Normalmente este parámetro no se modificará.
- **Tentacle port**: Puerto del servidor de Tentacle al que enviar los datos. Normalmente este parámetro no se modificará.
- **Tentacle extra options**: Opciones adicionales para el envio de datos mediante el cliente de Tentacle. Normalmente este parámetro no se modificará.
- **Add global stats agent**: Si se activa se generará un agente global con estadísticas de la tarea.
- **Stats agent name**: Permitirá indicar el nombre del agente para estadísticas globales de la tarea. Si no se indica un nombre, se usará el nombre por defecto del plugin.

[![image-1687441745735.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/scaled-1680-/image-1687441745735.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/image-1687441745735.png)

Si las credenciales proporcionadas son correctas y el servidor de Pandora FMS es capaz de conectar con el API de Microsfot Azure, se podrá ver un árbol con las zonas e instancias de Azure Microsoft Compute, las cuales se podrán marcar para su monitorización.

Si se selecciona una zona se monitorizarán, además de la propia zona, todas las instancias que contenga (tanto en el momento de configurar la tarea como en adelante si se incluyen nuevas instancias).

Si se seleccionan instancias específicas se monitorizarán independientemente de que no se hayan seleccionado sus zonas.

[![image-1687441086213.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/scaled-1680-/image-1687441086213.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/image-1687441086213.png)

Finalmente se podrá ajustar la monitorización que se desee obtener para cada agente:

- **Scan and general monitoring**: Si se activa se habilitará la tarea para obtener la monitorización adicional para los agentes, descrita en los siguientes campos.
- **Cpu performance summary:** Si se activa se incluirán los módulos de rendimiento de CPU a la monitorización.
- **IOPs Performance summary**: Si se activa se incluirán los módulos de rendimiento de IOPs a la monitorización.
- **Disk performance summary**: Si se activa se incluirán los módulos de rendimiento de discos a la monitorización.
- **Network performance summary**; Si se activa se incluirán los módulos de rendimiento de red a la monitorización.

[![image-1687441126549.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/scaled-1680-/image-1687441126549.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/image-1687441126549.png)

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

- **Total agents**: Número total de agentes generados por la tarea.
- **Zones agents**: Número total de agentes de zonas generados por la tarea.
- **Instances agents**: Número total de agentes de instancias generados por la tarea.

[![image-1687441167730.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/scaled-1680-/image-1687441167730.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-06/image-1687441167730.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

La ejecución del plugin, creara los siguientes agentes y módulos:

- **Agente global**

<table border="1" id="bkmrk-google-cloud-platfor" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 100%;">&lt; Nombre utilizado con el parámetro "stats\_agent\_name" o en su defecto "azure" &gt;</td></tr></tbody></table>

**Módulos**

<table border="1" id="bkmrk-summary.google.compu" style="border-collapse: collapse; width: 100%;"><tbody><tr class="datos2" id="bkmrk-summary.google.compu-1"><td class="datos2 " id="bkmrk-summary.google.compu-2" style="width: 49.8765%;"><div><div>Azure MC Instances count</div></div></td><td style="width: 50%;">Número de instancias totales monitorizadas por el plugin</td></tr></tbody></table>

- **Un agente por cada zona monitorizada.**

<table border="1" id="bkmrk-%3C-nombre-de-la-zona-" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 100%;">&lt; Nombre de la zona &gt;</td></tr></tbody></table>

**Módulos**

<table border="1" id="bkmrk-summary.google.compu-0" style="border-collapse: collapse; width: 100%; height: 334px;"><tbody><tr style="height: 46px;"><td style="width: 50%; height: 46px;">summary.azure.compute.CPUUtilization</td><td style="width: 50%; height: 46px;">Porcentaje de CPU usado promedio de las instancias de esta zona</td></tr><tr class="datos" id="bkmrk-summary.google.compu-3" style="height: 46px;"><td class="datos " id="bkmrk-summary.google.compu-4" style="width: 50%; height: 46px;">summary.azure.compute.DiskReadBytes</td><td style="width: 50%; height: 46px;">Sumario de la cantidad de bytes leídos desde el disco de cada instancia de esta zona</td></tr><tr style="height: 46px;"><td style="width: 50%; height: 46px;">summary.azure.compute.DiskReadOps</td><td style="width: 50%; height: 46px;"> Sumario de el número de operaciones de lectura realizadas en el disco de cada instancia de esta zona</td></tr><tr style="height: 46px;"><td style="width: 50%; height: 46px;">summary.azure.compute.diskWriteBytes</td><td style="width: 50%; height: 46px;"> Sumario de la cantidad de bytes escritos en el disco de cada instancia de esta zona</td></tr><tr class="datos2" id="bkmrk-summary.google.compu-5" style="height: 46px;"><td class="datos2 " id="bkmrk-summary.google.compu-6" style="width: 50%; height: 46px;">summary.azure.compute.DiskWriteOps</td><td style="width: 50%; height: 46px;"> Sumario del número de operaciones de escritura realizadas en el disco de cada instancia de esta zona</td></tr><tr style="height: 46px;"><td style="width: 50%; height: 46px;">summary.azure.compute.instances</td><td style="width: 50%; height: 46px;">Número de instancias monitorizadas en esta zona</td></tr><tr class="datos2" id="bkmrk-summary.google.compu-7" style="height: 29px;"><td class="datos2 " id="bkmrk-summary.google.compu-8" style="width: 50%; height: 29px;">summary.azure.compute.NetworkPacketsIn</td><td style="width: 50%; height: 29px;"> Sumario del número de paquetes de red entrantes de cada instancia de esta zona</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">summary.azure.compute.NetworkPacketsOut</td><td style="width: 50%; height: 29px;"> Sumario del número de paquetes de red salientes de cada instancia de esta zona</td></tr></tbody></table>

- **Un agente por cada instancia monitorizada**

<table border="1" id="bkmrk-%3C-nombre-de-la-insta" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 100%;">&lt; Nombre del grupo de recursos &gt;/&lt; Nombre de la instancia &gt;</td></tr></tbody></table>

**Módulos**

<table border="1" id="bkmrk-state-estado-de-la-m" style="border-collapse: collapse; width: 100%; height: 261px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">State</td><td style="width: 50%; height: 29px;">Estado de la máquina, en formato string</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Instance State (bool)</td><td style="width: 50%; height: 29px;">Estado de la máquina, 1 si esta corriendo, 0 de no ser este el caso</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">CPUUtilization</td><td style="width: 50%; height: 29px;">Porcentaje de uso de CPU utilizado</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">DiskReadBytes</td><td style="width: 50%; height: 29px;">Cantidad de bytes leídos desde el disco</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">DiskReadOps</td><td style="width: 50%; height: 29px;">El número de operaciones de lectura realizadas en el disco</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">DiskWriteBytes</td><td style="width: 50%; height: 29px;">Cantidad de bytes escritos en el disco</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">DiskWriteOps</td><td style="width: 50%; height: 29px;">Número de operaciones de escritura realizadas en el disco</td></tr><tr class="datos2" id="bkmrk-networkpacketsin-el-" style="height: 29px;"><td class="datos2 " id="bkmrk-networkpacketsin" style="width: 50%; height: 29px;">NetworkPacketsIn</td><td style="width: 50%; height: 29px;">El número de paquetes de red entrantes</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">NetworkPacketsOut</td><td style="width: 50%; height: 29px;">El número de paquetes de red salientes</td></tr></tbody></table>