EM: File System > Audit Logging Jobs
Description
The
Audit Logging Jobs allows the administrator to create, manage and edit all auditing tasks for any BBj database. All audit data will be logged to an audit database.
Location
EM Navigator →
File System →
Audit Logging Jobs
Toolbar
Audit Logging Jobs
Manages configured
Audit Logging Jobs by presenting each job’s name, processed-through timestamp, and current status, providing a clear operational view for monitoring ongoing audit data collection activities.
Audit Logging Jobs Settings
| Column | Description |
|---|---|
|
The audit logging job by its assigned name for administrative reference. |
|
|
The most recent timestamp through which the audit logging job has successfully processed. |
|
|
The audit job’s current operational state. |
Audit Database / Log Viewer
Clicking the Examine Data
opens Audit Database/Log Viewer. The pane provides a detailed interface for filtering and reviewing recorded audit log entries using database, file, user, operation type, and date-range criteria.
Audit Database / Log Viewer Settings
| Settings | Description |
|---|---|
|
The specific audit log database used to filter and retrieve matching audit entries. |
|
|
Filters audit log results to entries involving a specific audited file path. |
|
|
Identifies which audit-log users are included in the search criteria. Clicking the ellipsis button opens the User Selection dialog, where available users can be checked or unchecked. Confirming the selection with OK updates the Users field with the chosen entries. |
|
|
The audit operation types included in the query filter. Clicking the ellipsis button opens the Operation Types dialog, where available operations appear as a checklist. Then select one or more operation types, confirm the selection by clicking OK, and the chosen types return to the Operation Type(s) field as a comma-separated list for filtering audit records. |
|
|
Defines the earliest date and time used to include matching audit log entries in results. |
|
|
The latest date and time used to stop including matching audit log entries in results. |
Export Button
The Export button opens a dialog that users can scroll through the results for a quick visual search, or copy the entire text and paste it into a text editor for Ctrl-F searching or into a tool such as Gemini or ChatGPT to ask more complex questions about the audited data.
| Settings | Description |
|---|---|
|
Users can scroll through the results for a quick visual search, or copy the entire text and paste it into a text editor for Ctrl-F searching or into a tool such as Gemini or ChatGPT to ask more complex questions about the audited data. |
Audit Database / Log Viewer: Column Settings
Column fields present detailed attributes of each audit entry, enabling users to review timestamps, users, files, operation types, programs, and modes efficiently.
Audit Database / Log Viewer: Column Settings
| Column | Description |
|---|---|
|
Records the date and time each audited operation occurred, helping correlate user activity, file changes, and system behavior. |
|
|
The account responsible for each audited action, enabling user activity across logged operations. |
|
|
List of the file(s) in each audited operation. |
|
|
Indicates the specific audited action performed during the operation, supporting precise filtering and review. |
|
|
The BBj program name that triggered the logged audit trail event. |
|
|
Lists BBj file modes for each operation entry. |
Create a New Audit Task
Accessing this process by clicking the
icon opens the Audit Job Wizard, enabling users to name the audit job, define an empty root directory, and select the intended auditing target.
New Audit Task Settings
| Settings | Description |
|---|---|
|
Audit Job name. |
|
|
Clicking the |
|
|
Initiates auditing for an entire selected database instance rather than individual files or directories. |
|
|
Enables auditing only the explicitly selected files or directories, limiting audit activity to those chosen paths rather than a full database instance. |
Select Database
After completing the New Audit Job details, click Next to open the Select Database step, then use the Database Name dropdown to choose the database instance available on the system.
Other Job Settings
After selecting a database from the Database Name dropdown, the user clicks Next, and the wizard advances to the Other Job Settings pane, where rollover options and advisory locking configurations can be adjusted before proceeding.
Other Job Settings
| Settings | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Set the frequency when the logging should rollover.
|
|||||||||||||
|
The number of units of measure (Rollover Type) to use to determine next time ro rollover and create a new audit database. |
|||||||||||||
|
|
Included Directories and Files
After completing Other Job Settings and clicking Next, the Included Directories and Files pane allows selecting directories and files for auditing, defining monitored sources whose changes are tracked and recorded during job execution.
Included Directories and Files Settings
| Setting | Description |
|---|---|
|
Lists directories and files selected as audit sources. Click the |
Editing Selected Audit Job
Selecting an audit job in the Audit Logging Jobs list and clicking the
icon (Edit Selected Audit Job) opens the job configuration view, enabling review and modification of job details, rollover settings, and included source directories and files.
Editing Selected Audit Job Settings: Info
| Settings | Description |
|---|---|
|
Uniquely identifies the audit job for internal tracking. |
|
|
Audit Job name |
|
|
Clicking the |
Editing Selected Audit Job Settings: Other
| Settings | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Unit of measure to use to determine when to rollover. The frequency of the rollover will determine when a new audit database is created.
|
|||||||||||||
|
The number of units of measure (Rollover Type) to use to determine next time ro rollover and create a new audit database. |
|||||||||||||
|
|
Included Directories and Files
When clicked the Included tab lists directories and files actively monitored by the audit job, defining sources whose write and remove operations are captured during audit execution.
| Setting | Description |
|---|---|
|
Lists directories and files selected as audit sources. Clicking the |
Excluded Directories and Files
Selecting a file or directory in Included section, and clicking the
moves it to Excluded. Selecting an item in Excluded section and clicking the
restores it to Included.
| Value | Description |
|---|---|
|
Lists files and directories actively monitored and audited by the selected audit job. |
|
|
Lists files and directories explicitly excluded from auditing and change tracking operations. |
icon opens the file selection dialog, allowing selection of individual files. Selecting OK/ Open confirms choices and displays the selected directories and files in the Source table for inclusion in the audit job. After clicking Finish button, audit job appears in Audit Logging Jobs Pane.