ESPHome  2025.2.0
Public Member Functions | Protected Member Functions | Protected Attributes
esphome::prometheus::PrometheusHandler Class Reference

#include <prometheus_handler.h>

Inheritance diagram for esphome::prometheus::PrometheusHandler:
esphome::Component

Public Member Functions

 PrometheusHandler (web_server_base::WebServerBase *base)
 
void set_include_internal (bool include_internal)
 Determine whether internal components should be exported as metrics. More...
 
void add_label_id (EntityBase *obj, const std::string &value)
 Add the value for an entity's "id" label. More...
 
void add_label_name (EntityBase *obj, const std::string &value)
 Add the value for an entity's "name" label. More...
 
bool canHandle (AsyncWebServerRequest *request) override
 
void handleRequest (AsyncWebServerRequest *req) override
 
void setup () override
 
float get_setup_priority () const override
 
- Public Member Functions inherited from esphome::Component
virtual void loop ()
 This method will be called repeatedly. More...
 
virtual void dump_config ()
 
float get_actual_setup_priority () const
 
void set_setup_priority (float priority)
 
virtual float get_loop_priority () const
 priority of loop(). More...
 
void call ()
 
virtual void on_shutdown ()
 
virtual void on_safe_shutdown ()
 
uint32_t get_component_state () const
 
virtual void mark_failed ()
 Mark this component as failed. More...
 
bool is_failed () const
 
bool is_ready () const
 
virtual bool can_proceed ()
 
bool status_has_warning () const
 
bool status_has_error () const
 
void status_set_warning (const char *message="unspecified")
 
void status_set_error (const char *message="unspecified")
 
void status_clear_warning ()
 
void status_clear_error ()
 
void status_momentary_warning (const std::string &name, uint32_t length=5000)
 
void status_momentary_error (const std::string &name, uint32_t length=5000)
 
bool has_overridden_loop () const
 
void set_component_source (const char *source)
 Set where this component was loaded from for some debug messages. More...
 
const char * get_component_source () const
 Get the integration where this component was declared as a string. More...
 

Protected Member Functions

std::string relabel_id_ (EntityBase *obj)
 
std::string relabel_name_ (EntityBase *obj)
 
void add_area_label_ (AsyncResponseStream *stream, std::string &area)
 
void add_node_label_ (AsyncResponseStream *stream, std::string &node)
 
void add_friendly_name_label_ (AsyncResponseStream *stream, std::string &friendly_name)
 
void sensor_type_ (AsyncResponseStream *stream)
 Return the type for prometheus. More...
 
void sensor_row_ (AsyncResponseStream *stream, sensor::Sensor *obj, std::string &area, std::string &node, std::string &friendly_name)
 Return the sensor state as prometheus data point. More...
 
void binary_sensor_type_ (AsyncResponseStream *stream)
 Return the type for prometheus. More...
 
void binary_sensor_row_ (AsyncResponseStream *stream, binary_sensor::BinarySensor *obj, std::string &area, std::string &node, std::string &friendly_name)
 Return the binary sensor state as prometheus data point. More...
 
void fan_type_ (AsyncResponseStream *stream)
 Return the type for prometheus. More...
 
void fan_row_ (AsyncResponseStream *stream, fan::Fan *obj, std::string &area, std::string &node, std::string &friendly_name)
 Return the fan state as prometheus data point. More...
 
void light_type_ (AsyncResponseStream *stream)
 Return the type for prometheus. More...
 
void light_row_ (AsyncResponseStream *stream, light::LightState *obj, std::string &area, std::string &node, std::string &friendly_name)
 Return the light values state as prometheus data point. More...
 
void cover_type_ (AsyncResponseStream *stream)
 Return the type for prometheus. More...
 
void cover_row_ (AsyncResponseStream *stream, cover::Cover *obj, std::string &area, std::string &node, std::string &friendly_name)
 Return the cover values state as prometheus data point. More...
 
void switch_type_ (AsyncResponseStream *stream)
 Return the type for prometheus. More...
 
