Audit Data Field Mapping Properties

During MATRIXX Engine configuration, you can extend the MtxAuditData MATRIXX Data Container (MDC) to create custom MDCs with additional fields that are populated with audit data that is written to transaction log files.

You can extend the MtxAuditData MDC to include custom fields and copy the following information to those fields:
  • The Diameter Ro or 5G message.
  • The device, subscriber, group, and user object.
  • The session object (including any extension).
  • Usage event ID, aggregation object ID, and raw usage quantity.
The service type definition specifies which fields are used to populate the additional fields in the custom MDC. You can specify audit data for usage per service type. Audit Data Field Mapping Properties describes the audit data field mapping properties.
Table 1. Audit Data Field Mapping Properties
Property Definition Data Type
Source Container The name of the MDC containing the field to map to the audit data MDC. This is required if the audit data MDC parent does not already contain the field.
The Source Container Name must be one of the following MDCs or an extension of it.
  • Mtx5GMultiUnitInfoData
  • Mtx5GMultiUnitUsageData
  • Mtx5GRequest
  • Mtx5GResponse
  • MtxChrgCompWorkspace
  • MtxChrgMsgWorkspace
  • MtxChrgSegWorkspace
  • MtxChargingSessionExtension
  • MtxDeviceObject
  • MtxGroupObject
  • MtxMsg
  • MtxMultiServiceData
  • MtxPolicySessionExtension
  • MtxSessionContextData
  • MtxSubscriberObject
  • MtxTenantProfile
  • MtxUserExtension
  • MtxUserObject
  • MtxWalletObject
The MtxMultiServiceData MDC allows administrators to populate Event Detail Records (EDRs) with fields from specific service contexts. The source field must be located in the MultiServiceList element (in the message MDC) for a service context. 		String
Source Field The name of the MDC field containing the usage data to copy to the audit data MDC.

The value is the full path of the field in the MDC, separated by a dot (.). The first element in the array is used to get the value of the event_field_name field. For example, if a field is nested in an array, the syntax is array_field_name.event_field_name.

String
Source Tier (Optional) The name of a tier (level) within a group hierarchy if the source container is a group object. Only group objects above the event initiator in the hierarchy can be source containers. Set the source tier in situations where there is a field, such as an account number associated with a group, that must be included in the subscriber events of its group members. String
Destination Container The name of the MDC generated during service usage to hold the audit data. This can be the MDC selected in Audit Data Container Name or a private MDC derived from it. String
Destination Field The name of the field in the audit data MDC in which to copy the usage event data.

The value is the full path of the field in the MDC, separated by a dot (.).

 String