You can monitor the health, capacity, and performance of your queues by using metrics , alarms , and notifications.
This topic describes the metrics emitted by the Queue service in the
oci_queue metric namespace.
The Queue service metrics help you measure the size and health of a queue. You can use metrics data to diagnose and troubleshoot queue issues.
In addition to metrics, you can also get queue statistics.
To view a default set of metrics charts in the Console, navigate to the queue you're interested in, and then click Metrics. You also can use the Monitoring service to create custom queries.
IAM policies: To monitor resources, you must be given the required type of access in a policy (IAM) written by an administrator. Policies are required for using the Console or the REST API with an SDK, CLI, or other tool. The policy must give you access to the monitoring services and the resources being monitored. When you try to perform an action, you might get a message that you don’t have permission or are unauthorized. Confirm with your administrator the type of access you've been granted and which compartment you should work in. For more information on user authorizations for monitoring, see the Authentication and Authorization section for the related service: Monitoring or Notifications.
The metrics listed on this page are automatically available for any queue you create. You do not need to enable monitoring on the resource to get these metrics.
Queue metrics include the following dimensions:
region: The region that the metrics apply to
resourceId: The OCID of the queue for which the metric applies
queueName: The name of queue that the metrics apply to
operation: The type of operation (PUT, GET, UPDATE, DELETE) that the metrics apply to
isVisible: Whether or not the metrics apply to a visible message
|Metric||Metric Display Name||Unit||Description||Dimensions|
||Total bytes in the queue||bytes||Bytes in the queue||
||Total messages in the queue||count||Count of messages in the queue||
||Messages transmitted/sec||count||Count of messages sent and received per queue||
||Requests success rate/sec||boolean||Indicates the success of the requests sent and received per queue||
||Requests latency||time (ms)||Latency of the requests to the queue||
||Requests throughput||bytes||Bytes sent and received per queue||
||Consumer lag||time (minutes)||Difference in time between the oldest message in the queue and the current time||
Using the Console
To view default metric charts for a single queue
- Open the navigation menu and click Developer Services. Under Application Integration, click Queues.
- On the left side of the screen, click Queues.
A list of existing queues is displayed.
- Click the name of a queue to display its Details page.
- Click Metrics.
The Metrics page displays a default set of charts for the current queue.
To view default metric charts for multiple queues
Here's how you view the metric charts:
- Open the navigation menu and click Observability & Management. Under Monitoring, click Service Metrics.
- For Compartment, select the compartment that contains the queues that you're interested in.
- For Metric namespace, select
The Service Metrics page displays a default set of charts for the selected metric namespace. For more information about the emitted metrics, see Available Metrics. You can also use the Monitoring service to create custom queries.
The Service Metrics page dynamically updates the page to show charts for each metric that is emitted by the selected metric namespace.