# Role Name: grafana_server

An Ansible role to install and configure Grafana.

## Role Variables

**NOTE** that in the table below if a value has a default value the example value/default value column will contain the default value of the variable.

| Variable name | Type | Description | Required | Has default value | Example value |
|---------------|------|-------------|----------|-------------------|---------------|
| `grafana_server_users` | list of dictionaries | A dictionary containing users to be created | ☐ | ☐ | See [below](####grafana_server_users) |
| `grafana_server_add_admin_user_to_default_organisation_as_admin` | boolean | Whether the admin user should be added to the default organisation. | ☑ | ☑ | `true`

#### grafana_server_users

```yaml
grafana_server_users:
  - amanda: # The user's name
      login: amanda # The login, what you type on the login screen
      email: amanda@ajordan.com # Email address
      password: Password123! # The password, obviously
      is_admin: true # Whether the user is an admin
```

## Example Playbook

Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:

```
- hosts: grafana_servers
  roles:
      - grafana_server
```

# License

BSD 2 Clause License