void switch_row_ (AsyncResponseStream *stream, switch_::Switch *obj, std::string &area, std::string &node, std::string &friendly_name)
 Return the switch values state as prometheus data point. More...
 
void lock_type_ (AsyncResponseStream *stream)
 Return the type for prometheus. More...
 
void lock_row_ (AsyncResponseStream *stream, lock::Lock *obj, std::string &area, std::string &node, std::string &friendly_name)
 Return the lock values state as prometheus data point. More...
 
void text_sensor_type_ (AsyncResponseStream *stream)
 Return the type for prometheus. More...
 
void text_sensor_row_ (AsyncResponseStream *stream, text_sensor::TextSensor *obj, std::string &area, std::string &node, std::string &friendly_name)
 Return the text sensor values state as prometheus data point. More...
 
void number_type_ (AsyncResponseStream *stream)
 Return the type for prometheus. More...
 
void number_row_ (AsyncResponseStream *stream, number::Number *obj, std::string &area, std::string &node, std::string &friendly_name)
 Return the number state as prometheus data point. More...
 
void select_type_ (AsyncResponseStream *stream)
 Return the type for prometheus. More...
 
void select_row_ (AsyncResponseStream *stream, select::Select *obj, std::string &area, std::string &node, std::string &friendly_name)
 Return the select state as prometheus data point. More...
 
void media_player_type_ (AsyncResponseStream *stream)
 Return the type for prometheus. More...
 
void media_player_row_ (AsyncResponseStream *stream, media_player::MediaPlayer *obj, std::string &area, std::string &node, std::string &friendly_name)
 Return the media player state as prometheus data point. More...
 
void update_entity_type_ (AsyncResponseStream *stream)
 Return the type for prometheus. More...
 
void update_entity_row_ (AsyncResponseStream *stream, update::UpdateEntity *obj, std::string &area, std::string &node, std::string &friendly_name)
 Return the update state and info as prometheus data point. More...
 
void handle_update_state_ (AsyncResponseStream *stream, update::UpdateState state)
 
void valve_type_ (AsyncResponseStream *stream)
 Return the type for prometheus. More...
 
void valve_row_ (AsyncResponseStream *stream, valve::Valve *obj, std::string &area, std::string &node, std::string &friendly_name)
 Return the valve state as prometheus data point. More...
 
- Protected Member Functions inherited from esphome::Component
virtual void call_loop ()
 
virtual void call_setup ()
 
virtual void call_dump_config ()
 
void set_interval (const std::string &name, uint32_t interval, std::function< void()> &&f)
 Set an interval function with a unique name. More...
 
void set_interval (uint32_t interval, std::function< void()> &&f)
 
bool cancel_interval (const std::string &name)
 Cancel an interval function. More...
 
void set_retry (const std::string &name, uint32_t initial_wait_time, uint8_t max_attempts, std::function< RetryResult(uint8_t)> &&f, float backoff_increase_factor=1.0f)
 Set an retry function with a unique name. More...
 
void set_retry (uint32_t initial_wait_time, uint8_t max_attempts, std::function< RetryResult(uint8_t)> &&f, float backoff_increase_factor=1.0f)
 
bool cancel_retry (const std::string &name)
 Cancel a retry function. More...
 
void set_timeout (const std::string &name, uint32_t timeout, std::function< void()> &&f)
 Set a timeout function with a unique name. More...
 
void set_timeout (uint32_t timeout, std::function< void()> &&f)
 
bool cancel_timeout (const std::string &name)
 Cancel a timeout function. More...
 
void defer (const std::string &name, std::function< void()> &&f)
 Defer a callback to the next loop() call. More...
 
void defer (std::function< void()> &&f)
 Defer a callback to the next loop() call. More...
 
bool cancel_defer (const std::string &name)
 Cancel a defer callback using the specified name, name must not be empty. More...
 

Protected Attributes

web_server_base::WebServerBasebase_
 
bool include_internal_ {false}
 
