ansible scylla monitoring

Deploy Scylla Monitoring (Prometheus + Grafana) using Docker. This role:

• Installs Docker and deploys monitoring stack
• Generates scylla_servers.yml from inventory or provided file
• Configures Prometheus alerting rules
• Optionally integrates with Scylla Manager

Requirements

• Ansible 6.7.0+
• SSH access to monitoring host
• Docker or podman installed on monitoring host
• Scylla cluster deployed (use ansible-scylla-node)

Inventory

The inventory must define [scylla] group. Optionally include [scylla-manager] if integrating with Manager.

[scylla-monitoring]
monitor1 ansible_host=10.0.0.10

[scylla]
node1 ansible_host=10.0.0.1 dc=dc1 rack=rack1
node2 ansible_host=10.0.0.2 dc=dc1 rack=rack1
node3 ansible_host=10.0.0.3 dc=dc2 rack=rack2

[scylla-manager]
manager1 ansible_host=10.0.0.20

Role Variables

For a complete list of variables and their descriptions, see the defaults/main.yml.

Required

Variable	Description
scylla_cluster_name	Name of the Scylla cluster

Server Configuration

Variable	Default	Description
scylla_servers_yml_path	scylla_servers.yml	Path to server config (auto-generated if not provided)
use_nodetool_status_with_genconfig	false	Generate config from nodetool instead of inventory

Scylla Manager Integration

Variable	Default	Description
scylla_manager_ip	127.0.0.1	Manager host IP (comment out to disable)

Monitoring Stack

Variable	Default	Description
scylla_monitoring_archive_url	Auto (3.10.1)	GitHub release tarball URL
scylla_monitoring_deploy_path	/opt/scylla-monitoring	Installation path
scylla_monitoring_data_path	Auto	Prometheus data path
scylla_monitoring_retention	14d	Data retention period

Dashboard Versions

Variable	Default	Description
scylla_monitoring_dashboards_versions	Auto	List of dashboard versions (e.g., ['6.2', '5.4'])

Prometheus Rules

Variable	Default	Description
prometheus_rules_file	default	Custom rules file path (or default)
scylla_monitoring_default_alert_reject_filter	Unset	Regex to filter out alerts
rule_config_yml_path	rule_config.yml	Alert sender config

Grafana

Variable	Default	Description
grafana_enable_https	false	Enable HTTPS with self-signed cert
grafana_admin_user	admin	Grafana admin username
grafana_admin_password	admin	Grafana admin password
grafana_root_url	Auto	Grafana root URL

Monitoring Parameters

Variable	Default	Description
scylla_monitoring_params	Unset	Additional params passed to start-all.sh

Other

Variable	Default	Description
run_docker_with_sudo	false	Run Docker with sudo
scylla_monitoring_role_config_path	inventory_dir	Local path for config files