nsg.graphite

This role installs graphite, I choose to install graphite from pip because the packages in the distributions repositories are old and features are missing. I’m using apt/yum when possible.

Requirements

As usual, read the tasks and make sure this role will not breaks your installation, I will for example mess with django, twisted and uwsgi.

This role exposes the graphite web interface with uwsgi at localhost:3031, you need to configure a web server your self to talk to that. For example, do this with nginx:

server {
  listen 8080;
  charset utf-8;
  access_log /var/log/nginx/graphite.access.log;
  error_log /var/log/nginx/graphite.error.log;

  location / {
  include uwsgi_params;
  uwsgi_pass 127.0.0.1:3031;
  }
}

Role Variables

graphite_user - The user that carbon and uwsgi is executed as, default: graphite
graphite_secret_key - Change this to a random string, default: UNSAFE_DEFAULT
graphite_time_zone - Select timezone, default: America/Los_Angeles
graphite_admin_date_joined, default: "2014-07-21T10:11:17.464"
graphite_admin_email, default: "root@localhost"
graphite_admin_first_name, default: ""
graphite_admin_last_name, default: ""
graphite_admin_last_login, default: "2014-07-21T10:11:17.464"
graphite_admin_username, default: "admin"
graphite_admin_password, default: "admin"

The default is "60s:1d" (1 day data), this will keep data for 5 years. If you log a lot of data, you may need to restrict this to a shorter time.

graphite_storage_schemas_default_retentions, default: "10s:14d,1m:90d,30m:1y,1h:5y"

Example Playbook

    - hosts: servers
      roles:
         - { role: nsg.graphite, graphite_secret_key: 'dgdgdfgasg' }

... or place graphite_secret_key in group_vars, host_vars, inventory...

License

MIT

Author Information