ONE Desktop ONE DQG ONE MDM ONE RDM ONE Runtime Server
latest (15.1.0) 14.5.x 13.9.x 13.8.x 13.7.x 13.6.x 13.5.0 13.4.x 13.3.x 13.2.x
User Community Service Desk Downloads
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:

  1. Open the MDM Engine project in ONE Desktop.

  2. Go to GUI Configuration > Auditing.

  3. Select user actions that need to be audited:

    GUI Configuration Auditing tab
    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

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.

Full list of auditable actions

Templates action

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.
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.
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.

User settings

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.
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.
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?