Skip to main content
Aria Knowledge Central

Aggregated Usage Record Sync

  1. Last updated
  2. Save as PDF

This section details the activity log for Billing aggregated usage record sync Data feed records. Unlike the Account and Data Feed from core Aria to Aria Allegro, which use a publisher/consumer model with KAFKA topics, the Billing aggregated data sync uses a synchronous API call from Aria Allegro to core ARIA via the 'bulk_record_usage_m' API. Internally, Allegro uses the KAFKA topic between services, but the Allegro-Sync service makes a synchronous API call after retrieving the aggregated batch from the internal KAFKA topic.

Error handling and reprocessing rely on the actual error message sent by the core Aria API. The Billing aggregated usage section's view and review are covered in the Usage Operations guide. This section addresses Billing Aggregated usage records from a reprocessing perspective.

Refer to the Aggregate usage configuration for details. The scheduler will automatically aggregate the usage record based on the aggregation frequency configured.  

View Aggregated Usage Errored Activity

To view Catalog Sync Activity for failed batches, follow these steps:

  1. Click the Usage switch (Usage/Account toggle) in the navigation pane.
  2. Click the Billing Sync Reprocess option to expand its sub-menu in the navigation pane. For pre-R68 deployments, it appears under the Usage Activity option.
  3. Click the Aggregated usage option in the navigation pane. This refreshes the activity pane with aggregated usage data for reprocessing. Note that this view shows incomplete batches, including:
    1. In-process batches—The synchronous API may delay depending on batch size.
    2. Errored batches—Some records in an aggregated batch failed in Aria Allegro.

This is shown in the following screenshot:

AU-01.png

View Incomplete Aggregated Usage 

To view details of an incomplete Aggregated billing sync activity, follow these steps:

  1. Refer to the “View Aggregated usage Errored Activity” section.
  2. Locate the row to review and reprocess. Each row shows these details:
    1. Start date/time—start of the aggregated batch per the configured aggregation frequency.
    2. End date/time—end of the aggregated batch per the configured aggregation frequency.
    3. Total count—number of records in the batch.
    4. Completed count—number of records successfully processed by core Aria.
    5. Error count—number of records in the batch failed by core Aria.
    6. Pending count—number of records in the batch pending processing.
  3. Click the maximize icon on the left of the row to view the next level summary data by error code and status. It displays the following attributes:
    1. Total Count in incomplete state for the batch
    2. Sync Error Code—Blank for Pending records or shows the error code for errored state.
    3. Sync Error Message—Message corresponding to the error code.
    4. Status—Status of the row.
    5. To view detailed records for the row, refer to the “Billing Aggregated Usage Records” section using the aggregated batch, error code, and status filters. This data is large, so details are available in one place only.

This is shown in the screenshot below:

AU-02.png

Incomplete Aggregated Usage Status Values

The status values for Catalog activity logs are:

  1. COMPLETE—The record was processed successfully by Aria Allegro.
  2. ERROR—The record failed processing in Aria Allegro. ERROR code and message accompany errored activity logs.
  3. IGNORED—Aria Allegro ignored the activity log. These appear only if Data Feed configuration enables messages for data Aria Allegro excludes. Adjust core Aria configuration to hide these.
  4. INCOMPLETE—This status is available but should not appear in Aria Allegro activity logs.
  5. PENDING—Aria Allegro has not processed the data feed activity yet. This transient state rarely appears. 

Filters for Catalog Sync Activity

The default UI search displays the latest activities first. As data grows, use these filters to narrow your review:

  1. Start Date—Select or enter the start date to filter incomplete batches. This filter includes batches on or after the input date at 00:00:00.
  2. End Date—Select or enter the end date to filter incomplete batches. This filter includes batches before the input date at 00:00:00.
  3. Sync Status—Select the sync status from the drop-down list for an exact match filter.

Sort Attributes for Catalog Sync Activity

The default UI search lists data with the latest activities first. As data grows, apply these filters to narrow your review:

  1. Id—Sort ascending or descending by activity log ID.
  2. Status—Sort ascending or descending by activity log status.
  3. Action Name—Sort ascending or descending by activity log action name.
  4. Object Name—Sort ascending or descending by activity log object name.

To Reprocess Incomplete Aggregate usage batch

Aria Allegro supports multiple reprocessing levels for Incomplete Aggregate usage batches, depending on prior error resolutions. Upon successful reprocessing, the UI refreshes to hide activity logs processed at that level. Supported levels include:

  1. Reprocess-All: Click the Reprocess button in the header to reprocess all summary data.
  2. Reprocess at Batch level: Select the row in the table and click the Reprocess button at the row level to reprocess row summary data.
  3. Reprocess at Error Summary level: Expand the summary row using the maximize icon to view error details. Click the Reprocess button for the specific error code and status combination. Repeat for other errors under the same object as needed.
TOP
  1. Back to top
  • Was this article helpful?

Recommended articles

  1. Page type
    Topic
  2. Tags
    1. allegro
    2. rating
    3. usage