Usage Master Data

View Usage Master Data

To view the Usage Master data and the data for a specific file loaded, perform the following steps:

1. Click the Usage switch (Usage/Account toggle) in the navigation pane.
2. Click the Usage Activity option to expand its sub-menu in the navigation pane.
3. Click the Usage Data menu option in the navigation pane.
4. Click the Usage Master Data tab in the activity pane.
5. The system displays current or past files ingested for the client in a table.

This is shown in the following screenshot:

View Details of a Specific Usage File

1. Navigate using “To view Usage Master Data” to see configured source platforms.
2. Use search filters and pagination to locate your file.
3. Click the Maximize button (right arrow icon) on the file to expand stages and statistics. The three processing phases are:
   1. Parse and Load—parsing and loading usage files.
   2. Mediation—converting raw usage data into Allegro usage container and applying mediation rules.
   3. Rating—engine applying rating and, in the future, discounting, commissions, and revenue sharing.
4. Each phase displays these counts for audit and traceability:
   1. Total count—total records for the phase, usually equal to the previous phase's Processed count.
   2. Processed count—count of successfully processed usage records.
   3. Ignored Count—for Mediation phase, records filtered out (not monetized) are marked IGNORED.
   4. Suspended Count—for Rating phase, records that failed processing and can be reprocessed.
   5. Error Count—for Parse and Load and Mediation phases. Errored records appear in the Raw Usage Data report.
      1. Parse and Load errors indicate usage files or records are misplaced, misformatted, or do not match mapping configuration. The Raw Usage Data lists errored records.
      2. Mediation errors suggest incorrect mapping or misconfigured mediation rules.
      3. Usage processing errors have various causes and can be reviewed and reprocessed.

Filter Attributes for the Master Usage Data

• Source Platform: Select the source platform from the drop-down list to search the master usage data. This is an exact match filter.
• File Name: If you know the naming convention, enter the partial or full file name to search. This is a case-insensitive partial match filter.
• Start date: Enter or select the start date to search for processed files. The start date is inclusive (>= 00:00:00 hours). This is a greater than or equal to filter.
• End date: Enter or select the end date to search for processed files. The end date is exclusive (< 00:00:00 hours). This is a less than filter.

Sort Attributes For The Master Usage Data

• Source Platform: Sort ascending or descending by source platform name.
• File Name: Sort ascending or descending by file name.

By default, the engine sorts descending by date/time.

Load usage file

To load usage file using Allegro UI:

1. Navigate using “To view existing usage master data”.
2. Click the Upload file button at the top-left of the activity pane to open the upload drawer.
3. Select the Source platform from the drop-down list for the file upload.
4. If the source platform supports one service-type, it is auto-selected. Otherwise, select the service type from the drop-down list, dynamically populated based on the source platform.
5. If the source platform and service type support one usage record type (pre-rated, postpaid, or future prepaid types), it is auto-selected. Otherwise, select the usage record type from the drop-down list, dynamically populated based on the source platform and service type.
6. To upload a file,
   1. Drag and drop the file into the upload window OR
   2. Click the upload window to open a File Manager and select the file.
7. Allegro UI displays the file (maximum file size not yet tested).
8. Click Save to process the file. This copies it to the corresponding S3 folder. Apache NIFI automatically picks up and processes the file.
9. The UI returns to the main activity pane. Processing starts once Apache NIFI picks up the file.
10. Use the Refresh Icon to update the master usage data search output and see the file processing status (may take a few seconds).
11. Once the file appears in the search output, use the maximize button to view processing stages and statistics. For larger files, a Refresh icon is available at the file row level to update statistics.
12. After processing, you can load more files or view monetized usage records.