Creación de un reporte simple usando Information Publisher Report

“Information Publisher Report” es una herramienta que viene integrada con el “Framework” de “Enterprise Manager” y que nos provee una poderosa capacidad de reportería y publicación de la cual podemos tomar ventaja y así poder diagnosticar, interpretar o extrapolar información de nuestras bases de datos con el objetivo de tomar mejores decisiones en nuestra infraestructura o en el negocio. Con “Information Publisher Report”  se nos hace posible crear una gran cantidad de reportes con  información rica en contenido, en formato HTML, con interfaces graficas y lo mejor de todo es que únicamente hace uso del “Oracle Management Repository (OMR)”. “Information Publisher Report” viene con algunos reportes ya pre creados y listos para ser usados, pero también tiene la capacidad de poder crear reportes totalmente personalizados para poder cumplir con nuestros requerimientos o los de nuestros clientes. En este articulo nosotros explicaremos  paso a paso cómo crear un reporte sencillo personalizado y mostraremos un ejemplo de uno de los muchos reportes que ya existen de facto.

Creando un reporte personalizado

“Information Publisher Report” trae ya varios reportes pre creados en su repositorio listos para ser utilizados, dentro de este conjunto de reportes podemos encontrar algunos con información sobre utilización del espacio en disco, métricas de ASM, Resumen de los parámetros de memoria de nuestra Instancia, entre otros. Sin embargo, nuestros requerimientos o los requerimientos de nuestros clientes pueden diferir de la información que dichos reportes pre creados contienen. Con el objetivo de resolver esto, contamos con la opción de crear reportes personalizados, con la información que nosotros necesitamos y el nivel de detalle que requerimos.

El desglose de las categorías de los reportes que ya vienen de facto es el siguiente:

Information Publisher Reports  

• Cisco
  • Cisco Switch
• Compliance
  • Descriptions
  • Results
• Deployment and Configuration
  • Alerts
  • Application Server Configuration
  • Client Configurations
  • Hardware
  • Linux Operating System Patching
  • Operating System
  • Oracle Database Configuration
  • Oracle Database Software
  • Oracle Fusion Middleware Software
  • Oracle Home Patch Advisories
  • Patching Automation Reports
• Enterprise Manager Setup
  • Agent
  • Management Pack Access
  • Plug-in Inventory
• Feature and License Pack Usage
  • License Pack Usage
• Monitoring
  • Aggregate Targets
  • Alerts
  • Availability History
  • BPEL Performance Reports
  • Dashboards
  • Enterprise Manager Health
  • JBoss Application Server Performance
  • LDAP Directory Server
  • OID Service
  • Root Cause Analysis
  • SOA Performance Reports
  • Service Level Agreements
  • Service Tests
  • Target Status Diagnostics Reports
  • Templates
• Security
  • Database Privileges
  • Database Targets
  • VPD and OLS Policies
• Storage
  • Oracle Database Space Issues
  • Oracle Database Space Usage

Desde Enterprise Manager 12c Cloud Control, se debe navegar al menú “Enterprise”, bajo dicho menú, seleccione el menú “Reports”. Estando ahí, se tendrán dos opciones:

• BI publisher Reports.
• Information publisher reports.

“Bi Publisher Reports” no esta incluido de facto, es responsabilidad del Administrador integrarlo manualmente con EM 12c Cloud Control a través de la herramienta “configureBIP”.

Si se ejecuta el comando “emctl status oms –details” se verá el siguiente mensaje:

[oracle@grid12c bin]$ ./emctl status oms -details
Oracle Enterprise Manager Cloud Control 12c Release 4 
Copyright (c) 1996, 2014 Oracle Corporation.  All rights reserved.
…
…
BI Publisher is not configured to run on this host.

Así también, si se sigue la siguiente ruta de navegación obtendremos un mensaje diciendo que “BI Publisher” no está configurado:

Menú “Enterprise” --> Menú “Reports” --> BI Publisher Enterprise Reports

“Oracle Business Intelligence (BI) Publisher” esta reemplazando a “Information Publisher” con el  sistema integral de reportería de Enterprise Manager. “Information Publisher” recomienda fuertemente migrar sus reportes hacia BI Publisher. Esto, sin embargo, está fuera del alcance de este articulo.

Reporte de facto:

A continuación se muestra un ejemplo de uno de los reportes que ya viene de facto en el repositorio de “Information Publisher”:

Nombre del reporte: “Oracle Database Software”/”Oracle Database Configuration Summary”
Descripción: Muestra un resumen de la configuración para una base de datos Oracle.

