Configuración de Bizagi Diagnostics

<< Clic para mostrar Tabla de Contenidos >>

Navegación:  Automation Server > Automation Server - configuración y administración > Mantenimiento y monitoreo del sistema > Monitoreo > Herramienta de diagnóstico de Bizagi (Diagnostics) >

Configuración de Bizagi Diagnostics

Introducción

Bizagi Diagnostics es una herramienta que provee opciones de monitoreo en las operaciones de Automation Server, para un ambiente de pruebas o de producción, como se describe en Herramienta de diagnóstico de Bizagi (Diagnostics).

La siguiente sección ilustra los prerrequisitos de su instalación al igual que la información sobre cómo configurarla.

 

Prerrequisitos

Asegúrese de cumplir con los requerimientos de software y de hardware antes de instalar y utilizar Bizagi Diagnostics.

 

Por lo menos 3 GB de espacio libre y 8 GB de RAM donde se va a instalar Bizagi Diagnostics

 

Java Runtime Environment instalado donde Bizagi Diagnostics se ejecuta.

Asegúrese de utilizar la versión 8, actualización 71 o superior. Podrá revisar si cuenta con la versión adecuada del Java JRE instalada, usando una consola de comando e ingresando:

java -version

 

JAVA_version_new

 

Podrá descargar el Java JRE desde el sitio oficial de Oracle en: http://www.oracle.com/technetwork/java/javase/downloads/index.html

 

JAVA_HOME configurado como variable de entorno.

Podrá revisar la configuración adecuada de esta variable de entorno, utilizando una consola de comando e ingresando (a lo cuál debe salir la ruta apropiada):

echo %JAVA_HOME%

 

JAVAHOME_env_Var_new

 

Preconfiguración de Bizagi Diagnostics

Se necesita configurar cada compoente para generar los logs que necesita Diagnostics, en la ruta donde los lee.

Para esto, edite el archivo de configuración de cada componente de Automation Server (Portal de trabajo y servicio Programador) de cada servidor en caso de utilizar un clúster.

Active los logs y especifique que la ruta donde serán almacenados.

 

Edite el archivo web.config del Portal de trabajo incluyendo las dos líneas que se mencionan a continuación, dentro del elemento <appSettings> (por defecto ubicado en C:\Bizagi\Projects\[su_proyecto]\WebApplication)

 

Si está trabajando en un ambiente clúster, debe hacer esto para cada nodo:

 

<add key="DiagnosticsEnabled" value="true"/>

<add key="DiagnosticsStorageName" value="[ruta_lectura_Diagnostics]\[prefijo_instancia]"/>

 

Diagnostics_config1_new

 

[ruta_lectura_Diagnostics]: la carpeta configurada para leer los logs. Esta ruta se configura durante la instalación de Bizagi Diagnostics.

Recuerde que para el acceso desde Automation Server, usted podrá utilizar una ruta tipo UNC (p.e, \\Servidor\Ruta\).

 

[prefijo_instancia]: esta definición no representa una subcarpeta sino un prefijo que se incluye para definir una marca para cada componente que registra logs en dicha ruta. De esta manera, los logs que leerá Bizagi Diagnostics conocerá el componente del cuál provienen. Usted podrá utilizar, por ejemplo, W01 para el Portal de trabajo del nodo #1 en una arquitectura con clúster, y W02 para el nodo #2 (y así sucesivamente).

Note que DiagnosticsEnabled determina si los logs quedan activos para ese componente (los valores posibles son verdadero -true- o falso -false-).

 

Guarde los cambios al finalizar.

Este tipo de cambios no requiere que reinicie el servicio.

 

Edite el archivo de configuración BizAgi.Scheduler.Services.exe.config del servicio Scheduler (por defecto se encuentra en C:\Bizagi\Projects\[su_proyecto]\Scheduler) para incluir las mismas líneas anteriores dentro del elemento <appSettings>.

 

Si está trabajando en un ambiente clúster, debe hacer esto para cada nodo.

 

Guarde los cambios al finalizar.

Los cambios en este archivo, requieren que reinicie el servicio del Programador (p.e desde el panel de servicios de Windows).

El reinicio del Programador toma unos segundos y no interrumpe las operaciones de Automation Server.

 

Descargando Bizagi Diagnostics

Descargue el instalador directamente desde http://resourcesbizagi.blob.core.windows.net/docs/BizagiDiagnostics.exe.

 

Instalando Bizagi Diagnostics

Para instalar Bizagi Diagnostics, asegúrese de ejecutar BizagiDiagnostics.exe con permisos de administrador local:

 

Diagnostics_install1_new

 

Dé clic en Siguiente (Next) en la pantalla inicial de bienvenida.

Revise los términos del acuerdo de licencia de Bizagi Diagnostics, acéptelos u haga clic en Siguiente (Next).

 

Diagnostics_install7_new

 

Seleccione la ubicación de la instalación especificando la carpeta

 

Diagnostics_install2_new

 

Dé clic en Siguiente (Next) cuando esté listo.

 

Configure la ruta de donde Bizagi Diagnostics leerá la información de logs. Esta ruta debe coincidir con la que se dio en la preconfiguración, donde  Automation Server crea los logs.

 

note_pin

Al definir esta ruta, considere:

 

Esta ruta puede ser una carpeta local que sea compartida con todos los servidores de Automation Server.

Esto se debe a que para la configuración de Automation Server en un esquema de alta disponibilidad (p.e, uso de clústers), usted contará con más de un servidor de Automation Server constantemente escribiendo archivos en este repositorio.

Al utilizar dicha configuración, usted deberá asegurarse que esta carpeta pueda accederse como una ruta UNC por las diferentes instancias de Automation Server (p.e, accesible como \\Servidor\Ruta\), incluyendo los permisos adecuados para la cuenta de servicio de cada Automation Server.

 

Diagnostics_install3_new

 

Dé clic en Siguiente (Next) y confirme la instalación al dar clic en instalar (Install).

El procedimiento completo puede tardar un par de minutos.

 

Diagnostics_install4_new

 

Dé clic en Cerrar (Close) al finalizar.

 

Diagnostics_install5_new

 

Cuando termine la instalación, se necesita iniciar manualmente los tres servicios Windows que se instalan con Bizagi Diagnostics.

 

Abra la herramienta de servicios de Windows y localice los siguiente: BizagiDiagnostics_Elasticsearch, BizagiDiagnostics_Grafana y BizagiDiagnostics_Logstash. Luego, inicie cada uno haciendo clic derecho y seleccionado Iniciar (Start).

 

Diagnostics_install6_new

 

En este punto, Bizagi Diagnostics ha sido configurado y podrá comenzar a usarlo como se describe en Uso de Bizagi Diagnostics.

 

Resolución de problemas

Bizagi Diagnostics se apoya en servicios adicionales como lo son ElasticSearch, LogStash y Grafana.

 

Después la primera vez que inicie los servicios, estos deben iniciar de forma automática junto con su máquina.

Si estos servicios no inician automáticamente, inícielos manualmente.