Usage Operations
This section details the usage activity any operator may need to view, review, or reprocess. Similar activities apply to test/demo setups.
This section covers:
- Usage Data files
- Viewing raw usage
- Viewing monetized usage records
- Viewing monetized non-usage records
- Aggregating for billing
- Billing aggregated usage
- Usage suspense management
- Usage Data Ingestion
- This article explains how Aria Allegro ingests usage data—primarily via files—with automation patterns using S3, Apache NIFI, Kafka, and mediation and usage processing services to transform raw records into monetized usage for billing. It also describes the required S3 folder structure, end-to-end file processing flow, and the audit and reconciliation capabilities that ensure traceability from raw usage records through to invoice lines and back.
- Usage Master Data
- This article explains how to use the Allegro UI to view, filter, sort, and drill into Usage Master Data files, including detailed processing statistics across Parse and Load, Mediation, and Rating phases for audit and troubleshooting. It also describes how to manually upload new usage files, track their ingestion and processing via Apache NiFi, and refresh the UI to monitor status and results.
- Manage Raw Usage Data
- This article explains how you can search, view, filter, and export raw usage data files in Allegro, with mandatory filters like source platform, service type, and usage record type to account for mediation mappings. It also describes the possible raw usage statuses (Pending, Failed, Processed) and provides step-by-step instructions for viewing suspended records and exporting results to Excel or PDF.
- Manage Monetized Usage Data
- This article explains how Aria Allegro generates and stores monetized usage records from rated usage data, including how currency, allowance, and accumulator impacts are applied and recorded for future discounting and billing. It also describes how users can view detailed monetized usage records, filter and sort them by various attributes, and export the resulting data to PDF or Excel.
- Manage Monetized Non-usage Data
- This article explains how Aria Allegro creates and manages monetized non-usage records generated from activation and recurring services, including their types, date/validity handling, and how they relate to allowances and accumulators. It also describes how to view, filter, sort, and export monetized non-usage data in the UI, plus how to drill into individual record details such as recurring data, proration scale, and related allowance/accumulator buckets.
- Aggregate and Send Monetized Usage for Billing
- This article explains how Allegro aggregates monetized usage records and sends them in batches to core Aria for invoicing via the bulk_record_usage_m API, including how Kafka and the Allegro Sync Service handle batch processing and error scenarios.
- Manage Billing Aggregate Usage Data
- This article describes how you can view and review aggregated usage data that has been grouped and sent from Allegro to core Aria for invoicing, including how aggregation affects quantities, prices, and amounts and how individual monetized records link back to aggregation batches. It also explains how to access detailed views, interpret sync statuses and error codes from the bulk_record_usage_m API, and use filtering and sorting options to analyze aggregated usage records efficiently.
- Usage Suspense Management
- This article explains how Allegro's Usage Suspense Management handles usage records that error during rating by placing them in suspense until underlying configuration or timing issues are resolved, preserving the audit trail of all source records. It describes common suspense causes, how to view and filter suspended data, and how authorized users can reprocess or discard records at file, error-code, or individual-record level.