Reporte personalizado:

A continuación enseñaremos cómo crear un reporte sencillo pero totalmente personalizado, alineado a nuestros requerimientos.

Desde el menú “Reports”, seleccione “Information Publisher Reports”  estando ahí se tendrá la opción de crear un nuevo reporte tal como se muestra en la Figura 1-1.

Ruta de Navegación:  Enterprise --> Reports --> Information Publisher Reports

Figura 1-1

Ahora ya podemos empezar a trabajar con reportes personalizados haciendo clic en el botón “Create”, en este reporte se verá que con una consulta simple se puede obtener un reporte sobre estadísticas del PGA de nuestra base de datos mostrando los datos con gráficas agradables al cliente/usuario final, diversos tipos de gráficos pueden ser usados en nuestros reportes como, por ejemplo: Grafico de Pastel, Grafico de líneas, Grafico de barras, entre otros.

Figura 1-2

Dentro de los datos que nos preguntará el asistente estarán el titulo del reporte, cual es la categoría del reporte, la sub-categoría y una descripción detallada para futuras revisiones bajo la pestaña “General” (puede ver esto en la Figura 1-2 arriba). Adicionalmente a eso se tiene que ingresar el tipo de “Target”, por supuesto, para este ejemplo sería una Instancia de Base de Datos, dado que nuestro objetivo es ejecutar consultas SQL, PL/SQL contra nuestra base de datos y genera un reporte a partir de ello. Seleccione la opción “Database Instance” en la opción “Target Type” y busque la instancia de base de datos que será utilizada para el reporte, dicha instancia debe estar registrada en “Cloud Control”. Como nota importante, para poder visualizar nuestra instancia en el listado, un agente de Grid Control debe estar instalado y ejecutándose en la maquina donde la instancia de base de datos se encuentra.

Bajo la sección “Privileges”, elija la opción “Run report using target privilege of the report owner (SYSMAN)”, en esta sección también se puede configurar el periodo de tiempo que se quiere analizar. Los detalles de la pestaña “General” puede encontrase en la Figura 1-3.

Figura 1-3

Ahora desde la pestaña “General” muévase hacia la pestaña “Elements”. Una vez en la pestaña “Elements” dé clic en el botón “Add” para agregar un nuevo elemento, el cual es requerido tal como se muestra en la Figura 1-4. Es posible tener uno o más elementos dentro de un mismo reporte, así mismo no es obligatorio que los elementos sean del mismo tipo. Es posible tener una grafica desde una sentencia SQL, una tabla desde SQL, y así sucesivamente.

Figura 1-4.

En un reporte sencillo, podríamos tener varios elementos tal como ya se había indicado, sin embargo para fines de este ejemplo después de dar clic en el botón “add” se deberá seleccionar la opción  “Chart from SQL”, pues lo que se requiere es tener una grafica que muestra la información del PGA.

Figura 1-5.

Luego de seleccionar el elemento, el siguiente paso debe ser configurarlo. Clic en “Set Parameters” tal como se muestra en la Figura 1-6. Una vez dado clic se deberá ingresar el nombre de la cabecera, el tipo de grafico y la consulta SQL que se debe ejecutar.

Figura 1-6.

Nota importante: Antes de usar las consultas debemos estar completamente seguros que esas consultas SQL se ejecutarán sin errores. Estas consultas deberían se ser probadas previamente desde la base de datos OMR no desde la base de datos objetivo. Esto es dado que toda la información desde la base objetivo será cargada hacia el OMR por el agente. Básicamente el usuario MGMT_VIEW controla todos estos reportes, entonces para que sea posible ejecutar consultas, debemos de ceder los privilegios de selección sobre las vistas dinámicas al usuario MGMT_MVIEW. Los siguiente privilegios deben ser concedidos:

SQL>  grant select on gv_$pgastat to mgmt_view; 
Grant  succeeded. 


SQL>  grant select on gv_$instance to mgmt_view; 
Grant  succeeded. 
SQL>
SQL>  conn mgmt_view/oraworld 
Connected. 
SQL>  select * from 
(     select 
i.instance_name, 
p.name, 
p.value 
from 
gv$pgastat p, 
gv$instance i 
where 
p.inst_id=i.inst_id 
) 
pivot(  max(value) for name in ( 
'aggregate  PGA target parameter' as aggregate_PGA_target_parameter, 
'total  PGA allocated' as total_PGA_allocated, 
'maximum  PGA allocated' as maximum_PGA_allocated, 
'total  freeable PGA memory' as total_freeable_PGA_memory, 
'total  PGA inuse' as total_PGA_inuse, 
'total  PGA used for auto workareas' as PGA_used_for_auto_workareas, 
'total  PGA used for manual workareas' as PGA_used_for_manual_workareas 
)) order by instance_name; 

