prometheus.hpp

Go to the documentation of this file.

#pragma once
 
/// @file userver/utils/statistics/prometheus.hpp
/// @brief Statistics output in Prometheus format.
 
#include <string>
 
#include <userver/utils/statistics/storage.hpp>
 
USERVER_NAMESPACE_BEGIN
 
namespace utils::statistics {
 
namespace impl {
 
// The metric name specifies the general feature of a system that is measured
// (e.g. http_requests_total - the total number of HTTP requests received).
// It may contain ASCII letters and digits, as well as underscores and colons.
// It must match the regex [a-zA-Z_][a-zA-Z0-9_]*.
std::string ToPrometheusName(std::string_view data);
 
// Label names may contain ASCII letters, numbers, as well as underscores.
// They must match the regex [a-zA-Z_][a-zA-Z0-9_]*.
// Label names beginning with __ are reserved for internal use.
std::string ToPrometheusLabel(std::string_view name);
 
}  // namespace impl
 
/// Output `statistics` in Prometheus format, each metric has `gauge` type.
std::string ToPrometheusFormat(
    const utils::statistics::Storage& statistics,
    const utils::statistics::Request& request = {}
);
 
/// Output `statistics` in Prometheus format, without metric types.
std::string ToPrometheusFormatUntyped(
    const utils::statistics::Storage& statistics,
    const utils::statistics::Request& request = {}
);
 
}  // namespace utils::statistics
 
USERVER_NAMESPACE_END