---
title: Charmhub | Deploy Prometheus using Charmhub - The Open Operator Collection
description: Deploy the latest version of Prometheus on any cloud.
url: https://charmhub.io/charmcraft-prometheus/configurations
---

# Prometheus

[Charmcraft](https://charmhub.io/publisher/charmcraft "View all packages from Charmcraft")

* [Charmcraft](https://charmhub.io/publisher/charmcraft "View all packages from Charmcraft")
* [Monitoring](https://charmhub.io/?filter=monitoring)

Platform:

20.04

stable 3

```
juju deploy charmcraft-prometheus
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

* [evaluation-interval](https://charmhub.io/charmcraft-prometheus/configurations#evaluation-interval)
* [external-labels](https://charmhub.io/charmcraft-prometheus/configurations#external-labels)
* [log-level](https://charmhub.io/charmcraft-prometheus/configurations#log-level)
* [port](https://charmhub.io/charmcraft-prometheus/configurations#port)
* [prometheus-image-password](https://charmhub.io/charmcraft-prometheus/configurations#prometheus-image-password)
* [prometheus-image-path](https://charmhub.io/charmcraft-prometheus/configurations#prometheus-image-path)
* [prometheus-image-username](https://charmhub.io/charmcraft-prometheus/configurations#prometheus-image-username)
* [scrape-interval](https://charmhub.io/charmcraft-prometheus/configurations#scrape-interval)
* [scrape-timeout](https://charmhub.io/charmcraft-prometheus/configurations#scrape-timeout)
* [ssl-cert](https://charmhub.io/charmcraft-prometheus/configurations#ssl-cert)
* [ssl-key](https://charmhub.io/charmcraft-prometheus/configurations#ssl-key)
* [tsdb-retention-time](https://charmhub.io/charmcraft-prometheus/configurations#tsdb-retention-time)
* [tsdb-wal-compression](https://charmhub.io/charmcraft-prometheus/configurations#tsdb-wal-compression)
* [web-external-url](https://charmhub.io/charmcraft-prometheus/configurations#web-external-url)

[Learn about configurations >](https://juju.is/docs/juju/configuration#heading--application-configuration)

* evaluation-interval | string

  Default: 1m

  How frequently rules will be evaluated.
* external-labels | string

  Default: {}

  A JSON string of key-value pairs that specify the labels to
  attach to metrics in this Prometheus instance when they get pulled
  by an aggregating parent. This is useful in the case of federation
  where, for example, you want each datacenter to have its own
  Prometheus instance and then have a global instance that pulls from
  each of these datacenter instances. By specifying a unique set of
  external-labels for each datacenter instance, you can easily determine
  in the aggregating Prometheus instance which datacenter a metric is
  coming from. Note that you are not limited to one instance per
  datacenter. The datacenter example here is arbitrary and you are free
  to organize your federation's hierarchy as you see fit.
  Ex. '{ "cluster": "datacenter1" }'. Both keys and values may be
  arbitrarily chosen as you see fit.
* log-level | string

  Prometheus server log level (only log messages with the given severity
  or above). Must be one of: [debug, info, warn, error, fatal].
  If not set, the Prometheus default one (info) will be used.
* port | int

  Default: 9090

  The port prometheus will be listening on
* prometheus-image-password | string

  The password associated with prometheus-image-username for
  accessing the registry specified in prometheus-image-path.
* prometheus-image-path | string

  Default: prom/prometheus:latest

  The location of the image to use,
  e.g. "registry.example.com/prometheus:v1".

  This setting is required.
* prometheus-image-username | string

  The username for accessing the registry specified in
  prometheus-image-path.
* scrape-interval | string

  Default: 1m

  How frequently to scrape targets by default.
* scrape-timeout | string

  Default: 10s

  How long until a scrape request times out.
* ssl-cert | string

  SSL certificate to install and use for Prometheus endpoint.
* ssl-key | string

  SSL key to use with certificate specified as ssl-cert.
* tsdb-retention-time | string

  Default: 15d

  How long to retain samples in the storage.
  Units Supported: y, w, d, h, m, s
* tsdb-wal-compression | boolean

  This flag enables compression of the write-ahead log (WAL).
  Depending on your data, you can expect the WAL size to be
  halved with little extra cpu load.
* web-external-url | string

  The URL under which Prometheus is externally reachable (for example,
  if Prometheus is served via a reverse proxy).
  Used for generating relative and absolute links back to
  Prometheus itself. If the URL has a path portion, it will be used to
  prefix all HTTP endpoints served by Prometheus.

  If omitted, relevant URL components will be derived automatically.