Prometheus Juju Exporter
- By Canonical BootStack Charmers
Channel | Revision | Published | Runs on |
---|---|---|---|
latest/stable | 12 | 01 Nov 2023 | |
latest/candidate | 12 | 12 Oct 2023 | |
latest/edge | 12 | 20 Sep 2023 |
juju deploy prometheus-juju-exporter
Deploy universal operators easily with Juju, the Universal Operator Lifecycle Manager.
Platform:
prometheus-juju-exporter
This charm collects statistics about machines deployed by juju controller and exports them as a Prometheus metrics. Core collecting and exporting functionality is implemented in the prometheus-juju-exporter snap. This snap can be either provided manually during the deployment as a resource or this charm will attempt to download it from Snap Store.
Collected Data
Main focus of this exporter is to provide insight about how many machines are deployed by the Juju
controller and what’s their state. The installed exporter snap will try to connect to the
controller and crawl through every model, collecting information about deployed machines.
Resulting metrics contain numeric representation 1
(UP) or 0
(DOWN) for each machine deployed
by the controller. In addition, each machine (metric) has labels that help to uniquely identify it:
- hostname - hostname of the machine as reported by Juju
- juju_model - name of the model in which the machine is deployed
- cloud_name - name of the cloud that hosts the model
- customer - name of the customer/organization that owns the controller
- type - (Experimental) Distinguishes various host types
- metal - Physical machine
- kvm - Virtual Machine
- lxd - LXD container Example data:
# HELP juju_machine_state Running status of juju machines
# TYPE juju_machine_state gauge
juju_machine_state{customer="DOC",hostname="juju-882749-controller-0",job="prometheus-juju-exporter",cloud_name="openstack-cloud-serverstack",juju_model="controller",type="kvm"} 1.0
juju_machine_state{customer="DOC",hostname="juju-882749-controller-3",job="prometheus-juju-exporter",cloud_name="openstack-cloud-serverstack",juju_model="controller",type="kvm"} 1.0
juju_machine_state{customer="DOC",hostname="juju-ad368d-test-0",job="prometheus-juju-exporter",cloud_name="openstack-cloud-serverstack",juju_model="test",type="kvm"} 1.0
juju_machine_state{customer="DOC",hostname="juju-ad368d-test-1",job="prometheus-juju-exporter",cloud_name="openstack-cloud-serverstack",juju_model="test",type="kvm"} 1.0
Security, Bugs and feature request
If you find a bug in this application or want to request a specific feature, here are the useful links:
-
Raise issues or feature requests in Github
-
Security issues in the Prometheus juju exporter can be reported through LaunchPad. Please do not file GitHub issues about security issues.
Contributing
Please see the Juju SDK docs for guidelines on enhancements to this charm following best practice guidelines, and CONTRIBUTING.md for developer guidance.
License
Prometheus Juju Exporter is free software, distributed under the Apache Software License, version 2.0. See LICENSE for more information.