Skip to content

Latest commit

 

History

History
 
 

README.md

Agent Check: Openstack_controller

Overview

This check monitors Openstack from the controller node.

Setup

Follow the instructions below to install and configure this check for an Agent running on a host. For containerized environments, see the Autodiscovery Integration Templates for guidance on applying these instructions.

Installation

The Openstack_controller check is included in the Datadog Agent package, so you do not need to install anything else on your server.

Configuration

Prepare OpenStack

Create a datadog user that is used in your openstack_controller.d/conf.yaml file. This user requires admin read only permissions across your environment so that it can be run from a single node and read high level system information about all compute nodes and servers.

Deployment Strategy

The openstack_controller integration is designed to collect information from all compute nodes and the servers running on them. This integration is designed to be run from a single Agent to monitor your openstack environment. This can be deployed on your controller node or an adjacent server that has access to the Keystone and Nova endpoints.

  1. Edit the openstack_controller.d/conf.yaml file, in the conf.d/ folder at the root of your Agent's configuration directory to start collecting your openstack_controller performance data. See the sample openstack_controller.d/conf.yaml for all available configuration options.

  2. Restart the Agent

Validation

Run the Agent's status subcommand and look for openstack_controller under the Checks section.

Data Collected

Metrics

See metadata.csv for a list of metrics provided by this integration.

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.

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.

openstack.keystone.api.up

Returns CRITICAL if the Agent is unable to query the Keystone API. Returns OK otherwise.

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.

openstack.neutron.network.up

Returns CRITICAL if the Network is down. Returns OK otherwise.

Events

Openstack_controller does not include any events.

Troubleshooting

Need help? Contact Datadog support.