ScyllaDB University Live | Free Virtual Training Event
Learn more
ScyllaDB Documentation Logo Documentation
  • Server
  • Cloud
  • Tools
    • ScyllaDB Manager
    • ScyllaDB Monitoring Stack
    • ScyllaDB Operator
  • Drivers
    • CQL Drivers
    • DynamoDB Drivers
  • Resources
    • ScyllaDB University
    • Community Forum
    • Tutorials
Download
ScyllaDB Docs ScyllaDB Monitoring Troubleshooting Guide for Scylla Monitoring Stack Troubleshoot Scylla Monitoring Stack

Caution

You're viewing documentation for a previous version of ScyllaDB Monitoring. Switch to the latest stable version.

Troubleshoot Scylla Monitoring Stack¶

This document describes steps that need to be done to troubleshoot monitoring problems when using Grafana/Prometheus monitoring tool.

Problem¶

  • Scylla-Manager 2.2 with Duplicate information

  • A Container Fails To Start

  • Files And Directory Permissions

  • No Data Points

  • Grafana Chart Shows Error (!) Sign

  • Grafana Shows Server Level Metrics, but not Scylla Metrics

  • Grafana Shows Scylla Metrics, but not Server Level Metrics

  • Working with Wireshark

Scylla-Manager 2.2 with Duplicate information¶

Scylla Manager 2.2 change the default metrics (Prometheus) reporting ports:

  • For Manager server: from 56090 to 5090

  • For Manager Agent: from 56090 to 5090

For backward compatibility, Scylla Monitoring Stack 3.5 default configuration reads from both Manager ports, old and new, so you do not have to update the Prometheus configuration when upgrading to Manager 2.2

However, if you configure scylla_manager_server.yml file with the new port, Scylla-Manager dashboard will report all metrics twice.

The easiest way around this is to edit prometheus/prometheus.yml.template and remove the scylla_manager1 job.

Note that for this change to take effect you need to run kill-all.sh followed by start-all.sh.

A Container Fails To Start¶

When running ./start-all.sh a container can fail to start. For example you can see the following error message:

Wait for Prometheus container to start........Error: Prometheus container failed to start

Should this happen, check the Docker logs for more information.

docker logs aprom

Usually the reason for the failure is described in the logs.

Files And Directory Permissions¶

Note

Avoid running Docker containers as root.

The preferred way of running the container is using a non root user. See the monitoring Docker post-installation section.

If a container failed to start because of a permission problem, make sure the external directory you are using is owned by the current user and that the current user has the proper permissions.

Note

If you started the container in the past as root, you may need to change the directory and files ownership and permissions.

For example if your Prometheus data directory is /prom-data and you are using centos user

ls -la /|grep prom-data

drwxr-xr-x    2 root root  4096 Jun 25 17:51 prom-data

sudo chown -R centos:centos /prom-data

ls -la /|grep prom-data

drwxr-xr-x    2 centos centos  4096 Jun 25 17:51 prom-data

No Data Points¶

No data points on all data charts.

Solution¶

If there are no data points, or if a node appears to be unreachable when you know it is up, the immediate suspect is the Prometheus connectivity.

  1. Login to the Prometheus console:

  2. Point your browser to http://{ip}:9090, where {ip} is the Prometheus IP address.

  3. Go to the target tabs: http://{ip}:9090/targets and see if any of the targets are down and if there are any error messages.

  • Make sure you are not using the local network for local IP range When using Docker containers, by default, the local IP range (127.0.0.X) is inside the Docker container and not the host local address. If you are trying to connect to a target via the local IP range from inside a Docker container, you need to use the -l flag to enable local network stack.

  • Confirm Prometheus is pointing to the wrong target. Check your prometheus/scylla_servers.yml. Make sure Prometheus is pulling data from the Scylla server.

  • Your dashboard and Scylla version may not be aligned. If you are running Scylla 3.1.x, you can specify a specific version with -v flag.

For example:

./start-all.sh -v 3.1

More on start-all.sh options.

Grafana Chart Shows Error (!) Sign¶

Run this procedure on the Scylla Monitoring Stack server.

If the Grafana charts show an error (!) sign, there is a problem with the connection between Grafana and Prometheus.

Solution¶

On the Scylla Monitoring Stack server:

  1. Check Prometheus is running using docker ps.

  • If it is not running check the prometheus.yml for errors.

For example:

CONTAINER ID  IMAGE    COMMAND                  CREATED         STATUS         PORTS                                                    NAMES
41bd3db26240  monitor  "/docker-entrypoin..."   25 seconds ago  Up 23 seconds  7000-7001/tcp, 9042/tcp, 9160/tcp, 9180/tcp, 10000/tcp   monitor
  • If it is running, go to “Data Source” in the Grafana GUI, choose Prometheus and click Test Connection.

Grafana Shows Server Level Metrics, but not Scylla Metrics¶