La consulta que queremos utilizar ha sido probada y se ha visto que funciona correctamente desde SQL*Plus, ahora ya podemos configurarla en nuestro reporte. Complete la información solicitada del elemento tal como se muestra en la siguiente figura:

Dé clic para continuar y agregar otro elemento de tipo "Table from SQL", esto lo debe hacer solamente si se quiere agregar más consultas o información de métricas:

Figura 1-8

Figura 1-9

Luego de seleccionar "Table from SQL", dé clic en "Edit/Set Parameter" para configurarlo. No es obligado incluir varios elementos en un reporte, sin embargo en este ejemplo nosotros queremos mostrarles cómo conjugar varios elementos dentro de un mismo reporte para personalizarlo en base a nuestros requerimientos. Finalice la edición del elemento haciendo clic en el botón “Ok”.

Figura 1-10

Ahora cambie de pestaña, de ahora en adelante trabajaremos con la pestaña "Schedule" , una vez estando ahí modifica los intervalos de tiempo en que se requiere que la métrica sea ejecutada. En esta sección se puede configurar qué tan frecuente se requiere recibir los reportes. Una vez configurada esta sección dé clic en el botón “Ok”.

Figura 1-11

Luego de configurar la programación de ejecución, ahora debemos trabajar en la pestaña “Access”, en esta sección nosotros podemos agregar una lista de usuarios quienes podran modificar el reporte. De facto, el dueño del reporte y el administrador tendrán acceso completo sobre este reporte. Luego de configurar esta sección dé clic en el botón “Ok”.

Figura 1-12

Cuando el reporte haya sido finalizado dicho reporte se podrá ver desde el menú “Information Publisher”, el reporte podrá ser visualizado bajo la categoría y sub-categorías que nosotros configuramos en los pasos anteriores. Todo lo que debemos hacer es únicamente dar clic sobre el nombre del reporte y dicho reporte y su información serán mostrados automáticamente.

Figura 1-13.

Figura 1-14

Toda la información del PGA será mostrada con los gráficos que nosotros configuramos en la pestaña “Elements”, es fácil ver y analizar las columnas tales como “PGA target parameter”, “allocated”, “free memory”, etc.  Adicionalmente a la visualización de nuestro reporte también tenemos la opción de descargar el reporte en formato CSV dando clic en el icono del lado derecho de la grafica, una vez hecho clic se nos preguntará en donde deseamos guardar el archivo.

 Figura 1-15

Deiby Gómez es rumorado como la persona más joven en todo el mundo en haber obtenido el premio de Oracle ACE, fue el primero en obtenerlo de su país Guatemala a la edad de 23 años. Deiby es el primero en su país en aparecer en la revisa “Oracle Magazine” (Edición nov/dic 2014). Cuando no está trabajando se le puede encontrar jugando Ajedrez. Deiby es miembro de OraWorld, presidente del OUG de Guatemala y actualmente trabaja en Pythian. 

Yenugula Venkata Ravikumar es un DBA con más de 15 años de experiencia especializada en ambientes de alta disponibilidad (RAC, Data Guard, entre otros), afinamiento del rendimiento, migraciones, recuperación de datos y estrategias de respaldos. Tiene experiencia en Oracle Exadata Database Machine y en varios sistemas operativos como AIX, HP-UX y Linux, entre muchos otros. Ha participado en varios eventos de Oracle en India y posee la máxima certificación de Oracle llamada “Oracle Certified Master (OCM 10g)”. 

Nassyam basha es un DBA que posee la certificación máxima de Oracle llamada “Oracle Certified Master (OCM 11g)”, posee un fuerte conocimiento de tecnologías como Data Guard, RMAN, RAC y afinamiento del rendimiento. Él ha participado en más de 90 configuraciones de Data Guard en diferentes plataformas. Él ha participado en configuraciones sencillas como configuraciones muy complejas de Data Guard, así también ha sido parte de exitodas migraciones y operaciones de switchover y failover para negocios altamente críticos. Nassyam participa activamente en eventos de Oracle en India, ha escrito más de 10,000 posts usando el usuario “CKPT”. Constanetemente publica artículos en su blog y es el autor del libro “Data Guard 11gR2 guia para principiantes”.

Este artículo ha sido revisado por el equipo de productos Oracle y se encuentra en cumplimiento de las normas y prácticas para el uso de los productos Oracle.