Note: This integration only applies to OpenStack v12 and below (non-containerized OpenStack). If you are looking to collect metrics from OpenStack v13+ (containerized OpenStack), use the OpenStack Controller integration.
Get metrics from OpenStack service in real time to:
Visualize and monitor OpenStack states.
Be notified about OpenStack failovers and events.
Setup
Installation
To capture your OpenStack metrics, install the Agent on your hosts running hypervisors.
Configuration
Prepare OpenStack
Configure a Datadog role and user with your identity server:
openstack role create datadog_monitoring
openstack user create datadog \
--password my_password \
--project my_project_name
openstack role add datadog_monitoring \
--project my_project_name \
--user datadog
Then, update your policy.json files to grant the needed permissions. role:datadog_monitoring requires access to the following operations:
Nova
{"compute_extension":"aggregates","compute_extension":"hypervisors","compute_extension":"server_diagnostics","compute_extension":"v3:os-hypervisors","compute_extension":"v3:os-server-diagnostics","compute_extension":"availability_zone:detail","compute_extension":"v3:availability_zone:detail","compute_extension":"used_limits_for_admin","os_compute_api:os-aggregates:index":"rule:admin_api or role:datadog_monitoring","os_compute_api:os-aggregates:show":"rule:admin_api or role:datadog_monitoring","os_compute_api:os-hypervisors":"rule:admin_api or role:datadog_monitoring","os_compute_api:os-server-diagnostics":"rule:admin_api or role:datadog_monitoring","os_compute_api:os-used-limits":"rule:admin_api or role:datadog_monitoring"}
Neutron
{"get_network":"rule:admin_or_owner or rule:shared or rule:external or rule:context_is_advsvc or role:datadog_monitoring"}
Keystone
{"identity:get_project":"rule:admin_required or project_id:%(target.project.id)s or role:datadog_monitoring","identity:list_projects":"rule:admin_required or role:datadog_monitoring"}
You may need to restart your Keystone, Neutron, and Nova API services to ensure that the policy changes take.
Note: Installing the OpenStack integration could increase the number of VMs that Datadog monitors. For more information on how this may affect your billing, see the Billing FAQ.
Agent configuration
Configure the Datadog Agent to connect to your Keystone server, and specify individual projects to monitor. Edit the openstack.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory with the configuration below. See the sample openstack.d/conf.yaml for all available configuration options:
init_config:## @param keystone_server_url - string - required## Where your identity server lives.## Note that the server must support Identity API v3#keystone_server_url:"https://<KEYSTONE_SERVER_ENDPOINT>:<PORT>/"instances:## @param name - string - required## Unique identifier for this instance.#- name:"<INSTANCE_NAME>"## @param user - object - required## User credentials## Password authentication is the only auth method supported.## `user` object expects the parameter `username`, `password`,## and `user.domain.id`.#### `user` should resolve to a structure like:#### {'password': '<PASSWORD>', 'name': '<USERNAME>', 'domain': {'id': '<DOMAINE_ID>'}}#user:password:"<PASSWORD>"name:datadogdomain:id:"<DOMAINE_ID>"
The total number of security groups used by this tenant
openstack.nova.running_vms (gauge)
Number of running VMs on this hypervisor host
openstack.nova.vcpus (gauge)
Number of vCPUs available on this hypervisor host
openstack.nova.vcpus_used (gauge)
Number of vCPUS used on this hypervisor host
openstack.nova.server.hdd_errors (gauge)
The number of errors seen by the server when accessing an HDD device
openstack.nova.server.hdd_read_req (gauge)
The number of read requests made to an HDD device by this server
openstack.nova.server.hdd_write_req (gauge)
The number of write requests made to an HDD device by this server
openstack.nova.server.vda_errors (gauge)
The number of errors seen by the server when accessing a VDA device
openstack.nova.server.vda_read_req (gauge)
The number of read requests made to a VDA device by this server
openstack.nova.server.vda_write_req (gauge)
The number of write requests made to a VDA device by this server
openstack.nova.limits.max_total_ram_size (gauge)
The max allowed RAM size for this tenant in megabytes (MB) Shown as mebibyte
openstack.nova.limits.total_ram_used (gauge)
The current RAM used by this tenant in megabytes (MB) Shown as mebibyte
openstack.nova.local_gb (gauge)
The size in GB of the ephemeral disk present on this hypervisor host Shown as gibibyte
openstack.nova.local_gb_used (gauge)
The size in GB of disk used on this hypervisor host Shown as gibibyte
openstack.nova.memory_mb (gauge)
The size in MB of RAM present on this hypervisor host Shown as mebibyte
openstack.nova.memory_mb_used (gauge)
The size in MB of RAM used on this hypervisor host Shown as mebibyte
openstack.nova.server.hdd_read (gauge)
Number of bytes read from an HDD device by this server Shown as byte
openstack.nova.server.hdd_write (gauge)
Number of bytes written to an HDD device by this server Shown as byte
openstack.nova.server.vda_read (gauge)
Number of bytes read from a VDA device by this server Shown as byte
openstack.nova.server.vda_write (gauge)
Number of bytes written to a VDA device by this server Shown as byte
openstack.nova.server.memory (gauge)
The amount of memory in MB provisioned for this server Shown as mebibyte
openstack.nova.server.memory_actual (gauge)
The amount of memory in MB provisioned for this server Shown as mebibyte
openstack.nova.server.memory_rss (gauge)
The amount of memory used by the processes of this server that is not associated with disk pages - such as stack and heap memory Shown as mebibyte
openstack.nova.server.cpu0_time (gauge)
CPU time in nanoseconds of this virtual CPU Shown as nanosecond
Events
The OpenStack check does not include any events.
Service Checks
openstack.neutron.api.up Returns CRITICAL if the Agent is unable to query the Neutron API, UNKNOWN if there is an issue with the Keystone API. Returns OK otherwise. Statuses: ok, critical, unknown
openstack.nova.api.up Returns CRITICAL if the Agent is unable to query the Nova API, UNKNOWN if there is an issue with the Keystone API. Returns OK otherwise. Statuses: ok, critical, unknown
openstack.keystone.api.up Returns CRITICAL if the Agent is unable to query the Keystone API. Returns OK otherwise. Statuses: ok, critical
openstack.nova.hypervisor.up Returns UNKNOWN if the Agent is unable to get the Hypervisor state, CRITICAL if the Hypervisor is down. Returns OK otherwise. Statuses: ok, critical, unknown
openstack.neutron.network.up Returns UNKNOWN if the Agent is unable to get the Network state, CRITICAL if the Network is down. Returns OK otherwise. Statuses: ok, critical, unknown