Skip to content
This repository has been archived by the owner on Dec 16, 2021. It is now read-only.

Latest commit

 

History

History
201 lines (160 loc) · 6.85 KB

README.md

File metadata and controls

201 lines (160 loc) · 6.85 KB

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

❗ 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 Build Status

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/)