Ansible plugin for Server Density¶
The following objects can be created and updated in your Server Density account from within Ansible:
- Hosts/Devices with groups
- Services with groups
- Alerts for
- Device Groups
- Service Groups
- Notifications for alerts
There are plugin parameters to define how the plugin will behave:
- api_token: An API token from Server Density to authenticate yourself
- force (optional, defaults to False): If an object already exists whether it should be updated
- cache (optional, defaults to None): Fully qualified filename for a cache of der Server Density data
- cleanup (optional, defaults to False): Decides if undefined alerts in your Ansible inventory available at Server Density should be deleted
- readonly (optional, defaults to False): If set to True it will only read the current settings from SD and stores them in a temporary file and does nothing else. This is useful when you want to find out some variable names for alerts or similar things
- output (optional, defaults to False): If provided, all current settings that are currently set upstream at Server Density will be written in YAML to this file
Download (or clone) the file
serverdensity.py from the
action_plugins directory and copy that into your custom action plugins directory which is defined in
/etc/ansible/ansible.cfg. The default location for this is
This plugin can be used in playbooks or with the ansible script directly.
Simply include a task like this:
1 2 3 4 5
You may also be interested in the Server Density Role that I've written which in addition installs and configures the Server Density agent on your hosts and synchronizes your inventory with Server Density by utilizing this plugin.
From the ansible script¶
Your whole inventory gets synchronized with Server Density simply by using this command:
The final -vv parameter is inhancing the level of output on the console and with this plugin you'll get some quite useful information on what's going on in detail.
The following variables are required in order to use this plugin and you should define them somewhere in you inventory, e.g. in group_vars/all. Further configuration for device groups, services and alerts can be defined in variables too and they are fully documented in the Wiki.
Defines the Server Density URL of your account, e.g.