| Wiki Markup |
|---|
{scrollbar}
Para realizar el análisis de las estadísticas del O3 Server utilizando el O3 Browser se proveen dos modelos que permiten construir un cubo de análisis para el servidor en general y un cubo de análisis para cada uno de los cubos publicados en el mismo.
Estos modelos se encuentran en el directorio 'server' debajo del directorio de instalación de O3.
Los modelos son:
| _Nombre del Modelo_ | _Descripción_ |
| ServerPerformance.mdl | Permite construir el cubo de análisis general de un O3 Server para lo cual utiliza los 4 archivos de log que contiene información de este tipo: O3CubeService.log, Audit.log, Cubes.log, Sessions.log |
| CubeQueriesPerformance.mdl | Permite construir para un determinado cubo, el cubo de análisis del mismo. Para ellos utiliza el archivo Queries.log correspondiente al cubo que se desea analizar. |
\\
En el caso de utilizar el modelo ServerPerformance.mdl es necesario generar los cuatro archivos de log descriptos anteriormente.
Una vez que 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 el O3 Builder (como es lógico) 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:
{code} |
...
In order to carry out analysis of O3 Server statistics through the use of O3 Browser, two models that let you build an analysis cube for the server in general and an analysis cube for each of the cubes published in it are provided.
These models are found in the "server" directory below the O3 setup directory.
The models are:
Model Name | Description |
|---|---|
ServerPerformance.mdl | It lets you build the O3 Server general analysis cube through the use of the 4 log files:
|
CubeQueriesPerformance.mdl | For a given cube, it lets you build its analysis cube. |
When you use the ServerPerformance.mdl model, it is necessary to generate the four files mentioned above.
Once the log files have been generated, and through the use of the aforementioned models, you may go on to build (or rebuild) the analysis cubes.
The building or rebuilding of cubes is performed through the use of O3 Builder (as expected) with a special parameter "-profiling" and using a .srv file with data about the server for which statistics are to be calculated. The buildings are always complete, that is to say no incremental loads are performed on these cubes.
As a consequence, in order to build the statistics analysis cubes the following command should be used:
Builder -profiling <file>.srv
Where the <file>.srv file must contain the following data:
| Code Block |
|---|
serverHost = <host>
serverName = O3Server
[cubeName = <statCube>]
[profCubeName = <cube>]
model = <path>/CubeQueriesPerformance.mdl | model=<path>/ServerPerformance.mdl
user = <username>
password = <password>
{code}
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.
{code} |
Please see the section: "Generating the configuration file for O3 Builder"
Property | Description |
|---|---|
ServerHost | Name or IP address of the machine currently running the O3 Server from which statistics will be taken. |
ServerName | Name of the O3 Server. (This value must always be 'O3Server'). |
CubeName | It is optional and must only be used in case the cube with statistic information (<statCube>) to be built or rebuilt, is published in O3 Server. |
ProfCubeName | This parameter must only be included when you attempt to build a cube with statistics coming from other cube published in O3 Server. |
Model | The model to use for the building of the statistics cube. If you wish to build an O3 Server general statistics cube, the ServerPerformance.mdl model must be assigned as value, and if you wish to create a statistics cube for any given cube published in O3 Server, the CubeQueriesPerformace.mdl model must be assigned as value, and the cube to analyze must be specified through the use of the profCubeName parameter mentioned before. |
User | It is the user through which connection to O3 Server is made. |
Password | Password of the user through which connection to O3 Server is made. |
The following example of .srv file is used to create the O3 Server general statistics cube in the maching called MyHost and published as O3ServerStats in the same server.
| Code Block |
|---|
serverHost = MyHost
serverName = O3Server
cubeName = O3ServerStats
model = <path>/ServerPerformance.mdl
user = admin
password = admin
{code}
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.
{code} |
By using this second example of .srv file a statistics cube of the cube published in O3 Server under the name "Demo" is built.
Besides, this statistics cube is published in O3 Server under the name DemoStats.
| Code Block |
|---|
serverHost = MyHost
serverName = O3Server
cubeName = DemoStats
profCubeName = Demo
model = <path>/CubeQueriesPerformance.mdl
user = admin
password = admin
{code}
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 |
The administrator shall provide a file of this type for each of the files in their O3 Server for which they wish to create the corresponding statistics analysis cube, by modifying the cubeName and profCubeName respective values.
If the statistics cube you are building is not published in O3 Server, the cubeName parameter will not be included in the .srv file.
In this case, the Builder standard parameter (-cube=<path>/<cubeName>)
...
can be used to specify the path where to save the built cube and the name to give to it.
If this parameter is not specified, O3 Builder will use its default settings, and create the cube in the same directory where the .mdl file used is located, giving it the same name, and .cube extension, of course.
As for any cube building process from ascii files, it is necessary to specify the location of the files used as data source, (in this case, the log files generated by the O3 Server Profiles service)
By default, when O3 Builder receives the -profiling option and logs in to the O3 Server specified in the .srv file received as parameter to build a given statistics cube, it automatically extracts the location of the log files it needs for the building from the O3 Server setup.
If by any reason it is necessary to build statistic cubes from log files in a different location to the specified in the O3 Server setup, the -cgf=<file>.cfg option of O3 Builder should be used.
The command to use in these cases will be:
| Code Block |
|---|
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: {code} |
As a rule the -cfg option lets you specify new values for the parameters of the model you are using to build the cube. In this case the models have a set of parameters that specify the path to the log files needed for the building and it is therefore possible to modify them this way.
The <file>.cfg fiile must, as a consequence have the following format:
| Code Block |
|---|
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
{code}
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.
----
{children}
|
The values of parameters must include the path and logfile name.
The first 4 parameters are necessary when the server general statistics cube is built, whereas the last one is necessary if you are building a statistics cube for a specific cube.
...
| Child pages (Children Display) |
|---|
| Wiki Markup |
|---|
{scrollbar} |