bosh_exporter

README

BOSH Exporter

A Prometheus exporter for BOSH metrics.

Installation

Locally

Using the standard go install (you must have Go already installed in your local machine):

$ go install github.com/cloudfoundry-community/bosh_exporter
$ bosh_exporter <flags>

Cloud Foundry

The exporter can be deployed to an already existing Cloud Foundry environment:

$ git clone https://github.com/cloudfoundry-community/bosh_exporter.git
$ cd bosh_exporter

Modify the included application manifest file to include your BOSH properties. Then you can push the exporter to your Cloud Foundry environment:

$ cf push

BOSH

This exporter can be deployed using the Prometheus BOSH Release.

Usage

Flags

Flag / Environment Variable	Required	Default	Description
bosh.url BOSH_EXPORTER_BOSH_URL	Yes		BOSH URL
bosh.username BOSH_EXPORTER_BOSH_USERNAME	No		BOSH Username
bosh.password BOSH_EXPORTER_BOSH_PASSWORD	No		BOSH Password
bosh.uaa.url BOSH_EXPORTER_BOSH_UAA_URL	No		BOSH UAA URL
bosh.uaa.client-id BOSH_EXPORTER_BOSH_UAA_CLIENT_ID	No		BOSH UAA Client ID
bosh.uaa.client-secret BOSH_EXPORTER_BOSH_UAA_CLIENT_SECRET	No		BOSH UAA Client Secret
bosh.log-level BOSH_EXPORTER_BOSH_LOG_LEVEL	No	ERROR	BOSH Log Level ("DEBUG", "INFO", "WARN", "ERROR", "NONE")
bosh.ca-cert-file BOSH_EXPORTER_BOSH_CA_CERT_FILE	No		BOSH CA Certificate file
bosh.deployments BOSH_EXPORTER_BOSH_DEPLOYMENTS	No		Comma separated deployments to filter
bosh.collectors BOSH_EXPORTER_BOSH_COLLECTORS	No		Comma separated collectors to filter (Deployments,Jobs,ServiceDiscovery)
metrics.namespace BOSH_EXPORTER_METRICS_NAMESPACE	No	bosh_exporter	Metrics Namespace
sd.filename BOSH_EXPORTER_SD_FILENAME	No	bosh_target_groups.json	Full path to the Service Discovery output file
sd.processes_regexp BOSH_EXPORTER_SD_PROCESSES_REGEXP	No		Regexp to filter Service Discovery processes names
web.listen-address BOSH_EXPORTER_WEB_LISTEN_ADDRESS	No	:9190	Address to listen on for web interface and telemetry
web.telemetry-path BOSH_EXPORTER_WEB_TELEMETRY_PATH	No	/metrics	Path under which to expose Prometheus metrics

Metrics

The exporter returns the following Deployments metrics:

Metric	Description	Labels
namespace_deployment_release_info	BOSH Deployment Release Info	bosh_deployment, bosh_release_name, bosh_release_version
namespace_deployment_stemcell_info	BOSH Deployment Stemcell Info	bosh_deployment, bosh_stemcell_name, bosh_stemcell_version, bosh_stemcell_os_name
namespace_last_deployments_scrape_timestamp	Number of seconds since 1970 since last scrape of Deployments metrics from BOSH
namespace_last_deployments_scrape_duration_seconds	Duration of the last scrape of Deployments metrics from BOSH

The exporter returns the following Jobs metrics:

Metric	Description	Labels
namespace_job_healthy	BOSH Job Healthy	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_load_avg01	BOSH Job Load avg01	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_load_avg05	BOSH Job Load avg05	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_load_avg15	BOSH Job Load avg15	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_cpu_sys	BOSH Job CPU System	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_cpu_user	BOSH Job CPU User	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_cpu_wait	BOSH Job CPU Wait	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_mem_kb	BOSH Job Memory KB	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_mem_percent	BOSH Job Memory Percent	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_swap_kb	BOSH Job Swap KB	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_swap_percent	BOSH Job Swap Percent	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_system_disk_inode_percent	BOSH Job System Disk Inode Percent	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_system_disk_percent	BOSH Job System Disk Percent	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_ephemeral_disk_inode_percent	BOSH Job Ephemeral Disk Inode Percent	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_ephemeral_disk_percent	BOSH Job Ephemeral Disk Percent	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_persistent_disk_inode_percent	BOSH Job Persistent Disk Inode Percent	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_persistent_disk_percent	BOSH Job Persistent Disk Percent	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip
namespace_job_process_healthy	BOSH Job Process Healthy	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip, bosh_job_process_name
namespace_job_process_uptime_seconds	BOSH Job Process Uptime in seconds	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip, bosh_job_process_name
namespace_job_process_cpu_total	BOSH Job Process CPU Total	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip, bosh_job_process_name
namespace_job_process_mem_kb	BOSH Job Process Memory KB	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip, bosh_job_process_name
namespace_job_process_mem_percent	BOSH Job Process Memory Percent	bosh_deployment, bosh_job_name, bosh_job_id, bosh_job_index, bosh_job_az, bosh_job_ip, bosh_job_process_name
namespace_last_jobs_scrape_timestamp	Number of seconds since 1970 since last scrape of Job metrics from BOSH
namespace_last_jobs_scrape_duration_seconds	Duration of the last scrape of Job metrics from BOSH

The exporter returns the following ServiceDiscovery metrics:

Metric	Description	Labels
namespace_last_service_discovery_scrape_timestamp	Number of seconds since 1970 since last scrape of Service Discovery from BOSH
namespace_last_service_discovery_scrape_duration_seconds	Duration of the last scrape of Service Discovery from BOSH

Service Discovery

If the ServiceDiscovery collector is enabled, the exporter will write a json file at the sd.filename location containing a list of static configs that can be used with the Prometheus file-based service discovery mechanism:

[
  {
    "targets": ["10.244.0.12"],
    "labels":
      {
        "__meta_bosh_job_process_name": "bosh_exporter"
      }
  },
  {
    "targets": ["10.244.0.11", "10.244.0.12", "10.244.0.13", "10.244.0.14"],
    "labels":
      {
        "__meta_bosh_job_process_name": "node_exporter"
      }
  }
]

The list of targets can be filtered using the sd.processes_regexp flag.

Contributing

Refer to CONTRIBUTING.md.

License

Apache License 2.0, see LICENSE.