This project builds a Prometheus Exporter to collect Cloudera status and usage metrics.
This exporter scrape the metrics by independent modules (Scrapers). This modules are:
- Status: Scrapes the metrics about the current status of the Clusters, services, roles and hosts
- Hosts: Scrapes the metrics about the Hosts: CPU usage, RAM, SWAP, Agent stats and more useful metrics
- HDFS: Scrapes the metrics about HDFS: Capacity, blocks stats, file stats, Namenode properties and Snapshots.
- Impala: Scrapes the metrics about Impala: Catalog, usage stats, queries stats, state-store info โฆ
To launch the exporter we recommend use a Docker container. Whether it is inside a container or in the local system, some Golang packages are needed as dependencies of the code to be able to implement some Prometheus functions.
Edit the config.ini file and change the host ip (cloudera_manager) in the target section by your Cloudera Manager IP addr. If you want to use "cloudera_manager" as a name-domain, edit the Makefile.common file and change "--add-host" property in the Docker_RUN_FLAGS variable.
# Compile on docker and create container
make docker_build
# Launch on docker
make docker_run
# Compile and launch
make docker
Edit the config.ini file and change the host ip (cloudera_manager) in the target section by your Cloudera Manager IP addr. If you want to use "cloudera_manager" as a name-domain, add the entry to your /etc/hosts file.
# Compile on local
make all
# Launch on local on shell
./cloudera_exporter --config-file config.ini
Cloudera Exporter args:
usage: cloudera_exporter [<flags>]
Flags:
-h, --help Show context-sensitive help (also try --help-long and --help-man).
--config-file="config.ini" Path to ini file.
--web.listen-address="" Listent Address.
--num-procs=0 Number Processes for parallel execution
--log-level=0 Debug Log Mode
--timeout-offset=0.25 Time to subtract from timeout in seconds.
--version Show application version.
# First of all, edit the config.ini file with the parameters for your environment
# Build de Docker Image with the *Dockerfile* in this repository:
docker build --build-arg VERSION="$(cat VERSION)" -t "keedio/kce:$(cat VERSION)" .
# Run the container. (Maybe you want to open the exporter port)
docker run keedio/kce:$(cat VERSION) [-p 9200:9200] --name kce
To clean the local binary and the cloudera_exporter container
make clean
Test if cloudera_exporter is running
make test
To get a list of all the metrics of each Scraper, read the Scraper, read the METRICS_CATALOG.md file.
To contact with developers for any question or proposal read the MAINTAINERS.md file.