Configuring usage and error logging
iHub can capture usage monitoring and error information in log files. To understand resource usage and troubleshoot problems, use usage and error logging.
In Advanced view, choose System. Choose Properties, then choose Usage Logging.
Figure 3‑9 shows Usage Logging.
The following Actuate usage and error logging applications that ship with iHub record usage activity and error information in a log file:
Usage Logging Extension
Writes the usage information to a comma-delimited (.csv) file, usage_log.csv
Error Logging Extension
Writes the usage information to a comma-delimited (.csv) file, error_log.csv
The usage logging and error logging applications are open framework applications. These applications are DLLs in Windows and shared libraries in Linux. By default, the usage and error logging extensions reside in the following location:
AC_SERVER_HOME/bin
iHub creates a primary log directory that contains the usage and error log records for the default volume in the following location:
AC_SERVER_HOME/UsageErrorLogs/primary
iHub creates secondary log directories for additional volumes as required in the following location:
AC_SERVER_HOME/UsageErrorLogs/secondary_$VOLUMENAME
The directories for usage and error log files are not configurable.
In an iHub cluster, the asynchronous design execution log entry is in the log of the Encyclopedia process node. For a synchronous or transient document generation, the log entry is in the log file of the node that runs the design. Before you configure error logging for a cluster, ensure that each node in a cluster has the same logging applications installed.
A developer can customize the way the DLL or shared library handles the usage and error log information. iHub Integration Technology provides a reference implementation for this purpose.
iHub supports consolidating log information into a database. iHub Integration Technology provides a reference implementation for the log consolidator application. For more information, see Using BIRT iHub Integration Technology.