Get metrics from openstack service in real time to:
- Visualize and monitor openstack states
- Be notified about openstack failovers and events.
Install the dd-check-openstack package manually or with your favorite configuration manager.
Installing the OpenStack Integration could increase the number of VMs that Datadog monitors. For more information on how this may affect your billing, please visit our Billing FAQ.
To capture OpenStack metrics you need to install the Datadog Agent on your hosts running hypervisors.
-
First 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 -
Update your policy.json files to grant the needed permissions.
role:datadog_monitoringrequires 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.
-
Configure the Datadog Agent to connect to your Keystone server, and specify individual projects to monitor. Edit
openstack.yaml. You can find a sample configuration in the conf.d directory in your agent install. See the sample openstack.yaml for all available configuration options.
Run the Agent's info subcommand and look for openstack under the Checks section:
Checks
======
openstack
-----------
- instance #0 [OK]
- Collected 39 metrics, 0 events & 7 service checks
The openstack check is compatible with all major platforms
See metadata.csv for a list of metrics provided by this integration.
The Openstack check does not include any event at this time.
The Openstack check does not include any service check at this time.
Need help? Contact Datadog Support.
To get a better idea of how (or why) to integrate your Nova OpenStack compute module with Datadog, check out our series of blog posts about it.
See also our blog posts: