Package: prod-monitoring-nsxt
MonitorizaciónEste proyecto incluye un módulo empaquetado "prod_monitoring_nsxt", el cual está preparado para envíar métricas de monitorización de sistemas NSX-T hacia sistemas kafka para su posterior recolección en BBDD. Una vez las métricas estén en BBDD serán accesibles desde eldashboardde Grafana. Funciona creando instancias paralelas que recolectan las métricas de cada uno de los nodos a monitorizar, definidos en el fichero "configuration.yaml"RequisitosLos requisitos para instalar y ejecutar el proyecto son:Un IDE o un editor de código:IDE:PyCharmEditores de Código:Visual Studio Code,Notepad++,VIMUn entorno dePython 3.6.8mínimo con las siguientes librerías:library-nsxtproc-monitoringSi se utiliza en Windows, también instalar los paquetes:win-inet-pythonOpcionalmente, si se requiere ejecutar un entorno local de kafka para realizar pruebas, se pueden utilizar las siguientes imágenes docker para construir el entorno:confluentinc/cp-zookeeperconfluentinc/cp-kafkaEn el directorio "docker" hay un fichero para construir el entorno local de kafka con docker.InstalaciónPara instalar el programa localmente o en un Linux remoto:Descargar o clonar el proyecto desde el repositorio.Asegurarse de tener un entorno de Python funcional con la versión requerida y los paquetes necesarios.Activar el entorno de Python que fue creado.Instalar el módulo ejecutando este comando en la ruta del proyecto:pythonsetup.pyinstallModificar el ficheroconfiguration.yamlpara recolectar las métricas de los nodos deseados y configurar el sistema kafka al que se van a envíar.Ejecutar el script "executor.py" con el fichero de configuración (configuration.yaml).Opcionalmente podemos definir un servicio para ejecutar la recolección de métricas en segundo plano.Se puede instalar docker y ejecutar el comandodocker-compose upen el directorio "docker" para crear un entorno de pruebas con Kafka instalado y así depurar fallos en el envío de métricas a Kafka.ConfiguraciónLos argumentos para linea de comandos del script principalexecutor.pyson:-cf/--config-file: Describe los nodos lanzados en la ejecución y su configuración.-w/--whatif: Si se establece, el script se ejecutará normalmente pero no cambiará ningún dato persistente.-i/--info: Si se establece, mostrará en pantalla la información de cada uno de los pasos del lanzamiento del script.-d/--debug: Si se establece, aumentará el nivel de información mostrada en pantalla, generalmente solo se usa para depurar errores.-h/--help: Muestra un mensage de ayuda del script.Para configurar los nodos a monitorizar o modificar el servidor Kafka al que se envían las métricas, modificar el ficheroconfiguration.yaml.
Este fichero está dividido en 3 objetos principales, "nodos", "argumentos" y "conexiones":Nodos(nodes): En esta sección los nodos son declarados y configurados. Para añadir un nodo, simplemente añadir una entrada a la lista de nodos, con el parámetrotypeespecificando el nombre completo de la clase a la que debería de ser instanciada, y el parámetroargsespecificando el diccionario de argumentos que se pasaría a la clase. Cada tipo de nodo que se defina en un futuro, debería de estar documentado en el directoriodocs.Argumentos(args): En esta sección los argumentos son creados y definidos. El valor de estos argumentos, es obtenido posteriormente desde la clase nodo concreta para ser utilizado.Conexiones(connection_refs): En esta sección se definen las conexiones necesarias para recabar métricas y enviarlas, como por ejemplo, la uri de la API de NSX y sus credenciales, o la IP del servidor Kafka al que se van a envíar las métricas. Posteriormente se accede a estás conexiones definidas desde la secciónargsde cada nodo.