Grafana shows server level metrics like disk usage, but not Scylla metrics. Prometheus fails to fetch metrics from Scylla servers.

Solution¶

  • Use curl <scylla_node>:9180/metrics to fetch binary metric data from Scylla. If curl does not return data, the problem is the connectivity between the Scylla Monitoring Stack and Scylla server. In that case, check your IPs and firewalls.

For example

curl 172.17.0.2:9180/metrics

Grafana Shows Scylla Metrics, but not Server Level Metrics¶

Grafana dashboards show Scylla metrics, such as load, but not server metrics such as disk usage. Prometheus fails to fetch metrics from node_exporter.

Solution¶

1. Make sure that node_exporter is running on each Scylla server (by login to the machine and running ps -ef |gre node_exporter). node_exporter is installed with scylla_setup. to check that node_exporter is installed, run node_exporter --version, If it is not, make sure to install and run it.

  1. If it is running, use curl http://<scylla_node>:9100/metrics (where <scylla_node> is a Scylla server IP) to fetch metric data from Scylla. If curl does not return data, the problem is the connectivity between Scylla Monitoring Stack and Scylla server. Please check your IPs and firewalls.

Notice to users upgrading to Scylla Open Source 3.0 or Scylla Enterprise 2019.1¶

While upgrading, you need to upgrade the node_exporter from version 0.14 to 0.17.

If the node_exporter service is not starting it may need to be updated manually.

Check the node_exporter version node_exporter --version if it shows 0.14 check the node_exporter section in the upgrade guide.

Working with Wireshark¶

No metrics shown in the Scylla Monitoring Stack.

  1. Install wireshark

2. Capture the traffic between the Scylla Monitoring Stack and Scylla node using the tshark command. tshark -i <network interface name> -f "dst port 9180"

For example:

tshark -i eth0 -f "dst port 9180"

Capture from Scylla node towards Scylla Monitoring Stack server.

In this example, Scylla is running.

Monitor ip        Scylla node ip
199.203.229.89 -> 172.16.12.142 TCP 66 59212 > 9180 [ACK] Seq=317 Ack=78193 Win=158080 Len=0 TSval=79869679 TSecr=3347447210

In this example, Scylla is not running

Monitor ip        Scylla node ip
199.203.229.89 -> 172.16.12.142 TCP 74 60440 > 9180 [SYN] Seq=0 Win=29200 Len=0 MSS=1460 SACK_PERM=1 TSval=79988291 TSecr=0 WS=128

Was this page helpful?

PREVIOUS
Troubleshooting Guide for Scylla Monitoring Stack
NEXT
Scylla Monitoring Stack Reference Guide
  • Create an issue
  • Edit this page

On this page

  • Troubleshoot Scylla Monitoring Stack
    • Problem
      • Scylla-Manager 2.2 with Duplicate information
      • A Container Fails To Start
      • Files And Directory Permissions
      • No Data Points
        • Solution
      • Grafana Chart Shows Error (!) Sign
        • Solution
      • Grafana Shows Server Level Metrics, but not Scylla Metrics
        • Solution
      • Grafana Shows Scylla Metrics, but not Server Level Metrics
        • Solution
        • Notice to users upgrading to Scylla Open Source 3.0 or Scylla Enterprise 2019.1
      • Working with Wireshark
ScyllaDB Monitoring
  • 3.7
    • 4.9
    • 4.8
    • 4.7
    • 4.6
    • 4.5
    • 4.4
    • 4.3
    • 4.2
    • 4.1
    • 4.0
    • 3.10
    • 3.9
    • 3.8
    • 3.7
    • 3.6
    • 3.5
  • User Guide
    • CQL Optimization Dashboard
    • Advisor
      • Some queries use ALLOW FILTERING
      • Some queries use Consistency Level: ALL
      • Some queries use Consistency Level: ANY
      • Some queries are not token-aware
      • Some SELECT queries are non-paged
      • Some queries are non-prepared
      • Some queries use reverse order
      • Some operation failed due to unsatisfied consistency level
      • I/O Errors can indicate a node with a faulty disk
      • Some operations failed on the replica side
      • CQL queries are not balanced among shards
  • Download and Install
    • Install
    • The start-all.sh script
    • Deploy without Docker
    • Docker Compose
    • System Recommendations
    • Using Thanos
  • Procedures
    • Alert Manager
      • Alerting
    • Adding and Modifying Dashboards
    • Upgrade Guide
  • Troubleshooting
    • Troubleshooting
    • Troubleshooting Guide for Scylla Manager and Scylla Monitor Integration
  • Reference
    • Support Matrix
    • Interfaces
Docs Tutorials University Contact Us About Us
© 2025, ScyllaDB. All rights reserved. | Terms of Service | Privacy Policy | ScyllaDB, and ScyllaDB Cloud, are registered trademarks of ScyllaDB, Inc.
Last updated on 04 May 2025.
Powered by Sphinx 7.4.7 & ScyllaDB Theme 1.8.6