std::map< EntityBase *, std::string > relabel_map_id_
 
std::map< EntityBase *, std::string > relabel_map_name_
 
- Protected Attributes inherited from esphome::Component
uint32_t component_state_ {0x0000}
 State of this component. More...
 
float setup_priority_override_ {NAN}
 
const char * component_source_ {nullptr}
 

Detailed Description

Definition at line 15 of file prometheus_handler.h.

Constructor & Destructor Documentation

◆ PrometheusHandler()

esphome::prometheus::PrometheusHandler::PrometheusHandler ( web_server_base::WebServerBase base)
inline

Definition at line 17 of file prometheus_handler.h.

Member Function Documentation

◆ add_area_label_()

void esphome::prometheus::PrometheusHandler::add_area_label_ ( AsyncResponseStream *  stream,
std::string &  area 
)
protected

Definition at line 105 of file prometheus_handler.cpp.

◆ add_friendly_name_label_()

void esphome::prometheus::PrometheusHandler::add_friendly_name_label_ ( AsyncResponseStream *  stream,
std::string &  friendly_name 
)
protected

Definition at line 119 of file prometheus_handler.cpp.

◆ add_label_id()

void esphome::prometheus::PrometheusHandler::add_label_id ( EntityBase obj,
const std::string &  value 
)
inline

Add the value for an entity's "id" label.

Parameters
objThe entity for which to set the "id" label
valueThe value for the "id" label

Definition at line 31 of file prometheus_handler.h.

◆ add_label_name()

void esphome::prometheus::PrometheusHandler::add_label_name ( EntityBase obj,
const std::string &  value 
)
inline

Add the value for an entity's "name" label.

Parameters
objThe entity for which to set the "name" label
valueThe value for the "name" label

Definition at line 38 of file prometheus_handler.h.

◆ add_node_label_()

void esphome::prometheus::PrometheusHandler::add_node_label_ ( AsyncResponseStream *  stream,
std::string &  node 
)
protected

Definition at line 112 of file prometheus_handler.cpp.

◆ binary_sensor_row_()

void esphome::prometheus::PrometheusHandler::binary_sensor_row_ ( AsyncResponseStream *  stream,
binary_sensor::BinarySensor obj,
std::string &  area,
std::string &  node,
std::string &  friendly_name 
)
protected

Return the binary sensor state as prometheus data point.

Definition at line 179 of file prometheus_handler.cpp.

◆ binary_sensor_type_()

void esphome::prometheus::PrometheusHandler::binary_sensor_type_ ( AsyncResponseStream *  stream)
protected

Return the type for prometheus.

Definition at line 175 of file prometheus_handler.cpp.

◆ canHandle()

bool esphome::prometheus::PrometheusHandler::canHandle ( AsyncWebServerRequest *  request)
inlineoverride

Definition at line 40 of file prometheus_handler.h.

◆ cover_row_()

void esphome::prometheus::PrometheusHandler::cover_row_ ( AsyncResponseStream *  stream,
cover::Cover obj,
std::string &  area,
std::string &  node,
std::string &  friendly_name 
)
protected

Return the cover values state as prometheus data point.

Definition at line 384 of file prometheus_handler.cpp.

◆ cover_type_()

void esphome::prometheus::PrometheusHandler::cover_type_ ( AsyncResponseStream *  stream)
protected

Return the type for prometheus.

Definition at line 380 of file prometheus_handler.cpp.

◆ fan_row_()

void esphome::prometheus::PrometheusHandler::fan_row_ ( AsyncResponseStream *  stream,
fan::Fan obj,
std::string &  area,
std::string &  node,
std::string &  friendly_name 
)
protected

Return the fan state as prometheus data point.

Definition at line 225 of file prometheus_handler.cpp.

◆ fan_type_()

void esphome::prometheus::PrometheusHandler::fan_type_ ( AsyncResponseStream *  stream)
protected

Return the type for prometheus.

Definition at line 219 of file prometheus_handler.cpp.

◆ get_setup_priority()

