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
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%
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]"/>
[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:
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).
Seleccione la ubicación de la instalación especificando la carpeta
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.
|
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. |
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.
Dé clic en Cerrar (Close) al finalizar.
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).
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.