ansible-role-sensu-client

Configures sensu-client

Requirements

None

Role Variables

Variable	Description	Default
sensu_client_user	user name of sensu-client	{{ __sensu_client_user }}
sensu_client_group	group name of sensu-client	{{ __sensu_client_group }}
sensu_client_service	service name of sensu-client	{{ __sensu_client_service }}
sensu_client_config_dir	path to configuration directory	{{ __sensu_client_config_dir }}
sensu_client_config_file	path to config.json	{{ sensu_client_config_dir }}/config.json
sensu_client_conf_d_dir	path to conf.d directory	{{ sensu_client_config_dir }}/conf.d
sensu_client_extensions_dir	path to extensions directory	{{ sensu_client_config_dir }}/extensions
sensu_client_plugins_dir	path to plugins directory	{{ sensu_client_config_dir }}/plugins
sensu_client_log_dir	path to log directory	/var/log/sensu
sensu_client_flags	not used yet	""
sensu_client_config	YAML representation of config.json	{}
sensu_client_config_fragments	YAML representation of JSON files under conf.d	{}
sensu_client_gems	list of dict of gems to install or remove (see below)	[]
sensu_client_gem_binary	path to gem binary (see below)	gem

sensu_client_gems

This variable is a list of dict. The dict is described below. See ansible gem module for details.

Key	Value	Mandatory?
name	name of gem	yes
state	state of gem . one of present, absent and latest	yes
verison	version of gem	no
pre_release	indicates the version is pre-release. yes or no	no
repository	repository where the gem is in	no

sensu_client_gem_binary

This is string of path to gem binary to use when managing plug-ins. When sensu package is one from the official project, it must be path to gem binary bundled in the package.

Debian

Variable	Default
__sensu_client_user	sensu
__sensu_client_group	sensu
__sensu_client_service	sensu-client
__sensu_client_config_dir	/etc/sensu

FreeBSD

Variable	Default
__sensu_client_user	sensu
__sensu_client_group	sensu
__sensu_client_service	sensu-client
__sensu_client_config_dir	/usr/local/etc/sensu

OpenBSD

Variable	Default
__sensu_client_user	_sensu
__sensu_client_group	_sensu
__sensu_client_service	sensu_client
__sensu_client_config_dir	/etc/sensu

RedHat

Variable	Default
__sensu_client_user	sensu
__sensu_client_group	sensu
__sensu_client_service	sensu-client
__sensu_client_config_dir	/etc/sensu

Dependencies

None

Example Playbook

- hosts: localhost
  roles:
    - name: reallyenglish.apt-repo
      when: ansible_os_family == 'Debian'
    - name: reallyenglish.redhat-repo
      when: ansible_os_family == 'RedHat'
    - name: reallyenglish.language-ruby
      when: ansible_os_family == 'OpenBSD'
    - name: reallyenglish.freebsd-repos
      when: ansible_os_family == 'FreeBSD'
    - ansible-role-sensu-client
  vars:
    redhat_repo:
      sensu:
        baseurl: https://sensu.global.ssl.fastly.net/yum/$releasever/$basearch
        gpgcheck: no
        enabled: yes
    apt_repo_keys_to_add:
      - https://sensu.global.ssl.fastly.net/apt/pubkey.gpg
    apt_repo_enable_apt_transport_https: yes
    apt_repo_to_add:
      - "deb https://sensu.global.ssl.fastly.net/apt {{ ansible_distribution_release }} main"
    freebsd_repos:
      sensu:
        enabled: "true"
        url: https://sensu.global.ssl.fastly.net/freebsd/FreeBSD:10:amd64/
        mirror_type: srv
        signature_type: none
        priority: 100
        state: present
    sensu_client_config: {}
    sensu_client_config_fragments:
      client:
        client:
          name: foo
          address: 127.0.0.1
          subscriptions:
            - production
            - something
      transport:
        transport:
          name: rabbitmq
          reconnect_on_error: True
    sensu_client_gem_binary: "{% if ansible_os_family == 'OpenBSD' %}gem{% else %}/opt/sensu/embedded/bin/gem{% endif %}"
    sensu_client_gems:
      - name: sensu-plugins-disk-checks
        state: present
      - name: sensu-plugins-load-checks
        state: present

License

Copyright (c) 2017 Tomoyuki Sakurai <[email protected]>

Permission to use, copy, modify, and distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Author Information

Tomoyuki Sakurai tomoyukis@reallyenglish.com

This README was created by qansible