float esphome::prometheus::PrometheusHandler::get_setup_priority ( ) const
inlineoverridevirtual

Reimplemented from esphome::Component.

Definition at line 55 of file prometheus_handler.h.

◆ handle_update_state_()

void esphome::prometheus::PrometheusHandler::handle_update_state_ ( AsyncResponseStream *  stream,
update::UpdateState  state 
)
protected

Definition at line 701 of file prometheus_handler.cpp.

◆ handleRequest()

void esphome::prometheus::PrometheusHandler::handleRequest ( AsyncWebServerRequest *  req)
override

Definition at line 8 of file prometheus_handler.cpp.

◆ light_row_()

void esphome::prometheus::PrometheusHandler::light_row_ ( AsyncResponseStream *  stream,
light::LightState obj,
std::string &  area,
std::string &  node,
std::string &  friendly_name 
)
protected

Return the light values state as prometheus data point.

Definition at line 283 of file prometheus_handler.cpp.

◆ light_type_()

void esphome::prometheus::PrometheusHandler::light_type_ ( AsyncResponseStream *  stream)
protected

Return the type for prometheus.

Definition at line 278 of file prometheus_handler.cpp.

◆ lock_row_()

void esphome::prometheus::PrometheusHandler::lock_row_ ( AsyncResponseStream *  stream,
lock::Lock obj,
std::string &  area,
std::string &  node,
std::string &  friendly_name 
)
protected

Return the lock values state as prometheus data point.

Definition at line 471 of file prometheus_handler.cpp.

◆ lock_type_()

void esphome::prometheus::PrometheusHandler::lock_type_ ( AsyncResponseStream *  stream)
protected

Return the type for prometheus.

Definition at line 467 of file prometheus_handler.cpp.

◆ media_player_row_()

void esphome::prometheus::PrometheusHandler::media_player_row_ ( AsyncResponseStream *  stream,
media_player::MediaPlayer obj,
std::string &  area,
std::string &  node,
std::string &  friendly_name 
)
protected

Return the media player state as prometheus data point.

Definition at line 642 of file prometheus_handler.cpp.

◆ media_player_type_()

void esphome::prometheus::PrometheusHandler::media_player_type_ ( AsyncResponseStream *  stream)
protected

Return the type for prometheus.

Definition at line 636 of file prometheus_handler.cpp.

◆ number_row_()

void esphome::prometheus::PrometheusHandler::number_row_ ( AsyncResponseStream *  stream,
number::Number obj,
std::string &  area,
std::string &  node,
std::string &  friendly_name 
)
protected

Return the number state as prometheus data point.

Definition at line 550 of file prometheus_handler.cpp.

◆ number_type_()

void esphome::prometheus::PrometheusHandler::number_type_ ( AsyncResponseStream *  stream)
protected

Return the type for prometheus.

Definition at line 546 of file prometheus_handler.cpp.

◆ relabel_id_()

std::string esphome::prometheus::PrometheusHandler::relabel_id_ ( EntityBase obj)
protected

Definition at line 95 of file prometheus_handler.cpp.

◆ relabel_name_()

std::string esphome::prometheus::PrometheusHandler::relabel_name_ ( EntityBase obj)
protected

Definition at line 100 of file prometheus_handler.cpp.

◆ select_row_()

void esphome::prometheus::PrometheusHandler::select_row_ ( AsyncResponseStream *  stream,
select::Select obj,
std::string &  area,
std::string &  node,
std::string &  friendly_name 
)
protected

Return the select state as prometheus data point.

Definition at line 594 of file prometheus_handler.cpp.

◆ select_type_()

void esphome::prometheus::PrometheusHandler::select_type_ ( AsyncResponseStream *  stream)
protected

Return the type for prometheus.

Definition at line 590 of file prometheus_handler.cpp.

◆ sensor_row_()

void esphome::prometheus::PrometheusHandler::sensor_row_ ( AsyncResponseStream *  stream,
sensor::Sensor obj,
std::string &  area,
std::string &  node,
std::string &  friendly_name 
)
protected

