Datadog V3
This integration exports Prometheus metrics from your CloudAMQP cluster to Datadog, delivered via our OpenTelemetry Collector.
To configure metrics to Datadog, go to
app.datadoghq.com
to get your
Datadog API key
and enter it when creating the integration.
All metrics are exported with the labels/tags instance and cluster, which are populated with the name of the server and cluster. You can also set custom tags when configuring the integration.
Exported server metrics
| Metric | Metric labels | CloudAMQP labels |
|---|---|---|
| system_cpu_utilization_ratio | state | instance, cluster |
| system_disk_io_bytes_total | direction | instance, cluster |
| system_disk_operation_time_seconds_total | direction | instance, cluster |
| system_disk_operations_total | direction | instance, cluster |
| system_filesystem_usage_bytes | state | instance, cluster |
| system_filesystem_utilization_ratio | instance, cluster | |
| system_memory_usage_bytes | state | instance, cluster |
| system_memory_limit_bytes | instance, cluster | |
| system_network_io_bytes_total | direction | instance, cluster |
| system_paging_usage_bytes | state | instance, cluster |
Exported LavinMQ metrics
| Metric | Metric labels | CloudAMQP labels |
|---|---|---|
| lavinmq_global_messages_acknowledged_total | protocol, queue_type | instance, cluster |
| lavinmq_global_messages_delivered_total | protocol, queue_type | instance, cluster |
| lavinmq_global_messages_redelivered_total | protocol, queue_type | instance, cluster |
| lavinmq_global_messages_confirmed_total | protocol | instance, cluster |
| lavinmq_connections | instance, cluster | |
| lavinmq_channels | instance, cluster | |
| lavinmq_consumers | instance, cluster | |
| lavinmq_disk_space_available_bytes | instance, cluster | |
| lavinmq_process_open_fds | instance, cluster | |
| lavinmq_process_resident_memory_bytes | instance, cluster | |
| lavinmq_queues | instance, cluster | |
| lavinmq_queue_messages | instance, cluster | |
| lavinmq_queue_messages_ready | instance, cluster | |
| lavinmq_queue_messages_unacked | instance, cluster |
Exported RabbitMQ metrics
| Metric | Metric labels | CloudAMQP labels |
|---|---|---|
| rabbitmq_global_messages_acknowledged_total | protocol, queue_type | instance, cluster |
| rabbitmq_global_messages_delivered_total | protocol, queue_type | instance, cluster |
| rabbitmq_global_messages_delivered_get_manual_ack_total | protocol, queue_type | instance, cluster |
| rabbitmq_global_messages_delivered_get_auto_ack_total | protocol, queue_type | instance, cluster |
| rabbitmq_global_messages_redelivered_total | protocol, queue_type | instance, cluster |
| rabbitmq_global_messages_confirmed_total | protocol | instance, cluster |
| rabbitmq_global_messages_unroutable_dropped_total | protocol | instance, cluster |
| rabbitmq_global_messages_unroutable_returned_total | protocol | instance, cluster |
| rabbitmq_alarms_memory_used_watermark | instance, cluster | |
| rabbitmq_alarms_free_disk_space_watermark | instance, cluster | |
| rabbitmq_connections | instance, cluster | |
| rabbitmq_channels | instance, cluster | |
| rabbitmq_consumers | instance, cluster | |
| rabbitmq_disk_space_available_bytes | instance, cluster | |
| rabbitmq_exchange_messages_published_total | instance, cluster | |
| rabbitmq_process_open_fds | instance, cluster | |
| rabbitmq_process_resident_memory_bytes | instance, cluster | |
| rabbitmq_queues | instance, cluster | |
| rabbitmq_queue_get_total | instance, cluster | |
| rabbitmq_queue_get_ack_total | instance, cluster | |
| rabbitmq_queue_messages | instance, cluster | |
| rabbitmq_queue_messages_acked_total | instance, cluster | |
| rabbitmq_queue_messages_delivered_ack_total | instance, cluster | |
| rabbitmq_queue_messages_persistent | instance, cluster | |
| rabbitmq_queue_messages_published_total | instance, cluster | |
| rabbitmq_queue_messages_ready | instance, cluster | |
| rabbitmq_queue_messages_unacked | instance, cluster | |
| rabbitmq_queue_head_message_timestamp | instance, cluster |
Metrics Filtering
The metrics listed above are the metrics exported by default. However, you can use the metrics_filter endpoint to specify exactly which metrics you want to export. See the API documentation for more details.
The complete list of available metrics that can be included in the metrics filter includes:
- All metrics available from the server’s
/metricsendpoint (broker metrics) - All metrics available from the server’s
/metrics/detailedendpoint (detailed broker metrics). Note: Detailed metrics can be resource-intensive on servers with many objects such as connections and queues. - Server metrics:
system_cpu_utilization_ratiosystem_disk_io_bytes_totalsystem_disk_operation_time_seconds_totalsystem_disk_operations_totalsystem_filesystem_usage_bytessystem_filesystem_utilization_ratiosystem_memory_limit_bytessystem_memory_usage_bytessystem_linux_memory_available_bytessystem_network_io_bytes_totalsystem_paging_usage_bytes
Histograms and summaries are selected by their family name, for example
rabbitmq_message_size_bytes for the RabbitMQ message size histogram. The
collector merges the bucket, sum and count series into that single metric,
so listing the family name exports all of them. The full list of names
accepted by the filter for your instance is available from the
valid_metrics
endpoint.
RabbitMQ Dashboard Metrics Format
When creating a Datadog V3 integration via the API, you can set the
rabbitmq_dashboard_metrics_format
parameter to
true
to transform specific RabbitMQ metrics to match the naming convention expected by
Datadog’s RabbitMQ dashboard. This transformation only applies if the metrics are
included in your metrics filter.
The following RabbitMQ metrics will be transformed when
rabbitmq_dashboard_metrics_format=true
and they are included in the metrics filter:
| Original Metric Name | Transformed Metric Name (Datadog Dashboard Format) |
|---|---|
| erlang_vm_port_count | rabbitmq.erlang.vm.port_count |
| erlang_vm_port_limit | rabbitmq.erlang.vm.port_limit |
| erlang_vm_process_count | rabbitmq.erlang.vm.process_count |
| erlang_vm_process_limit | rabbitmq.erlang.vm.process_limit |
| rabbitmq_channels | rabbitmq.channels |
| rabbitmq_channel_messages_delivered_ack_total | rabbitmq.channel.messages.delivered.ack.count |
| rabbitmq_channel_messages_delivered_total | rabbitmq.channel.messages.delivered.count |
| rabbitmq_channel_messages_published_total | rabbitmq.channel.messages.published.count |
| rabbitmq_channel_messages_unacked | rabbitmq.channel.messages.unacked |
| rabbitmq_channel_messages_unroutable_dropped_total | rabbitmq.channel.messages.unroutable.dropped.count |
| rabbitmq_connection_incoming_packets_total | rabbitmq.connection.incoming_packets.count |
| rabbitmq_connection_outgoing_packets_total | rabbitmq.connection.outgoing_packets.count |
| rabbitmq_connection_pending_packets | rabbitmq.connection.pending_packets |
| rabbitmq_connections_closed_total | rabbitmq.connections.closed.count |
| rabbitmq_connections_opened_total | rabbitmq.connections.opened.count |
| rabbitmq_detailed_process_max_tcp_sockets | rabbitmq.process.max_tcp_sockets |
| rabbitmq_detailed_process_open_tcp_sockets | rabbitmq.process.open_tcp_sockets |
| rabbitmq_detailed_queue_consumer_utilisation | rabbitmq.queue.consumer_utilisation |
| rabbitmq_detailed_queue_consumers | rabbitmq.queue.consumers |
| rabbitmq_detailed_queue_messages | rabbitmq.queue.messages |
| rabbitmq_detailed_queue_messages_acked_total | rabbitmq.queue.messages.acked.count |
| rabbitmq_detailed_queue_messages_delivered_total | rabbitmq.queue.messages.delivered.count |
| rabbitmq_detailed_queue_messages_paged_out | rabbitmq.queue.messages.paged_out |
| rabbitmq_detailed_queue_messages_persistent | rabbitmq.queue.messages.persistent |
| rabbitmq_detailed_queue_messages_published_total | rabbitmq.queue.messages.published.count |
| rabbitmq_detailed_queue_messages_ready | rabbitmq.queue.messages.ready |
| rabbitmq_detailed_queue_messages_redelivered_total | rabbitmq.queue.messages.redelivered.count |
| rabbitmq_detailed_queue_messages_unacked | rabbitmq.queue.messages.unacked |
| rabbitmq_disk_space_available_bytes | rabbitmq.disk_space.available_bytes |
| rabbitmq_global_consumers | rabbitmq.global.consumers |
| rabbitmq_process_max_fds | rabbitmq.process.max_fds |
| rabbitmq_process_open_fds | rabbitmq.process.open_fds |
| rabbitmq_process_resident_memory_bytes | rabbitmq.process.resident_memory_bytes |
| rabbitmq_queues | rabbitmq.queues |
| rabbitmq_queues_created_total | rabbitmq.queues.created.count |
| rabbitmq_queues_declared_total | rabbitmq.queues.declared.count |
| rabbitmq_queues_deleted_total | rabbitmq.queues.deleted.count |
| rabbitmq_resident_memory_limit_bytes | rabbitmq.resident_memory_limit_bytes |