If you can't find the product or version you're looking for, visit support.ataccama.com/downloads

Configuring Audit Log

The audit log allows you to see the actions performed in MDM Web App and can be stored in a table or displayed in the server console. It is possible to configure which MDM Web App user actions are logged.

To configure the MDM Web App audit log:

Open the MDM Engine project in ONE Desktop.
Go to GUI Configuration > Auditing.

Select user actions that need to be audited:

Name	Description
Audit Event Types	Select All Events to log all audit events.
Templates Action	Reloading and dropping of templates.
Export Action	Exporting data.
Data Read	Viewing data, like opening a record detail or viewing search results.
Workflow Actions	Moving drafts through the workflow.
User Settings	Saving and using filters.
Draft Actions	All actions within drafts, for example, adding operations to drafts or deleting drafts.
Issue Actions	Actions performed on issues, for example, editing or moving issues through the resolution workflow.

Name

Description

Audit Event Types

Select All Events to log all audit events.

Templates Action

Reloading and dropping of templates.

Export Action

Exporting data.

Data Read

Viewing data, like opening a record detail or viewing search results.

Workflow Actions

Moving drafts through the workflow.

User Settings

Saving and using filters.

Draft Actions

All actions within drafts, for example, adding operations to drafts or deleting drafts.

Issue Actions

Actions performed on issues, for example, editing or moving issues through the resolution workflow.

For a list of auditable actions per category, see Full list of auditable actions.

The generated configuration file (mda-audit.gen.xml) is linked in mda-config.xml (see MDM Web App Backend).

Auditing settings in application properties

Additional auditing settings, for example, details of the event log table, can be configured in MDM Server application properties.

Name Default value Required Description

Name	Default value	Required	Description
`ataccama.one.mdm.audit.enabled`	TRUE	No	Enables or disables the event log.
`ataccama.one.mdm.audit.writters`	nmeAuditLogWriter,semanticLogWriter	No	Comma-separated list of audit writers. Allowed values are `nmeAuditLogWriter` (logging events into the database) and `semanticLogWriter` (logging events into the server console).
`ataccama.one.mdm.audit.nme.table`	EVENT_LOG	No	Event log table name. Prefixed with "I_" (according to NME persistence implementation).
`ataccama.one.mdm.audit.nme.sequence`	EVENT_LOG_SEQ	No	ID generator sequence name.
`ataccama.one.mdm.audit.nme.mapping.id`	id	No	Event log entry ID field name, automatically generated according to sequence. Default value used if no `mapping` properties are defined.
`ataccama.one.mdm.audit.nme.mapping.msg`	msg	No	Event log message field name. Default value used if no `mapping` properties are defined.
`ataccama.one.mdm.audit.nme.mapping.username`	username	No	Event log username field name. Default value used if no `mapping` properties are defined.
`ataccama.one.mdm.audit.nme.mapping.entity`	entity	No	Event log entity field name. Default value used if no `mapping` properties are defined.
`ataccama.one.mdm.audit.nme.mapping.date`	date	No	Event log date field name. Default value used if no `mapping` properties are defined.
`ataccama.one.mdm.audit.nme.mapping.operation`	operation	No	Event log operation field name. Default value used if no `mapping` properties are defined.
`ataccama.one.mdm.audit.nme.mapping.type`	type	No	Event log type field name. Default value used if no `mapping` properties are defined.
`ataccama.one.mdm.audit.nme.mapping.entity_id`	entity_id	No	Event log `entity_id` field name. Default value used if no `mapping` properties are defined.

ataccama.one.mdm.audit.enabled

TRUE

Enables or disables the event log.

ataccama.one.mdm.audit.writters

nmeAuditLogWriter,semanticLogWriter

Comma-separated list of audit writers. Allowed values are nmeAuditLogWriter (logging events into the database) and semanticLogWriter (logging events into the server console).

ataccama.one.mdm.audit.nme.table

EVENT_LOG

Event log table name. Prefixed with "I_" (according to NME persistence implementation).

ataccama.one.mdm.audit.nme.sequence

EVENT_LOG_SEQ

ID generator sequence name.

ataccama.one.mdm.audit.nme.mapping.id

Event log entry ID field name, automatically generated according to sequence. Default value used if no mapping properties are defined.

ataccama.one.mdm.audit.nme.mapping.msg

msg

Event log message field name. Default value used if no mapping properties are defined.

ataccama.one.mdm.audit.nme.mapping.username

username

Event log username field name. Default value used if no mapping properties are defined.

ataccama.one.mdm.audit.nme.mapping.entity

entity

Event log entity field name. Default value used if no mapping properties are defined.

