#######################################################################################################

❗ DEPRECATION ❗

This repository and the role associated are deprecated in favor of the Manala Sensu go role

You can find it in the Manala Ansible Collection. You will find informations on its usage on the collection repository

#######################################################################################################

Ansible Role: Sensu

❗ Report issues and send Pull Requests in the main Ansible Role repository ❗

This role will deal with the setup of Sensu.

It's part of the Manala Ansible stack but can be used as a stand alone component.

Requirements

This role is made to work with the sensu official debian packages, available on the sensu debian repository. Please use the manala.apt role to handle it properly.

manala_apt_preferences:
  - sensu@sensu

Dependencies

None.

Installation

Ansible 2+

Using ansible galaxy cli:

ansible-galaxy install manala.sensu

Using ansible galaxy requirements file:

- src: manala.sensu

Role Handlers

Name	Type	Description
`sensu restart`	Service	Restart all sensu services
`sensu-api restart`	Service	Restart sensu api
`sensu-client restart`	Service	Restart sensu client
`sensu-server restart`	Service	Restart sensu server

Role Variables

Name	Default	Type	Description
`manala_sensu_install_packages`	~	Array	Dependency packages to install
`manala_sensu_install_packages_default`	['sensu']	Array	Default dependency packages to install
`manala_sensu_config_template`	'config/empty.j2'	String	Configuration base template path
`manala_sensu_config`	[]	Array	Configuration directives
`manala_sensu_gems`	[]	Array	Gems to install (http://sensu-plugins.io/)
`manala_sensu_configs_template`	'configs/default.j2'	String	Additional configurations base template path
`manala_sensu_configs`	[]	Array	Additional configurations directives
`manala_sensu_configs_exclusive`	false	Array	Additional configurations exclusivity
`manala_sensu_configs_user	'sensu'	String	Name of the user that should own config files
`manala_sensu_configs_group	'sensu'	String	Name of the group that should own config files
`manala_sensu_configs_mode	0644	Octal	Additional configurations files mode
`manala_sensu_checks`	[]	Array	Checks directives
`manala_sensu_services`	[]	Array	Enable and start sensu services (sensu-server, sensu-client, sensu-server)

Configuration example

Sensu server

manala_sensu_services:
  - sensu-server
  - sensu-api

manala_sensu_gems:
  - name: sensu-plugins-slack
    version: 1.0.0

manala_sensu_configs:
  - file: transport.json
    config:
      transport:
        name: redis
  - file: redis_config.json
    config:
      redis:
        host: "{{ ansible_eth0.ipv4.address }}"
        port: 6379
  - file: api.json
    config:
      api:
        host:     "{{ ansible_eth0.ipv4.address }}"
        port:     4567
        user:     admin
        password: password
  - file: handler_checks.json
    config:
      handlers:
        checks:
          type:     set
          handlers: [slack]
  - file: handler_slack.json
    config:
      handlers:
        slack:
          type: pipe
          command: handler-slack.rb
          severites: [critical, unknown]
      slack:
        webhook_url: https://hooks.slack.com/services/...
        bot_name: sensu

Sensu client

manala_sensu_services:
  - sensu-client

manala_sensu_config:
  EMBEDDED_RUBY: true
  LOG_LEVEL: warn

manala_sensu_configs_exclusive: true

manala_sensu_configs:
  - file: transport.json
    config:
      transport:
        name: redis
  - file: redis_config.json
    config:
      redis:
        host: sensu.example.local
        port: 6379
  - file: client.json
    config:
      client:
        name:          "{{ ansible_fqdn }}"
        address:       "{{ ansible_fqdn }}"
        subscriptions: "{{ ['production', ansible_hostname] + group_names }}"
        keepalive:
          handler: checks
          thresholds:
            warning:  300
            critical: 600

manala_sensu_gems:
  - name: sensu-plugins-process-checks
    version: 1.0.0
  - name: sensu-plugins-disk-checks
    version: 2.0.1

manala_sensu_checks:
  - name: sshd_running
    command: check-process.rb -p sshd
    handlers: checks
    standalone: true
    interval: 300
    occurrences: 2
    refresh: 3600
  - name: cron_running
    command: check-process.rb -p cron
    handlers: checks
    standalone: true
    interval: 300
    occurrences: 2
    refresh: 3600
  - name: disk_available
    command: check-disk-usage.rb -w 90 -c 95 -W 90 -K 95
    handlers: checks
    standalone: true
    interval: 300
    occurrences: 2
    refresh: 3600

Example playbook

- hosts: sensu
  roles:
    - { role: manala.sensu }

Licence

MIT

Author information

Manala (http://www.manala.io/)

manala / ansible-role-sensu Goto Github PK

ansible-role-sensu's Introduction