Cubos de Monitoreo

Este wiki describe la estructura de los modelos multitidimensionales necesarios para generar los cubos de monitoreo, los pasos necesarios para definir los archivos de configuración de cada uno, y su posterior construcción.

Para realizar el análisis de las estadísticas de O3 BI se proveen tres modelos multidimensionales que permiten construir:

un cubo de análisis para el servidor en general
un cubo de análisis para cada uno de los cubos publicados
un cubo de análisis de accesos a O3 BI

Los modelos son:

Nombre	Descripción	Fuente de datos	Ubicación
ServerPerformance.mdl	Permite construir el cubo de análisis general de un servidor de O3 BI para lo cual utiliza los 4 archivos de log que contienen información de este tipo.	Logs de monitoreo general del servidor: O3CubeService.log, Audit.log, Cubes.log, Sessions.log	directorio 'server' debajo del directorio de instalación de O3 BI.
CubeQueriesPerformance.mdl	Permite construir para un determinado cubo, su cubo de análisis de performance. Se puede	Logs de monitoreo por cubo: archivo Queries.log correspondiente al cubo que se desea analizar	directorio 'server' debajo del directorio de instalación de O3 BI.
ServerAuthentications.mdl	Permite construir un cubo para análisis de accesos a O3 BI.	Log Authentication.log, generado automáticamente por O3 BI en el directorio de la instalación, bajo /server/logs	directorio 'server/logs' debajo del directorio de instalación de O3 BI.

Generación de archivos de configuración

En el caso de utilizar el modelo ServerPerformance.mdl es necesario generar los cuatro archivos de log descriptos anteriormente.

Una vez que se tiene generados los archivos de log y utilizando los modelos mencionados en la sección anterior se puede proceder a la construcción (o reconstrucción) de los cubos de análisis.

La construcción o reconstrucción de los cubos se lleva a cabo utilizando O3 Builder (como con cualquier otro cubo) con un parámetro especial '-profiling' y utilizando un archivo .srv con los datos acerca del servidor para el cual se van a calcular estadísticas. Las construcciones son siempre completas, es decir que no se realizan cargas incrementales sobre estos cubos.

Por lo tanto para construir los cubos de análisis de estadísticas se debe utilizar el siguiente comando:

Builder -profiling <file>.srv

Donde el archivo <file>.srv debe contener los siguientes datos:

serverHost    = <host>
serverName    = O3Server
[cubeName     = <statCube>]
[profCubeName = <cube>]
model         = <path>/CubeQueriesPerformance.mdl | model=<path>/ServerPerformance.mdl
user          = <username>
password      = <password>

Ver la sección "Generando el archivo de configuración para O3 Builder".

ServerHost	Nombre o dirección IP de la máquina en la que esta ejecutando el O3 Server del cual se van a tomar las estadísticas.
ServerName	Nombre del servidor de O3 (El valor debe ser siempre 'O3Server').
CubeName	Es opcional y se debe usar únicamente en caso de que el cubo con información de estadística (<statCube>) que se va a construir o reconstruir este publicado en el O3 Server. En estos casos el Builder se encargara de controlar todo el proceso de actualización de ese cubo que esta corriendo en el O3 Server. Es decir, desconectará los posibles usuarios que se encuentren conectados al mismo al momento de la actualización, marcara el cubo como 'no accesible' temporariamente, procederá a la reconstrucción y finalmente volverá a marcarlo como accesible de forma que los usuarios puedan volver a conectarse.
ProfCubeName	Este parámetro sólo debe incluirse cuando se pretende construir un cubo con estadísticas correspondientes a otro cubo publicado en el O3 Server (es decir cuando el parámetro model tenga asignado el modelo CubeQueriesPerformance.mdl). Su valor debe ser el del nombre con que esta publicado en el O3 Server el cubo para el cual se quiere construir un cubo de estadísticas. Es importante observar que el modelo que se utiliza para construir cubos de estadísticas acerca de otros cubos es independiente del cubo a considerar. Es justamente éste parámetro el que permite seleccionarlo. Por lo tanto el parámetro debe estar presente cada vez que se use el modelo CubeQueriesPerformance.mdl.
Model	El modelo a utilizar para la construcción del cubo de estadísticas. Si se quiere construir un cubo de estadísticas generales del O3 Server, se debe asignar como valor el modelo ServerPerformance.mdl y si se quiere crear un cubo de estadísticas de un cubo particular que esta publicado en el O3 Server se debe asignar como valor el modelo CubeQueriesPerformance.mdl y especificar además con el parámetro profCubeName mencionado antes el cubo a analizar.
User	Usuario utilizado para conectarse al O3 Server. Debe tener privilegios de administración.
Password	Password del usuario utilizado para conectarse al O3 Server.