ataccama.one.mdm.audit.nme.mapping.date

date

Event log date field name. Default value used if no mapping properties are defined.

ataccama.one.mdm.audit.nme.mapping.operation

operation

Event log operation field name. Default value used if no mapping properties are defined.

ataccama.one.mdm.audit.nme.mapping.type

type

Event log type field name. Default value used if no mapping properties are defined.

ataccama.one.mdm.audit.nme.mapping.entity_id

entity_id

Event log entity_id field name. Default value used if no mapping properties are defined.

Full list of auditable actions

Templates action

Action code	Description
TEMPLATES_RELOAD	Template is reloaded.
TEMPLATES_DROP	Template is dropped.

Action code

Description

TEMPLATES_RELOAD

Template is reloaded.

TEMPLATES_DROP

Template is dropped.

Export action

Action code	Description
EXPORT_ENTITY	User exports table data via Bulk Export.

Action code

Description

EXPORT_ENTITY

User exports table data via Bulk Export.

Export action example

--- export ---
2021-12-20 14:19:22,787 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Export action, operation=EXPORT_ENTITY, message={"ATTRIBUTES":{"ENTITY":"MASTER|masters|party"},"DATE":"Mon Dec 20 14:19:22 CET 2021","OPERATION":"EXPORT_ENTITY","REMOTE_ADDR":"127.0.0.1","USER":"admin","TYPE":"Export action"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@205f4d3

Data read

Action code	Description
READ_TABLES	User opens a table.
READ_ROW	User opens a record detail.
COMPARE_ROWS	User compares records.

Action code

Description

READ_TABLES

User opens a table.

READ_ROW

User opens a record detail.

COMPARE_ROWS

User compares records.

Data read examples

--- read ---
2021-12-20 09:10:28,877 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Data read, operation=READ_TABLES, message={"ATTRIBUTES":{"ENTITY":"MASTER|masters|party","FILTER":""},"DATE":"Mon Dec 20 09:10:28 CET 2021","OPERATION":"READ_TABLES","REMOTE_ADDR":"","USER":"admin","TYPE":"Data read"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@609dd6ab
2021-12-20 09:09:52,630 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Data read, operation=READ_ROW, message={"ATTRIBUTES":{"ENTITY":"MASTER|masters|contact","ID":"3980"},"DATE":"Mon Dec 20 09:09:52 CET 2021","OPERATION":"READ_ROW","REMOTE_ADDR":"","USER":"admin","TYPE":"Data read"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@744a0bc3

--- compare ---
2021-12-20 14:21:23,503 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Data read, operation=COMPARE_ROWS, message={"ATTRIBUTES":{"ENTITY":"MASTER|masters|address","VIEW NAME":{},"ID":"3694 3695 "},"DATE":"Mon Dec 20 14:21:23 CET 2021","OPERATION":"COMPARE_ROWS","REMOTE_ADDR":"","USER":"admin","TYPE":"Data read"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@1bbd8f3

Workflow action

Action code	Description
WORKFLOW_MOVE	Record is moved to a different workflow state.

Action code

Description

WORKFLOW_MOVE

Record is moved to a different workflow state.

User settings

Action code	Description
UI_ADDED_SAVED_FILTERS	Filter is saved.
UI_SAVED_FILTER_USED	Saved filter is used.

Action code

Description

UI_ADDED_SAVED_FILTERS

Filter is saved.

UI_SAVED_FILTER_USED

Saved filter is used.

Draft action

Action code	Description
DRAFT_READ	Draft is read.
DRAFT_CREATE	Draft is created.
DRAFT_UPDATE	Draft is updated.
DRAFT_PUBLISH	Draft is published.
DRAFT_PUBLISH_FAIL	Draft publishing fails.
DRAFT_DISCARD	Draft is discarded.
DRAFT_COMMENT	Draft is commented.

Action code

Description

DRAFT_READ

Draft is read.

DRAFT_CREATE

Draft is created.

DRAFT_UPDATE

Draft is updated.

DRAFT_PUBLISH

Draft is published.

DRAFT_PUBLISH_FAIL

Draft publishing fails.

DRAFT_DISCARD

Draft is discarded.

DRAFT_COMMENT

Draft is commented.

Draft action examples

--- draft ---
2021-12-20 09:09:52,499 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Draft action, operation=DRAFT_CREATE, message={"ATTRIBUTES":{"LABEL":"Contact master data issue - Supporting matching attributes are missing (Phone).","WORKFLOW":"consolidation"},"DATE":"Mon Dec 20 09:09:52 CET 2021","OPERATION":"DRAFT_CREATE","REMOTE_ADDR":"","USER":"admin","TYPE":"Draft action"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@47da875b
2021-12-20 09:56:46,137 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Draft action, operation=DRAFT_UPDATE, message={"ATTRIBUTES":{"LABEL":"ID 7437682322 (Master ID Document)DASGDASDSG","ID":"5","COMMENT":{}},"DATE":"Mon Dec 20 09:56:46 CET 2021","OPERATION":"DRAFT_UPDATE","REMOTE_ADDR":"","USER":"admin","TYPE":"Draft action"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@507866cc
2021-12-20 09:15:25,181 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Draft action, operation=DRAFT_READ, message={"ATTRIBUTES":{"ID":"4"},"DATE":"Mon Dec 20 09:15:25 CET 2021","OPERATION":"DRAFT_READ","REMOTE_ADDR":"","USER":"admin","TYPE":"Draft action"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@7297bada
2021-12-20 09:09:56,626 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Draft action, operation=DRAFT_DISCARD, message={"ATTRIBUTES":{"LABEL":"Contact master data issue - Supporting matching attributes are missing (Phone).","ID":"2","COMMENT":""},"DATE":"Mon Dec 20 09:09:56 CET 2021","OPERATION":"DRAFT_DISCARD","REMOTE_ADDR":"","USER":"admin","TYPE":"Draft action"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@20b4f2de
2021-12-20 14:23:04,832 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Draft action, operation=DRAFT_PUBLISH, message={"ATTRIBUTES":{"LABEL":"New Record","ID":"6","COMMENT":"dsgasdg"},"DATE":"Mon Dec 20 14:23:02 CET 2021","OPERATION":"DRAFT_PUBLISH","REMOTE_ADDR":"","USER":"admin","TYPE":"Draft action"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@bbf4b3

Issue action

Action code	Description
ISSUE_CREATE	Issue is created.
ISSUE_READ	Issue is read.
ISSUE_UPDATE	Issue is updated.
ISSUE_DELETE	Issue is deleted.
ISSUE_COMMENT	Issue is commented.

Action code

Description

ISSUE_CREATE

Issue is created.

ISSUE_READ

Issue is read.

ISSUE_UPDATE

Issue is updated.

ISSUE_DELETE

Issue is deleted.

ISSUE_COMMENT

Issue is commented.

Issue action examples

2021-12-20 09:22:32,832 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Issue action, operation=ISSUE_CREATE, message={"ATTRIBUTES":{"ENTITY":"INSTANCE|consent","ACTION":"created","ID":"2320","COMMENT":"Issue created by"},"DATE":"Mon Dec 20 09:22:32 CET 2021","OPERATION":"ISSUE_CREATE","REMOTE_ADDR":"","USER":"admin","TYPE":"Issue action"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@92e1417
2021-12-20 09:22:32,867 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Issue action, operation=ISSUE_READ, message={"ATTRIBUTES":{"ID":"74"},"DATE":"Mon Dec 20 09:22:32 CET 2021","OPERATION":"ISSUE_READ","REMOTE_ADDR":"","USER":"admin","TYPE":"Issue action"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@60c444f1
2021-12-20 09:27:04,858 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Issue action, operation=ISSUE_DELETE, message={"ATTRIBUTES":{"ID":"74"},"DATE":"Mon Dec 20 09:27:04 CET 2021","OPERATION":"ISSUE_DELETE","REMOTE_ADDR":"","USER":"admin","TYPE":"Issue action"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@6072cbc8
2021-12-20 09:27:39,395 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Issue action, operation=ISSUE_COMMENT, message={"ATTRIBUTES":{"ACTION":"commented","ID":"8","COMMENT":"asdgasgasgd"},"DATE":"Mon Dec 20 09:27:39 CET 2021","OPERATION":"ISSUE_COMMENT","REMOTE_ADDR":"","USER":"admin","TYPE":"Issue action"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@74394606
2021-12-20 09:28:06,692 INFO  [][][Auditor] c.a.m.s.a.SemanticLogWriter:41 - eventId=auditlog type=Issue action, operation=ISSUE_UPDATE, message={"ATTRIBUTES":{"ACTION":"assigned to paul.james","ASSIGNEE":"paul.james","ID":"8","COMMENT":"asdgdasgdasg"},"DATE":"Mon Dec 20 09:28:06 CET 2021","OPERATION":"ISSUE_UPDATE","REMOTE_ADDR":"","USER":"admin","TYPE":"Issue action"}, entry=com.ataccama.mda.services.config.MdaAuditConfiguration$1@62c3b095

Was this page useful?