Return the sensor state as prometheus data point.

Definition at line 132 of file prometheus_handler.cpp.

◆ sensor_type_()

void esphome::prometheus::PrometheusHandler::sensor_type_ ( AsyncResponseStream *  stream)
protected

Return the type for prometheus.

Definition at line 128 of file prometheus_handler.cpp.

◆ set_include_internal()

void esphome::prometheus::PrometheusHandler::set_include_internal ( bool  include_internal)
inline

Determine whether internal components should be exported as metrics.

Defaults to false.

Parameters
include_internalWhether internal components should be exported.

Definition at line 24 of file prometheus_handler.h.

◆ setup()

void esphome::prometheus::PrometheusHandler::setup ( )
inlineoverridevirtual

Reimplemented from esphome::Component.

Definition at line 51 of file prometheus_handler.h.

◆ switch_row_()

void esphome::prometheus::PrometheusHandler::switch_row_ ( AsyncResponseStream *  stream,
switch_::Switch obj,
std::string &  area,
std::string &  node,
std::string &  friendly_name 
)
protected

Return the switch values state as prometheus data point.

Definition at line 440 of file prometheus_handler.cpp.

◆ switch_type_()

void esphome::prometheus::PrometheusHandler::switch_type_ ( AsyncResponseStream *  stream)
protected

Return the type for prometheus.

Definition at line 436 of file prometheus_handler.cpp.

◆ text_sensor_row_()

void esphome::prometheus::PrometheusHandler::text_sensor_row_ ( AsyncResponseStream *  stream,
text_sensor::TextSensor obj,
std::string &  area,
std::string &  node,
std::string &  friendly_name 
)
protected

Return the text sensor values state as prometheus data point.

Definition at line 503 of file prometheus_handler.cpp.

◆ text_sensor_type_()

void esphome::prometheus::PrometheusHandler::text_sensor_type_ ( AsyncResponseStream *  stream)
protected

Return the type for prometheus.

Definition at line 499 of file prometheus_handler.cpp.

◆ update_entity_row_()

void esphome::prometheus::PrometheusHandler::update_entity_row_ ( AsyncResponseStream *  stream,
update::UpdateEntity obj,
std::string &  area,
std::string &  node,
std::string &  friendly_name 
)
protected

Return the update state and info as prometheus data point.

Definition at line 721 of file prometheus_handler.cpp.

◆ update_entity_type_()

void esphome::prometheus::PrometheusHandler::update_entity_type_ ( AsyncResponseStream *  stream)
protected

Return the type for prometheus.

Definition at line 695 of file prometheus_handler.cpp.

◆ valve_row_()

void esphome::prometheus::PrometheusHandler::valve_row_ ( AsyncResponseStream *  stream,
valve::Valve obj,
std::string &  area,
std::string &  node,
std::string &  friendly_name 
)
protected

Return the valve state as prometheus data point.

Definition at line 786 of file prometheus_handler.cpp.

◆ valve_type_()

void esphome::prometheus::PrometheusHandler::valve_type_ ( AsyncResponseStream *  stream)
protected

Return the type for prometheus.

Definition at line 780 of file prometheus_handler.cpp.

Field Documentation

◆ base_

web_server_base::WebServerBase* esphome::prometheus::PrometheusHandler::base_
protected

Definition at line 172 of file prometheus_handler.h.

◆ include_internal_

bool esphome::prometheus::PrometheusHandler::include_internal_ {false}
protected

Definition at line 173 of file prometheus_handler.h.

◆ relabel_map_id_

std::map<EntityBase *, std::string> esphome::prometheus::PrometheusHandler::relabel_map_id_
protected

Definition at line 174 of file prometheus_handler.h.

◆ relabel_map_name_

std::map<EntityBase *, std::string> esphome::prometheus::PrometheusHandler::relabel_map_name_
protected

Definition at line 175 of file prometheus_handler.h.


The documentation for this class was generated from the following files: