Ansible playbook to automatically deploy the Server Density agent, and start monitoring. https://www.serverdensity.com
Switch branches/tags
Clone or download
Pull request Compare This branch is 33 commits ahead, 1 commit behind CorbanR:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
inventories
roles/serverdensity
README.md
serverdensity.yml

README.md

ansible-serverdensity

Ansible playbook for automatically deploying the Server Density agent.

Requirements

Ansible >= 1.9

Platforms

  • Debian/Ubuntu
  • Redhat/CentOS

Usage

This playbook will install the Server Density v2 agent, allowing for custom configuration and server grouping.

Whats new

  • Now installs Server Density agent v2.
  • Added upgrade logic.
  • Added options for Server Density plugin installation.
  • Updated syntax (yaml)

Required Setup

Create an API token using these directions.

Edit the following files:

  • roles/serverdensity/vars/main.yml #Required
  • inventories/hosts #Required
  • serverdensity.yml
  • roles/serverdensity/templates/conf.d/* #Only need to update if you choose to install official plugins.

Upgrade v_1 to v_2

To Upgrade v_1 to v_2 set following variable upgrade_v2: yes.

If this is a fresh install do NOT set the variable.

Configuration Examples

There are many different ways to set or overwrite Ansible variables. These are only a few examples. For more information about setting variables, read the official Ansible Documentation.

Example Ansible command: ansible-playbook -i inventories/hosts serverdensity.yml

Example Ansible command(Upgrade): ansible-playbook -i inventories/hosts serverdensity.yml --extra-vars "upgrade_v2=yes"

Example: Setting group_name via the inventories/hosts file:

[development]
hostname ansible_ssh_host=ip_of_host
[development:vars]
group_name=development_servers

Example: Setting group_name via a role parameter:

- hosts: development
  gather_facts: yes
  sudo: yes
  roles:
    - { role: serverdensity, group_name: "development_servers" }

Example: Setting group_name and other variables via playbook variables:

- hosts: development
  gather_facts: yes
  sudo: yes
  vars:
    group_name: "development_servers"
    plugins:
      - apache
      - nginx
      - mongo
      - mysql
      - rabbitmq
  roles:
    - serverdensity

Default Variables

You are not required to update these variables in order to get the Server Density agent running.

group_name: "ungrouped"
plugin_directory: ""

Default Variable Descriptions

  • group_name - Sets the group name.
  • plugin_directory - Sets the directory where the agent looks for plugins. If the variable is left blank, it is ignored.