Tracking Message Pack Consumption in Oracle Integration Cloud (OIC – Gen3)
Oracle Integration Cloud (OIC) licensing is based on message packs, which makes monitoring message consumption a critical activity for organizations aiming to control costs and avoid unexpected overages.
Integration leads, architects, and platform administrators frequently ask:
Is there a dashboard in OIC that shows message pack consumption?
The answer is yes, but with some constraints. While OIC does not currently offer a detailed, integration-level billing dashboard directly within the OIC console, Oracle Cloud Infrastructure (OCI) provides Monitoring and Metrics capabilities that enable organizations to track message usage at the service instance level.
This blog explains:
- The types of message consumption metrics currently available
- Where and how billing-related metrics can be viewed
- Common misunderstandings around OIC message tracking
- How to build custom monitoring charts for deeper insight
Understanding Message Pack Consumption in OIC
Message packs are the fundamental unit used for OIC billing. Each message processed—whether inbound or outbound—contributes to overall consumption. Usage varies depending on the capabilities involved, such as integrations, connectivity agents, lookups, or B2B flows.
Important Considerations
At present, OIC does not expose:
- Billing metrics at the individual integration or flow level
- Native alerts that notify administrators when message pack limits are close to being reached
Because of these limitations, Oracle recommends leveraging OCI Monitoring metrics to observe usage patterns and assess overall consumption trends.
How to view Service Instance and Billing Message Metrics
Oracle provides built-in monitoring metrics that allow customers to track message usage for each OIC service instance.
To View the Message Metrics
- Sign in to the Oracle Cloud Console.
- Access the Oracle Integration service from the available cloud services.
- Select the Oracle Integration instance you want to review.
- Navigate to the Monitoring section on the instance details page.
The Monitoring view displays predefined charts with standard filters applied.
Key Message Consumption Metrics Explained
| Metric | Description |
|---|---|
| Configured messages | Represents the total number of billing messages available to the instance, calculated based on the number of message packs purchased and the messages included per pack. |
| Total consumed message packs | Reflects the cumulative message packs used by the instance, including consumption related to disaster recovery. |
| Total consumed messages | Indicates the total number of billing messages processed across OIC components, excluding Visual Builder and disaster recovery usage. |
Creating Custom Billing Charts for Enhanced Visibility
While default monitoring charts provide basic insights, organizations with multiple teams, environments, or compartments often require more targeted visibility into Oracle Integration Cloud (OIC) message consumption.
Custom billing charts help teams better understand usage patterns and make data-driven decisions for governance, capacity planning, and cost optimization.
By creating custom metric charts, you can:
- Analyze message usage by compartment
- Identify environments or teams with higher consumption
- Validate whether current message pack purchases align with actual usage
- Improve cost transparency across integration landscapes
Create Custom Billing Charts
Custom Billing Charts can be created from existing monitoring charts by adding or updating query parameters in OIC Metrics Explorer.
Configuring Custom Metric Queries
While defining Metric Queries, the following parameters can be used to modify the custom metric query:
| Parameter | Description |
|---|---|
| Compartment | The compartment that contains the Oracle Integration instance. |
| Metric namespace | Identifies the source service for the metric. For OIC metrics, use oci_integration. |
| Metric name | Specifies the metric to visualize. Available options depend on OIC’s supported metrics. |
| Interval | Determines the aggregation window for data points. |
| Statistic | Defines how data points are aggregated (for example, sum or mean). |
| Dimension name | Applies a filter to the selected metric. Available dimensions vary by metric type. |
| Dimension value | The specific value associated with the selected dimension, such as a resource identifier. |
Once the query is configured, you can visualize data in the chart.
Viewing and Interpreting Custom Metric Charts
Custom charts enable teams to:
- Monitor historical message consumption trends
- Compare usage across compartments or environments
- Detect spikes related to business events, batch jobs, or large integrations
These insights are particularly valuable during:
- Quarterly or annual cost reviews
- Capacity planning initiatives
- Large-scale integration deployments or migrations
Key Takeaways
- OIC message consumption is tracked at the service instance level, not at the individual integration level
- The OCI Monitoring interface is the primary source for billing-related metrics
- Custom metric charts offer greater flexibility for governance and cost analysis
- Proactive monitoring helps prevent unexpected message pack overages
Conclusion
Although Oracle Integration Cloud does not currently provide a dedicated, granular message pack dashboard within the OIC console, OCI Monitoring offers robust capabilities for tracking and analyzing message consumption. By combining built-in metrics with custom monitoring charts, integration teams can maintain visibility into usage patterns, manage costs effectively, and plan future capacity with confidence.
