---
title: Charmhub | Deploy OpenStack Exporter using Charmhub - The Open Operator Collection
description: Deploy the latest version of OpenStack Exporter on any cloud.
url: https://charmhub.io/openstack-exporter/docs/tutorial
---

# OpenStack Exporter

[Canonical BootStack Charmers](https://charmhub.io/publisher/bootstack-charmers "View all packages from Canonical BootStack Charmers")

* [Canonical BootStack Charmers](https://charmhub.io/publisher/bootstack-charmers "View all packages from Canonical BootStack Charmers")

Platform:

24.04

22.04

stable 75

```
juju deploy openstack-exporter
```

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

---

#### Relevant links

* [Homepage](https://github.com/canonical/openstack-exporter-operator)

---

#### Contacts

* [Submit a bug](https://github.com/canonical/openstack-exporter-operator/issues)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

# Tutorial: Getting started

The tutorial consists of the following steps:

1. [Prerequisites](https://charmhub.io/openstack-exporter/docs/tutorial#prerequisites-2)
2. [Deploy the charm](https://charmhub.io/openstack-exporter/docs/tutorial#deploy-the-charm-5)
3. [View the Grafana dashboards](https://charmhub.io/openstack-exporter/docs/tutorial#view-the-grafana-dashboards-6)

## [Prerequisites](https://charmhub.io/openstack-exporter/docs/tutorial#p-31169-prerequisites)

### [Charmed Openstack and COS](https://charmhub.io/openstack-exporter/docs/tutorial#p-31169-charmed-openstack-and-cos)

To get started, you will need a Charmed OpenStack deployment with COS.

### [Openstack-exporter snap (revisions ≤ 27)](https://charmhub.io/openstack-exporter/docs/tutorial#p-31169-openstack-exporter-snap-revisions-27)

Charm revisions 27 or older require a custom built snap from the branch at [openstack-exporter/openstack-exporter#355](https://github.com/openstack-exporter/openstack-exporter/pull/355), uploaded to the charm via a resource. A temporary pre-built snap can be found in the assets section at <https://github.com/canonical/openstack-exporter-operator/releases/tag/rev2> .

```
wget https://github.com/canonical/openstack-exporter-operator/releases/download/rev2/golang-openstack-exporter_amd64.snap
```

## [Deploy the charm](https://charmhub.io/openstack-exporter/docs/tutorial#p-31169-deploy-the-charm)

Switch to the Juju openstack model. Then you can deploy the charm:

```
# Revisions 27 or older
juju deploy openstack-exporter --resource openstack-exporter=golang-openstack-exporter_amd64.snap

# Revisions > 27
juju deploy openstack-exporter
```

The charm must be integrated with keystone (for credentials) and grafana-agent (to send Grafana dashboards to Grafana and metrics to Prometheus).

```
juju integrate openstack-exporter:credentials keystone:identity-admin
juju integrate openstack-exporter:cos-agent grafana-agent:cos-agent
```

If your OpenStack cloud is configured with SSL, with a local CA, you may need to [set the `ssl_ca` option in the charm](https://charmhub.io/openstack-exporter/docs/custom-ssl-ca).

For **revisions 27 or older**, the [cache mechanism](https://charmhub.io/openstack-exporter/docs/enable-cache) for the metrics are **disabled** by default which can cause time out issues and metrics not propagated into COS if the OpenStack cloud is a large deployment.

On **revisions > 27** the [cache mechanism](https://charmhub.io/openstack-exporter/docs/enable-cache) for the metrics are **enabled** by default.

The charm should settle to active/idle status:

```
$  juju status openstack-exporter
...

App                 Version  Status  Scale  Charm               Channel      Rev  Exposed  Message
grafana-agent                active      1  grafana-agent       latest/edge   96  no
openstack-exporter           active      1  openstack-exporter  latest/edge   10  no

Unit                   Workload  Agent  Machine  Public address  Ports  Message
openstack-exporter/0*  active    idle   15       10.5.0.233
  grafana-agent/0*     active    idle            10.5.0.233
```

## [View the Grafana dashboards](https://charmhub.io/openstack-exporter/docs/tutorial#p-31169-view-the-grafana-dashboards)

Navigate to the Grafana web ui and click the dashboards tab. Under the “General” folder, you should see the three dashboards:

See the [Grafana Dashboards](https://charmhub.io/openstack-exporter/docs/grafana-dashboards) section of the docs for more information about the provided dashboards.

Example screenshot from the OpenStack Hypervisor Overview dashboard, displaying information about cpu, memory, and disk usages for the hypervisors, and stats on instances running on the cloud:

---