Frequently Asked Questions about Ceph Exporter

Q: What is Ceph Exporter? A: Ceph Exporter is a Prometheus exporter that scrapes meta-information about a running Ceph cluster, providing metrics for monitoring its health and performance.

Q: What are the dependencies for running Ceph Exporter? A: Ceph Exporter requires access to the Ceph configuration file (ceph.conf) and the Ceph client keyring file (ceph.client.<user>.keyring) to authenticate to the Ceph cluster.

Q: How do I configure Ceph Exporter? A: Ceph Exporter can be configured using environment variables such as CEPH_CLUSTER, CEPH_CONFIG, CEPH_USER, and TELEMETRY_ADDR.

Q: How do I install Ceph Exporter? A: You can install Ceph Exporter using Go tools or by deploying the provided Docker image.

Q: Does Ceph Exporter support TLS? A: Yes, Ceph Exporter supports TLS encryption for secure communication with Prometheus. You need to specify the paths to the certificate and key files using the TLS_CERT_FILE_PATH and TLS_KEY_FILE_PATH environment variables.

Q: What Ceph versions are compatible with Ceph Exporter? A: Ceph Exporter is currently tested against Nautilus, Pacific, and Reef. It might not work as expected with older or non-LTS versions of Ceph.

Q: How do I contribute to Ceph Exporter? A: Please refer to the CONTRIBUTING guide on the GitHub repository for information on how to submit your changes.

Q: How does Ceph Exporter integrate with UBOS? A: By ingesting Ceph Exporter’s data stream, UBOS uses AI Agents to automate tasks like capacity provisioning, performance tuning, and failure recovery, improving overall cluster management.

Q: Can I use Ceph exporter to monitor RGW? A: Yes, the exporter supports collection of statistics from Ceph RGW (RADOS Gateway), providing insights into object storage performance and usage by setting the RGW_MODE environment variable.

Q: What is the default port used by Ceph Exporter? A: The default port is 9128.