.. _first_steps: ============== Primeros pasos ============== .. sidebar:: Antes de comenzar... Para una mayor comprensión de este Manual de Usuario, se recomienda la lectura de la sección :ref:`glossary`, donde se explican los conceptos manejados en WOCU-Monitoring. En esta sección, se explican los pasos a seguir por el Administrador una vez instalado WOCU-Monitoring. Esta documentación sigue un enfoque práctico para facilitar la compresión y seguimiento de la operación. Acceso a WOCU-Monitoring ------------------------ 1. Acceda a la interfaz de WOCU-Monitoring insertando la siguiente dirección en su navegador: :: https:///aggregator 2. Al ingresar mediante un certificado autofirmado, el navegador devolverá una advertencia por defecto. **Es necesario aceptar este certificado para poder continuar con el proceso.** Conoce más sobre los certificados gestionados en la sección: :ref:`https`. .. image:: ../images/administrator_guide/7_074_browser_warning.png :align: center :scale: 70 % 3. Ingrese sus credenciales en la :ref:`página de login `. El usuario y contraseña establecido por defecto son ``admin/admin``, siempre y cuando **no se hayan modificado previamente** en el fichero de :ref:`initial_conf`. .. image:: ../images/operation/2_005a_cookies-banner-53.png :align: center :scale: 70 % 4. Introducidas las credenciales haga clic en el botón :guilabel:`Log in` para acceder a WOCU-Monitoring. Creación de Realms ------------------ Ya dentro de la aplicación, el siguiente paso será **dar de alta un primer Realm**. .. Attention:: **Esta guía se centrará únicamente en configurar los campos necesarios para la puesta en marcha de un Realm.** Información más completa y detallada :ref:`aquí`. 1. Accione sobre el botón azul :guilabel:`+ New Realm` para iniciar el proceso de creación a través del siguiente formulario. .. image:: ../images/operation/2_093c_aggregator_home-view_add-new-realm_home-empty_0-48.png :align: center :scale: 70 % 2. Complete los siguientes campos para configurar el primer Realm: .. image:: ../images/administrator_guide/7_075_form_new_realm.png :align: center :scale: 60 % .. centered:: *Se destacan los campos a modificar.* 2.1 **Display Name**: añada ``wocu``. 2.2 **Import Tool**: para añadir un primer Import-Tool accione la función :guilabel:`+`. .. image:: ../images/administrator_guide/7_077_add_new_import-tool.png :align: center :scale: 70 % .. centered:: *Se destacan los campos a modificar.* Los campos a modificar para el alta de un nuevo Import-Tool son: 2.2.1 **Name**: añada ``WOCU IT``. 2.2.2 **Import tool host**: añada ``wocu``. 2.2.3 **Path of CA file to validate SSL**: copie el texto indicado en la información de ayuda: :: /opt/wocu/embedded/ssl/certs/wocuCA.pem A continuación: - Confirme los cambios efectuados a través del botón :guilabel:`Create`. - Seleccione el nuevo Import-Tool en el selector para continuar. .. image:: ../images/administrator_guide/7_094_select_new_import-tool.png :align: center :scale: 80 % 2.3 **Monitoring Host**: añada ``wocu``. 2.4 **PNP4Nagios Protocol**: selecione ``HTTPS``. 2.5 **PNP4Nagios Host**: añada ``wocu``. 2.6 **PNP4Nagios Port**: añada ``443``. 2.7 **Metrics**: para añadir un primer servidor de bases de datos accione la función :guilabel:`+`. .. image:: ../images/administrator_guide/7_078_add_new_metrics.png :align: center :scale: 60 % .. centered:: *Se destacan los campos a modificar.* El campo a modificar para el alta de un nuevo servidor es: 2.7.1 **Metric name**: añada ``local``. A continuación: - Confirme los cambios efectuados a través del botón :guilabel:`Create`. - Seleccione el nuevo Metrics en el selector para continuar. .. image:: ../images/administrator_guide/7_095_select_new_metrics.png :align: center :scale: 80 % 2.8 **Metric Database**: para crear la base de datos que almacenará métricas realice los siguientes pasos: - Ejecute el siguiente comando en una nueva terminal: :: apt install -y curl && curl -X POST 'http://localhost:8086/query?u=root&p=root' -d 'q=CREATE DATABASE "localhost"' La base de datos ha sido creada. La respuesta debe ser la siguiente: :: {"results":[{"statement_id":0}]} - De regreso al formulario, en el campo **Metric Database** añada el mismo valor empleado en el anterior mandato: ``localhost``. .. image:: ../images/administrator_guide/7_096_conf_metrics_database.png :align: center :scale: 80 % 2.9 **Host Name**: añada ``localhost``. 3. Introducidos todos los datos requeridos, guarde la configuración del formulario mediante el botón :guilabel:`Add Realm`. **¡Enhorabuena!** ha sido creado con éxito el primer Realm. La página principal que por defecto WOCU-Monitoring muestra es la vista :ref:`status-tab`, en donde únicamente estará operativo el :ref:`global-panel` con un solo Host operativo. .. image:: ../images/administrator_guide/7_081_initial_view_status.png :align: center :scale: 50 % En este punto solo existe un equipo en el Realm. El siguiente paso será ampliar la infraestructura con la incorporación de nuevos Hosts. Alta manual de un Host ---------------------- Siga los siguientes pasos para dar de **alta nuevos Hosts** al Realm ``WOCU`` y ampliar la red monitorizada. .. Attention:: **Esta guía se centrará únicamente en configurar los atributos necesarios para añadir un nuevo Host.** Información más completa y detallada :doc_url:`aquí `. 1. Acceda al :ref:`Módulo de Configuración` del Realm ``WOCU`` y diríjase a la sección :ref:`Active Assets` > :ref:`Hosts`. .. image:: ../images/administrator_guide/7_082_path_to_hosts_active_assets.png :align: center 2. Haga clic sobre el botón :ref:`+ Add Host` para iniciar el proceso. .. image:: ../images/administrator_guide/7_090_add_host_button.png :align: center 3. Complete los siguientes campos del formulario: .. image:: ../images/administrator_guide/7_084_add_hosts_form.png :align: center :scale: 60 % .. centered:: *Se destacan los campos a modificar.* 3.1 **Host Name**: añada ``wocu_01``. 3.2 **Address**: registre ``127.0.0.1``. 4. Introducidos los datos, guarde la configuración mediante el botón azul :guilabel:`Create`. 5. Ya dispone del primer equipo ``wocu_01`` dado de alta desde el :ref:`Módulo de Configuración`. .. image:: ../images/administrator_guide/7_083_new_host.png :align: center 6. Para hacerse efectiva la monitorización del nuevo Host en el sistema, ejecute :ref:`Check`. .. image:: ../images/use_cases/5_008_aggregator_use_cases-geomap-check-button_0-50.png :align: center 7. Confirme la acción mediante el botón :guilabel:`Restart WOCU`, ubicado en el cuadro de diálogo que informa del estado de la BBDD. El mensaje de verificación confirma el estado óptimo del sistema para proceder al reinicio. .. image:: ../images/administrator_guide/7_093_wocu_check_response.png :align: center :scale: 60 % 8. Por último, acceda a la sección :ref:`Assets` > :ref:`Hosts ` donde se listan todos los equipos monitorizados del Realm y localice ``wocu_01`` a través de la barra de búsqueda. .. image:: ../images/administrator_guide/7_086_host_in_assets_inventory.png :align: center Aunque el nuevo equipo ya está dado de alta, no dispone de datos recogidos durante su actividad de monitorización. Por ello, el siguiente paso será asociar servicios al mismo. Configuración de servicios de monitorización -------------------------------------------- Siga los siguientes pasos para configurar nuevos **servicios de monitorización** al equipo ``wocu_01``. 1. Acceda al :ref:`Módulo de Configuración` del Realm ``WOCU`` y diríjase a la sección :ref:`Active Assets` > :ref:`Hosts`. .. image:: ../images/administrator_guide/7_082_path_to_hosts_active_assets.png :align: center 2. Localice el equipo ``wocu_01`` en el listado y haga clic sobre la acción :ref:`Packs`. .. image:: ../images/administrator_guide/7_085_packs_action.png :align: center .. admonition:: Para saber más... La configuración de servicios se llevará a cabo a través de la aplicación de :ref:`Packs de Monitorización `. Puede ampliar información consultando nuestro :doc_url:`Catálogo de Packs `. 3. Busque y seleccione en el listado: :doc_url:`LINUX-SSH `. La entrada correspondiente al pack tomará un color verde de fondo, lo que indica que ha sido seleccionado para su vinculación. .. image:: ../images/administrator_guide/7_087_select_linux_pack.png :align: center 4. Confirme la selección mediante el botón :guilabel:`Apply and exit`, y regrese a la vista global :ref:`Hosts`. .. image:: ../images/setup/4_034d_import-tool_active-assets_hosts-monitoring-packs-buttons_0-46.png :align: center 5. Puede comprobar como en la columna **Packs** se encuentra la etiqueta referente al pack :doc_url:`LINUX-SSH ` (recientemente configurado). .. image:: ../images/administrator_guide/7_088_linux_pack_applied.png :align: center 6. Para hacerse efectiva la nueva configuración del Host en el sistema, vuelva a ejecutar :ref:`Check`. .. image:: ../images/use_cases/5_008_aggregator_use_cases-geomap-check-button_0-50.png :align: center 7. Confirme la acción mediante el botón :guilabel:`Restart WOCU`, ubicado en el cuadro de diálogo que informa del estado de la BBDD. El mensaje de verificación confirma el estado óptimo del sistema para proceder al reinicio. .. image:: ../images/administrator_guide/7_092_wocu_check_response.png :align: center :scale: 60 % 8. Regrese a la sección :ref:`assets_tab` > :ref:`Services ` para verificar que el equipo ``wocu_01`` ya dispone de servicios de monitorización operativos (relativos al pack :doc_url:`LINUX-SSH ` asociado). Como se puede observar, existen servicios ya operativos (``OK`` y ``WARNING``) y otros en estado ``PENDING``, lo cual indica que están a la espera de ser ejecutados tras el próximo chequeo. .. image:: ../images/administrator_guide/7_089_host_with_linux_services.png :align: center Desde esta interfaz, es posible obtener información actualizada de cada servicio de monitorización. Haciendo clic sobre el nombre de un servicio concreto (Columna **Service**), emergerá una nueva :ref:`services` con información específica del estado actual, últimos chequeos ejecutados, así como otros gráficos métricos proporcionados durante las tareas de comprobación. .. image:: ../images/administrator_guide/7_091_modal_services.png :align: center :scale: 60 % **¿Y ahora qué?** ------------------------------------------- .. Note:: Si tiene algún comentario que le gustaría compartir, contacte con nosotros en . Estaremos encantados de recibir sus sugerencias y considerarlas para futuras actualizaciones. A continuación, se detallan distintas secciones que pueden ser de su interés, una vez disponga de los primeros dispositivos configurados. * :ref:`use_cases`: se proporciona información detallada sobre funciones específicas, así como descripciones paso a paso de la operativa a seguir. * `Packs de Monitorización `_: catálogo de packs clasificados por tecnologías, funciones o fabricantes más comunes del mercado. * :doc_url:`API `: sirve la documentación í­ntegra y detallada de la ``API`` de WOCU-Monitoring. * :doc_url:`Novedades `: listado de publicaciones de nuevas características, corrección de errores y otros cambios significativos, que acompañan a cada una de las versiones de WOCU-Monitoring. * :doc_url:`Manual de Usuario `: dividido en tres secciones acordes con las tareas más habituales: * Un capí­tulo dedicado a las tareas de :ref:`operation` de activos monitorizados. * Un capí­tulo que detalla la gestión de :ref:`reports` y sus tipos. * Un capí­tulo que describe la :ref:`basicconfiguration` para el alta, importación y administración de activos. **Ahora sí, comience a sacar el máximo partido a todas las funcionalidades que WOCU-Monitoring ofrece.**