About The Project

While working at my current gig I found we were lacking some metrics to gain a deeper visibility in to our infrastructure. I built this exporter to fill some of those gaps.

(back to top)

Getting Started

This project assumes you have cinc-server installed with the default database settings.

Installation

1. Switch to the database user sh sudo su - opscode-pgsql
2. pull latest release sh wget # automated builds/releases coming soon
3. run the service sh ./cinc_server_exporter
4. test sh curl http://localhost:9165/metrics

(back to top)

Development Setup

Recommended prerequesites

• nix
• devenv.sh
• direnv

Building and running

1. Pull latest code

   sh git clone https://github.com/esoterick/cinc_server_exporter.git

2. Enter project directory

   sh cd cinc_server_exporter

3. Allow direnv and let nix to do it's thing

   sh devenv init

4. Update .envrc with any configuration options, most importantly the host= string should be set to the current working directory of the repo plus .devenv/state/postgres which is the default location of where devenv stores the test postgres instance data.

   export CINC_SERVER_EXPORTER_CONN_STRING="host=$(pwd)/.devenv/state/postgres user=rlambert dbname=opscode_chef" export CINC_SERVER_EXPORTER_INTERVAL="15"

5. Allow updated direnv

   direnv allow .

6. Run test database

   devenv up

7. Import Test Data

   sh createdb opscode_chef psql -U rlambert -d opscode_chef -f test/data/nodes.sql

8. Run exporter

   sh cargo run

9. Scrape sh curl http://localhost:9165/metrics

(back to top)

Usage

Configuration

There are a handful of options to configure the exporter which is done via the following environment variables.

• CINC_SERVER_EXPORTER_CONN_STRING - Postgres connection string to the CINC database. default: host=localhost user=opscode-pgsql dbname=opscode_chef
• CINC_SERVER_EXPORTER_INTERVAL - Interval to scrape the database in seconds. default: 15
• CINC_SERVER_EXPORTER_LISTEN_ADDR - Listen address for the exporter. default: 0.0.0.0
• CINC_SERVER_EXPORTER_LISTEN_PORT - Listen TCP port for the exporter. default: 9164

(back to top)

Available Metrics

Current list of available exported metrics

Exporter Level

• cinc_server_exporter_last_updated - THe UNIX timestamp of the last cache update for the cincserverexporter

Server Level

• cinc_server_node_count - The count of all the nodes stored on the cinc_server

Node Level

• cinc_server_node_last_updated - Per node, the UNIX timestamp of the last node update

Axum

• axum_http_requests_duration_seconds_bucket
• axum_http_requests_duration_seconds_count
• axum_http_requests_duration_seconds_sum
• axum_http_requests_pending
• axum_http_requests_total

Roadmap

• [x] Add changelog
• [x] Add test data
• [ ] Add tests
• [x] Document configuration options
• [ ] Add automated builds
• [ ] Add release url to docs

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

Robert J. Lambert III - robert.j.lambert@pm.me Project Link: https://github.com/esoterick/cincserverexporter

(back to top)

Acknowledgments

• Rust
• CINC
• Nix
• devenv
• Best-README-Template

(back to top)