How to Visualize your Audit Data with BI Publisher? – Setup BI Publisher Usage Tracking

16 Nov

In my other blog post ( I have posted a nice video on BI Publisher Usage tracking. After this I have been asked by many of our friends to know how this can be get in action. while I am preparing to write the steps for this, I have found a great article by Kan Nishida from on same job.For the benifit of readers am sharing the same steps illustrated by him.

With Fusion Middleware Audit Framework you have an option to store the auditing data into a database instead of a log file, which is the default option. Once you enable the database storage option, that means you have your auditing data (or, user report access data) in your database tables, now no brainer, you can start visualize the data, create reports, analyze, and share with BI Publisher.

So, first, let’s take a look on how to enable the database storage option for the auditing data.

How to Feed the Auditing Data into Database

First you need to create a database schema for Fusion Middleware Audit Framework with RCU (Repository Creation Utility). If you have already installed BI Publisher 11G you should be familiar with this RCU. It creates any database schema necessary to run any Fusion Middleware products including BI stuff. And you can use the same RCU that you used for your BI or BI Publisher installation to create this Audit schema.

Create Audit Schema with RCU

Here are the steps:

  1. Go to $RCU_HOME/bin and execute the ‘rcu’ command
  2. Choose Create at the starting screen and click Next.
  3. Enter your database details and click Next.
  4. Choose the option to create a new prefix, for example ‘BIP’, ‘KAN’, etc.
  5. Select ‘Audit Services’ from the list of schemas. image
  6. Click Next and accept the tablespace creation.
  7. Click Finish to start the process.

After this, there should be following three Audit related schema created in your database.

  • <prefix>_IAU (e.g. KAN_IAU)
  • <prefix>_IAU_APPEND (e.g. KAN_IAU_APPEND)
  • <prefix>_IAU_VIEWER (e.g. KAN_IAU_VIEWER)

Setup Datasource at WebLogic

After you create a database schema for your auditing data, now you need to create a JDBC connection on your WebLogic Server so the Audit Framework can access to the database schema that was created with the RCU with the previous step.


  • Click ‘Lock & Edit’ so that you can make changes


  • Click New –> ‘Generic Datasource’ to create a new data source.
  • Enter the following details for the new data source:
    Name: Enter a name such as Audit Data Source-0.
    JNDI Name: jdbc/AuditDB
    Database Type: Oracle


  • Click Next and select ‘Oracle’s Driver (Thin XA) Versions: 9.0.1 or later’ as Database Driver (if you’re using Oracle database), and click Next.
  • The Connection Properties page appears. Enter the following information:
    Database Name: Enter the name of the database (SID) to which you will connect.
    Host Name: Enter the hostname of the database.
    Port: Enter the database port.
    Database User Name: This is the name of the audit schema that you created in
    RCU. The suffix is always IAU for the audit schema. For example, if you gave
    the prefix as ‘BIP’, then the schema name would be ‘KAN_IAU’.
    Password: This is the password for the audit schema that you created in RCU.


  • Click Next.
  • Accept the defaults, and click Test Configuration to verify the connection.
  • Click Next
  • Check listed servers where you want to make this JDBC connection available.


  • Click ‘Finish’ !

After that, make sure you click ‘Activate Changes’ at the left hand side top to take the new JDBC connection in effect.


Register your Audit Data Storing Database to your Domain

Finally, you can register the JNDI/JDBC datasource as your Auditing data storage with Fusion Middleware Control (EM). Here are the steps:

1. Login to Fusion Middleware Control

2. Navigate to Weblogic Domain, right click on ‘bifoundation…..’, select Security, then Audit Store.


3. Click the searchlight icon next to the Datasource JNDI Name field.

4.Select the Audit JNDI/JDBC datasource you created in the previous step in the pop-up window and click OK.


5. Click Apply to continue.

6. Restart the whole WebLogic Servers in the domain.

After this, now the BI Publisher should start feeding all the auditing data into the database table called ‘IAU_BASE’. Try login to BI Publisher and open a couple of reports, you should see the activity audited in the ‘IAU_BASE’ table. If not working, you might want to check the log file, which is located at $BI_HOME/user_projects/domains/bifoundation_domain/servers/AdminServer/logs/AdminServer-diagnostic.log

to see if there is any error.

Once you have the data in the database table, now, it’s time to visualize with BI Publisher reports!

Create a First BI Publisher Auditing Report

Register Auditing Datasource as JNDI datasource

First thing you need to do is to register the audit datasource (JNDI/JDBC connection) you created in the previous step as JNDI data source at BI Publisher. It is a JDBC connection registered as JNDI, that means you don’t need to create a new JDBC connection by typing the connection URL, username/password, etc. You can just register it using the JNDI name. (e.g. jdbc/AuditDB)

  1. Login to BI Publisher as Administrator (e.g. weblogic)
  2. Go to Administration Page
  3. Click ‘JNDI Connection’ under Data Sources and Click ‘New’image
  4. Type Data Source Name and JNDI Name. The JNDI Name is the one you created in the WebLogic Console as the auditing datasource. (e.g. jdbc/AuditDB)
  5. Click ‘Test Connection’ to make sure the datasource connection works.
  6. Provide appropriate roles so that the report developers or viewers can share this data source to view reports.
  7. Click ‘Apply’ to save.

Create Data Model


  1. Select Data Model from the tool bar menu ‘New’
  2. Set ‘Default Data Source’ to the audit JNDI data source you have created in the previous step.
  3. Select ‘SQL Query’ for your data set
  4. Use Query Builder to build a query or just type a sql query. Either way, the table you want to report against is ‘IAU_BASE’. This IAU_BASE table contains all the auditing data for other products running on the WebLogic Server such as JPS, OID, etc. So, if you care only specific to BI Publisher then you want to filter by using  ‘IAU_COMPONENTTYPE’ column which contains the product name (e.g. ’xmlpserver’ for BI Publisher).

Here is my sample sql query.

to_char(“IAU_TSTZORIGINATING”, ‘HH24’) as IAU_HH24,
from    “KAN3_IAU”.”IAU_BASE” “IAU_BASE”
where “IAU_BASE”.”IAU_COMPONENTTYPE” = ‘xmlpserver’

Once you saved a sample XML for this data model, now you can create a report with this data model.

Create Report


Now you can use one of the BI Publisher’s layout options to design the report layout and visualize the auditing data. I’m a big fan of Online Layout Editor, it’s just so easy and simple to create reports, and on top of that, all the reports created with Online Layout Editor has the Interactive View with automatic data linking and filtering feature without any setting or coding. If you haven’t checked the Interactive View or Online Layout Editor you might want to check these previous blog posts. (Interactive Reporting with BI Publisher 11GInteractive Master Detail Report Just A Few Clicks Away!) But of course, you can use other layout design option such as RTF template.

Here are some sample screenshots of my report design with Online Layout Editor.



Visualize and Gain More Insights about your Customers (Users) !


Now you can visualize your auditing data to have better understanding and gain more insights about your reporting environment you manage. It’s been actually helping me personally to answer the  questios like below.

  • How many reports are accessed or opened yesterday, today, last week ?
  • Who is accessing which report at what time ?
  • What are the time windows when the most of the reports access happening ?
  • What are the most viewed reports ?
  • Who are the active users ?
  • What are the # of reports access or user access trend for the last month, last 6 months, last 12 months, etc ?

I was talking with one of the best concierge in the world at this hotel the other day, and he was telling me that the best concierge knows about their customers inside-out therefore they can provide a very private service that is customized to each customer to meet each customer’s specific needs. Well, this is true when it comes to how to administrate and manage your reporting environment, right ? The best way to serve your customers (report users, including both viewers and developers) is to understand how they use, what they use, when they use. Auditing is not just about compliance, but it’s the way to improve the customer service. The BI Publisher 11G Auditing feature enables just that to help you understand your customers better.

Happy customer service, be the best reporting concierge!.

(Original post:





Posted by on November 16, 2011 in BI Publisher, OBI EE, OBIEE 11g


Tags: , , , , , , ,

6 responses to “How to Visualize your Audit Data with BI Publisher? – Setup BI Publisher Usage Tracking

  1. Amit Sangle

    February 27, 2012 at 4:54 am

    Need guidance & assistance as mentioned below –

    Please go through the link – –> About Running Actions Using Action Links and Action Link Menus in Analyses and Dashboards.
    We need steps, how to send mails, how do we configure action links in such a way that the diagrammatic report is sent as an mail to whoever has logged in on the analytics link.

  2. nail fungus

    April 26, 2013 at 12:37 pm

    I have read a few excellent stuff here. Definitely worth bookmarking for revisiting.
    I wonder how a lot effort you set to make one of these magnificent informative
    web site.


    June 5, 2013 at 12:29 pm

    I read this paragraph fully regarding the difference of hottest and preceding technologies, it’s amazing article.

  4. Rajan Adhikari

    August 20, 2014 at 2:24 am

    Is there any out of the box report of Audit and Monitoring?

  5. Shankar

    February 8, 2016 at 8:38 pm

    Hi Siva,

    Is it,This Auditing tables will help to capture the user information in OBIEE 11G also?

    I need to capture the user activities,Like who modified, delete, create the reports..information need to be capture the Table level..



Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

%d bloggers like this: