Abstract base class for monitoring backends. More...

#include <monitoring_backend.h>

Inheritance diagram for database::integrated::adapters::backends::monitoring_backend:

Collaboration diagram for database::integrated::adapters::backends::monitoring_backend:

Public Member Functions
virtual	~monitoring_backend ()=default

virtual common::VoidResult	initialize ()=0
	Initialize the monitoring backend.

virtual common::VoidResult	shutdown ()=0
	Shutdown the monitoring backend gracefully.

virtual bool	is_initialized () const =0
	Check if backend is initialized.

virtual common::VoidResult	record_metric (const std::string &name, double value)=0
	Record a metric value.

virtual common::VoidResult	record_metric (const std::string &name, double value, const std::unordered_map< std::string, std::string > &tags)=0
	Record a metric value with tags.

virtual common::Result< metrics_snapshot >	get_metrics ()=0
	Get current metrics snapshot.

virtual common::Result< health_check_result >	check_health ()=0
	Perform health check.

virtual common::VoidResult	reset ()=0
	Reset all metrics.

virtual void	record_query_execution (std::chrono::microseconds duration, bool success)=0
	Record query execution.

virtual void	record_connection_acquired ()=0
	Record connection acquisition.

virtual void	record_connection_released ()=0
	Record connection release.

virtual void	update_pool_stats (std::size_t active, std::size_t idle, std::size_t total)=0
	Update connection pool statistics.

virtual void	record_transaction_begin ()=0
	Record transaction begin.

virtual void	record_transaction_commit ()=0
	Record transaction commit.

virtual void	record_transaction_rollback ()=0
	Record transaction rollback.

virtual common::Result< database_metrics >	get_database_metrics ()=0
	Get database-specific metrics.

virtual std::string	export_prometheus_metrics ()=0
	Export metrics in Prometheus format.

Detailed Description

Abstract base class for monitoring backends.

All monitoring backends (system, fallback, null) must implement this interface. This enables runtime polymorphism and eliminates conditional compilation.

Definition at line 74 of file monitoring_backend.h.

Constructor & Destructor Documentation

◆ ~monitoring_backend()

virtual database::integrated::adapters::backends::monitoring_backend::~monitoring_backend ( )

virtualdefault

Member Function Documentation

◆ check_health()

virtual common::Result< health_check_result > database::integrated::adapters::backends::monitoring_backend::check_health ( )

pure virtual

Perform health check.

Returns: Health check result

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ export_prometheus_metrics()

virtual std::string database::integrated::adapters::backends::monitoring_backend::export_prometheus_metrics ( )

pure virtual

Export metrics in Prometheus format.

Returns: Prometheus-formatted metrics string

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ get_database_metrics()

virtual common::Result< database_metrics > database::integrated::adapters::backends::monitoring_backend::get_database_metrics ( )

pure virtual

Get database-specific metrics.

Returns: Database metrics on success

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ get_metrics()

virtual common::Result< metrics_snapshot > database::integrated::adapters::backends::monitoring_backend::get_metrics ( )

pure virtual

Get current metrics snapshot.

Returns: Metrics snapshot on success

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ initialize()

virtual common::VoidResult database::integrated::adapters::backends::monitoring_backend::initialize ( )

pure virtual

Initialize the monitoring backend.

Returns: VoidResult::ok() on success, error on failure

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ is_initialized()

virtual bool database::integrated::adapters::backends::monitoring_backend::is_initialized ( ) const

pure virtual

Check if backend is initialized.

Returns: true if initialized and ready

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ record_connection_acquired()

virtual void database::integrated::adapters::backends::monitoring_backend::record_connection_acquired ( )

pure virtual

Record connection acquisition.

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ record_connection_released()

virtual void database::integrated::adapters::backends::monitoring_backend::record_connection_released ( )

pure virtual

Record connection release.

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ record_metric() [1/2]

virtual common::VoidResult database::integrated::adapters::backends::monitoring_backend::record_metric	(	const std::string &	name,
		double	value )

pure virtual

Record a metric value.

Parameters

name	Metric name
value	Metric value

Returns: VoidResult::ok() on success

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ record_metric() [2/2]

virtual common::VoidResult database::integrated::adapters::backends::monitoring_backend::record_metric	(	const std::string &	name,
		double	value,
		const std::unordered_map< std::string, std::string > &	tags )

pure virtual

Record a metric value with tags.

Parameters

name	Metric name
value	Metric value
tags	Metric tags/labels

Returns: VoidResult::ok() on success

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ record_query_execution()

virtual void database::integrated::adapters::backends::monitoring_backend::record_query_execution	(	std::chrono::microseconds	duration,
		bool	success )

pure virtual

Record query execution.

Parameters

duration	Query execution duration
success	Whether query succeeded

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ record_transaction_begin()

virtual void database::integrated::adapters::backends::monitoring_backend::record_transaction_begin ( )

pure virtual

Record transaction begin.

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ record_transaction_commit()

virtual void database::integrated::adapters::backends::monitoring_backend::record_transaction_commit ( )

pure virtual

Record transaction commit.

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ record_transaction_rollback()

virtual void database::integrated::adapters::backends::monitoring_backend::record_transaction_rollback ( )

pure virtual

Record transaction rollback.

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ reset()

virtual common::VoidResult database::integrated::adapters::backends::monitoring_backend::reset ( )

pure virtual

Reset all metrics.

Returns: VoidResult::ok() on success

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ shutdown()

virtual common::VoidResult database::integrated::adapters::backends::monitoring_backend::shutdown ( )

pure virtual

Shutdown the monitoring backend gracefully.

Returns: VoidResult::ok() on success, error on failure

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

◆ update_pool_stats()

virtual void database::integrated::adapters::backends::monitoring_backend::update_pool_stats	(	std::size_t	active,
		std::size_t	idle,
		std::size_t	total )

pure virtual

Update connection pool statistics.

Parameters

active	Number of active connections
idle	Number of idle connections
total	Total pool size

Implemented in database::integrated::adapters::backends::fallback_monitoring_backend, database::integrated::adapters::backends::null_monitoring_backend, and database::integrated::adapters::backends::system_monitoring_backend.

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

database/integrated/adapters/backends/monitoring_backend.h

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~monitoring_backend()

Member Function Documentation

◆ check_health()

◆ export_prometheus_metrics()

◆ get_database_metrics()

◆ get_metrics()

◆ initialize()

◆ is_initialized()

◆ record_connection_acquired()

◆ record_connection_released()

◆ record_metric() [1/2]

◆ record_metric() [2/2]

◆ record_query_execution()

◆ record_transaction_begin()

◆ record_transaction_commit()

◆ record_transaction_rollback()

◆ reset()

◆ shutdown()

◆ update_pool_stats()