El siguiente ejemplo de archivo .srv se utiliza para crear el cubo de estadísticas generales del O3 Server que se encuentra en la maquina de nombre MyHost y que además esta publicado como O3ServerStats en el mismo servidor.

serverHost = MyHost
serverName = O3Server
cubeName   = O3ServerStats
model      = <path>/ServerPerformance.mdl
user       = admin
password   = admin

Con este segundo ejemplo de archivo .srv se construye un cubo de estadísticas del cubo que esta publicado en el O3 Server con el nombre de Demo. Además dicho cubo de estadísticas está publicado en el O3 Server con el nombre DemoStats.

serverHost   = MyHost
serverName   = O3Server
cubeName     = DemoStats
profCubeName = Demo
model        = <path>/CubeQueriesPerformance.mdl
user         = admin
password     = admin

Construcción de cubos de monitoreo.

Caso ServerAuthentications

Caso ServerPerformance y CubeQueriesPerformance

El administrador deberá proveer un archivo de este tipo para cada uno de los cubos de su O3 Server para los cuales quiera crear el correspondiente cubo de análisis de estadísticas, modificando los valores de cubeName y profCubeName respectivos.
En caso de que el cubo de estadísticas que se está construyendo no este publicado en el O3 Server, no se incluirá el parámetro cubeName en el archivo .srv. En este caso se puede utilizar el parámetro estándar del Builder (-cube=<path>/<cubeName>) para especificar el camino donde guardar el cube construido y el nombre a asignarle al mismo. En caso de no especificar este parámetro O3 Builder tomará su comportamiento por defecto que consiste en crear el cubo en el mismo directorio donde se encuentra el archivo .mdl utilizado, con el mismo nombre que éste, y extensión .cube por supuesto).
Al igual que con la construcción de cualquier cubo a partir de archivos ascii, es necesario especificar la ubicación de los archivos utilizados como fuente de datos (en este caso, los archivos de log generados por el servicio de monitoreo del O3 Server).
Por defecto cuando el O3 Builder recibe la opción de -profiling y se conecta al O3 Server que se especifica en el archivo .srv recibido como parámetro para construir un determinado cubo de estadísticas, extrae de la configuración del O3 Server la ubicación de los archivos de logs que necesita para la construcción de forma automática.
Si por alguna razón es necesario realizar la construcción de cubos de estadísticas, pero a partir de archivos de log que se encuentran en una ubicación diferente a la especificada en la configuración del O3 Server, se debe utilizar la opción -cgf=<file>.cfg de O3 Builder. El comando a utilizar en estos casos será:
builder -profiling -cfg=<file>.cfg <file>.srv
En general la opción -cfg permite especificar nuevos valores para parámetros del modelo que se está utilizando para construir el cubo. En este caso los modelos disponen de un conjunto de parámetros que especifican el camino a los archivos de logs necesarios para la construcción y es por tanto posible modificarlos de esta manera. El archivo <file>.cfg debe tener por tanto el siguiente formato:

O3_CUBE_SERVICE_PATH = <path>/O3CubeService.log
AUDIT_PATH           = <path>/Audit.log
CUBES_PATH           = <path>/Cubes.log
SESSIONS_PATH        = <path>/Sessions.log
QUERIES_PATH         = <path>/<cubename>Stats.log

Los valores de los parámetros deben incluir el camino y el nombre del archivo de log.
Los primeros 4 parámetros son necesarios cuando se construye un cubo de estadísticas generales del servidor, mientras que el último es necesario si se construye un cubo de estadísticas de un cubo específico.