---
id: oslo-metrics
version: "0.16.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# oslo.metrics — Oslo Metrics library

License: permissive · Maintenance: active · Downloads: 345.1K/mo

## What it is and what it does

Oslo Metrics is a library that provides a standardized API for collecting metrics data from other Oslo libraries and exposing that data to monitoring systems. It is part of the OpenStack Oslo project and integrates with prometheus-client to bridge application-level metrics collection with external monitoring infrastructure.

The package is intended for use within OpenStack deployments and services that need to instrument their code and report metrics to centralized monitoring. It abstracts the metrics collection interface so that Oslo libraries can emit metrics without tight coupling to a specific monitoring backend.

Use it for:

- Instrument OpenStack services to collect performance and operational metrics for export to Prometheus or other monitoring systems.
- Aggregate metrics from multiple Oslo libraries into a single, unified metrics API for centralized observability.
- Enable real-time monitoring of OpenStack component health, resource usage, and request latencies.
- Build custom dashboards and alerts based on metrics collected from OpenStack infrastructure.
- Track application-level events and state changes in long-running OpenStack services.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Collects and exposes metrics data from Oslo libraries to monitoring systems via a standardized metrics API.

Yes, if you are building or deploying OpenStack services or integrating with the Oslo library ecosystem. The package is actively maintained, has no known vulnerabilities, and provides a clean abstraction for metrics collection. Not relevant for non-OpenStack projects.

## Install

pip install oslo-metrics
uv add oslo-metrics
poetry add oslo-metrics

## Installing oslo.metrics

Before you install: Low install friction with a pure-wheel distribution. Active maintenance status and recent release (88 days ago) indicate ongoing support. Runtime dependency on prometheus-client and other Oslo libraries is standard for OpenStack ecosystem packages.

License in practice: Apache-2.0 permissive license allows use in commercial and proprietary projects with minimal restrictions—include a copy of the license and note material changes.

Quickstart:

pip install oslo-metrics

from oslo_metrics import api
metrics = api.get_metrics()

Requires Python 3.10 or later; designed for OpenStack environments.

Verify before relying:

- Whether the package provides direct Prometheus exposition or requires additional setup to expose metrics to a monitoring backend.
- What specific metrics types (counters, gauges, histograms) the API supports.
- How metrics collection integrates with existing Oslo library instrumentation.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 345.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

oslo metrics collection, openstack metrics library, prometheus metrics oslo, monitoring system integration, metrics data exposure, openstack telemetry, application metrics api, openstack, observability, prometheus

[View on SkillFed](https://skillfed.io/packages/oslo-metrics) · [View on PyPI](https://pypi.org/project/oslo-metrics/)