Writes each log message to a unique file with automatic cleanup. More...

#include <UniqueFileLogger.hpp>

Inheritance diagram for logit::UniqueFileLogger:

Classes
struct	Config
	Configuration for the unique file logger. More...

struct	ThreadLogInfo

Public Member Functions
	UniqueFileLogger ()
	Default constructor that uses default configuration.

	UniqueFileLogger (const Config &config)
	Constructor with custom configuration.

	UniqueFileLogger (const std::string &directory, bool async=true, int auto_delete_days=30, size_t hash_length=8)
	Constructor with directory and asynchronous flag.

virtual	~UniqueFileLogger ()

void	log (const LogRecord &record, const std::string &message) override
	Logs a message to a unique file with thread safety.

std::string	get_string_param (const LoggerParam &param) const override
	Retrieves a string parameter from the logger.

int64_t	get_int_param (const LoggerParam &param) const override
	Retrieves an integer parameter from the logger.

double	get_float_param (const LoggerParam &param) const override
	Retrieves a floating-point parameter from the logger.

void	set_log_level (LogLevel level) override
	Sets the minimal log level for this logger.

LogLevel	get_log_level () const override
	Gets the minimal log level for this logger.

void	wait () override
	Waits for all asynchronous tasks to complete.

Public Member Functions inherited from logit::ILogger
virtual	~ILogger ()=default

Private Member Functions
void	start_logging ()
	Starts the logging process by initializing the directory and removing old logs.

void	stop_logging ()
	Stops the logging process by waiting for tasks.

void	initialize_directory ()
	Initializes the logging directory.

std::string	get_directory_path () const
	Gets the full path to the logging directory.

std::string	write_log (const std::string &message, const int64_t &timestamp_ms)
	Writes a log message to a unique file.

std::string	create_unique_file_path (const int64_t &timestamp_ms) const
	Creates a unique file path based on the timestamp and a hash.

std::string	format_timestamp (const int64_t &timestamp_ms) const
	Formats the timestamp into a string with date and time.

std::string	generate_fixed_length_hash (size_t length) const
	Generates a fixed-length hash string.

void	remove_old_logs ()
	Removes old log files based on the auto-delete days configuration.

bool	is_valid_log_filename (const std::string &filename) const
	Checks if the filename matches the log file naming pattern.

int64_t	get_timestamp_from_filename (const std::string &filename) const
	Extracts the timestamp from the filename.

int64_t	current_timestamp_ms () const
	Gets the current timestamp in milliseconds.

std::string	get_last_log_file_name () const
	Retrieves the last log file name for the calling thread.

std::string	get_last_log_file_path () const
	Retrieves the last log file path for the calling thread.

int64_t	get_last_log_ts () const
	Retrieves the timestamp of the last log.

int64_t	get_time_since_last_log () const
	Retrieves the time elapsed since the last log.

Private Attributes
std::mutex	m_mutex
	Mutex to protect file operations.

Config	m_config
	Configuration for the unique file logger.

std::mutex	m_thread_log_info_mutex
	Mutex to protect access to thread log information.

std::condition_variable	m_pending_logs_cv
	Condition variable to wait for pending logs to finish.

std::unordered_map< std::thread::id, ThreadLogInfo >	m_thread_log_info
	Map to store log information per thread.

std::atomic< int64_t >	m_last_log_ts = ATOMIC_VAR_INIT(0)
	Timestamp of the last log.

std::atomic< int >	m_log_level = ATOMIC_VAR_INIT(static_cast<int>(LogLevel::LOG_LVL_TRACE))

Detailed Description

Writes each log message to a unique file with automatic cleanup.

This logger generates a unique file for each log message. The filename includes a timestamp and a hash to ensure uniqueness. It also deletes old log files after a specified number of days.

Key Features:

Unique file generation for each log message.
Automatic deletion of old files.
Synchronous or asynchronous operation.

Definition at line 66 of file UniqueFileLogger.hpp.

Constructor & Destructor Documentation

◆ UniqueFileLogger() [1/3]

logit::UniqueFileLogger::UniqueFileLogger ( )

inline

Default constructor that uses default configuration.

Definition at line 79 of file UniqueFileLogger.hpp.

◆ UniqueFileLogger() [2/3]

logit::UniqueFileLogger::UniqueFileLogger ( const Config & config )

inline

Constructor with custom configuration.

Parameters

config The configuration for the logger.

Definition at line 85 of file UniqueFileLogger.hpp.

◆ UniqueFileLogger() [3/3]

logit::UniqueFileLogger::UniqueFileLogger	(	const std::string &	directory,
		bool	async = true,
		int	auto_delete_days = 30,
		size_t	hash_length = 8 )

inline

Constructor with directory and asynchronous flag.

Parameters

directory	The directory where log files will be stored.
async	Boolean flag for asynchronous logging.
auto_delete_days	Number of days after which old log files are deleted.
hash_length	Length of the hash used in filenames.

Definition at line 94 of file UniqueFileLogger.hpp.

◆ ~UniqueFileLogger()

virtual logit::UniqueFileLogger::~UniqueFileLogger ( )

inlinevirtual

Definition at line 106 of file UniqueFileLogger.hpp.

Member Function Documentation

◆ create_unique_file_path()

std::string logit::UniqueFileLogger::create_unique_file_path ( const int64_t & timestamp_ms ) const

inlineprivate

Creates a unique file path based on the timestamp and a hash.

Parameters

timestamp_ms The timestamp in milliseconds.

Returns: The unique file path.

Definition at line 336 of file UniqueFileLogger.hpp.

◆ current_timestamp_ms()

int64_t logit::UniqueFileLogger::current_timestamp_ms ( ) const

inlineprivate

Gets the current timestamp in milliseconds.

Returns: The current timestamp in milliseconds.

Definition at line 434 of file UniqueFileLogger.hpp.

◆ format_timestamp()

std::string logit::UniqueFileLogger::format_timestamp ( const int64_t & timestamp_ms ) const

inlineprivate

Formats the timestamp into a string with date and time.

Parameters

timestamp_ms The timestamp in milliseconds.

Returns: The formatted timestamp string.

Definition at line 345 of file UniqueFileLogger.hpp.

◆ generate_fixed_length_hash()

std::string logit::UniqueFileLogger::generate_fixed_length_hash ( size_t length ) const

inlineprivate

Generates a fixed-length hash string.

Parameters

length The desired length of the hash.

Returns: The hash string.

Definition at line 355 of file UniqueFileLogger.hpp.

◆ get_directory_path()

std::string logit::UniqueFileLogger::get_directory_path ( ) const

inlineprivate

Gets the full path to the logging directory.

Returns: The path to the logging directory.

Definition at line 310 of file UniqueFileLogger.hpp.

◆ get_float_param()

double logit::UniqueFileLogger::get_float_param ( const LoggerParam & param ) const

inlineoverridevirtual

Retrieves a floating-point parameter from the logger.

Parameters

param The logger parameter to retrieve.

Returns: A double representing the requested parameter, or 0.0 if the parameter is unsupported.

Implements logit::ILogger.

Definition at line 232 of file UniqueFileLogger.hpp.

◆ get_int_param()

int64_t logit::UniqueFileLogger::get_int_param ( const LoggerParam & param ) const

inlineoverridevirtual

Retrieves an integer parameter from the logger.

Parameters

param The logger parameter to retrieve.

Returns: An integer representing the requested parameter, or 0 if the parameter is unsupported.

Implements logit::ILogger.

Definition at line 219 of file UniqueFileLogger.hpp.

◆ get_last_log_file_name()

std::string logit::UniqueFileLogger::get_last_log_file_name ( ) const

inlineprivate

Retrieves the last log file name for the calling thread.

This method waits until all pending log messages for the calling thread have been processed. It then returns the name of the last file that the calling thread wrote a log message to.

Returns: The last log file name for the calling thread, or an empty string if none exists.

Definition at line 444 of file UniqueFileLogger.hpp.

◆ get_last_log_file_path()

std::string logit::UniqueFileLogger::get_last_log_file_path ( ) const

inlineprivate

Retrieves the last log file path for the calling thread.

This method waits until all pending log messages for the calling thread have been processed. It then returns the path of the last file that the calling thread wrote a log message to.

Returns: The last log file path for the calling thread, or an empty string if none exists.

Definition at line 464 of file UniqueFileLogger.hpp.

◆ get_last_log_ts()

int64_t logit::UniqueFileLogger::get_last_log_ts ( ) const

inlineprivate

Retrieves the timestamp of the last log.

Returns: The timestamp of the last log in milliseconds.

Definition at line 480 of file UniqueFileLogger.hpp.

◆ get_log_level()

LogLevel logit::UniqueFileLogger::get_log_level ( ) const

inlineoverridevirtual

Gets the minimal log level for this logger.

Implements logit::ILogger.

Definition at line 248 of file UniqueFileLogger.hpp.

◆ get_string_param()

std::string logit::UniqueFileLogger::get_string_param ( const LoggerParam & param ) const

inlineoverridevirtual

Retrieves a string parameter from the logger.

Parameters

param The logger parameter to retrieve.

Returns: A string representing the requested parameter, or an empty string if the parameter is unsupported.

Implements logit::ILogger.

Definition at line 204 of file UniqueFileLogger.hpp.

◆ get_time_since_last_log()

int64_t logit::UniqueFileLogger::get_time_since_last_log ( ) const

inlineprivate

Retrieves the time elapsed since the last log.

Returns: The time in milliseconds since the last log was written.

Definition at line 486 of file UniqueFileLogger.hpp.

◆ get_timestamp_from_filename()

int64_t logit::UniqueFileLogger::get_timestamp_from_filename ( const std::string & filename ) const

inlineprivate

Extracts the timestamp from the filename.

Parameters

filename The filename to extract the timestamp from.

Returns: The timestamp in milliseconds.

Definition at line 427 of file UniqueFileLogger.hpp.

◆ initialize_directory()

void logit::UniqueFileLogger::initialize_directory ( )

inlineprivate

Initializes the logging directory.

Definition at line 304 of file UniqueFileLogger.hpp.

◆ is_valid_log_filename()

bool logit::UniqueFileLogger::is_valid_log_filename ( const std::string & filename ) const

inlineprivate

Checks if the filename matches the log file naming pattern.

Parameters

filename The filename to check.

Returns: True if the filename matches the pattern, false otherwise.

Definition at line 419 of file UniqueFileLogger.hpp.

◆ log()

void logit::UniqueFileLogger::log	(	const LogRecord &	record,
		const std::string &	message )

inlineoverridevirtual

Logs a message to a unique file with thread safety.

If asynchronous logging is enabled, the message is added to the task queue; otherwise, it is logged directly.

Parameters

record	The log record containing log information.
message	The log message to write.

Implements logit::ILogger.

Definition at line 117 of file UniqueFileLogger.hpp.

◆ remove_old_logs()

void logit::UniqueFileLogger::remove_old_logs ( )

inlineprivate

Removes old log files based on the auto-delete days configuration.

Definition at line 372 of file UniqueFileLogger.hpp.

◆ set_log_level()

void logit::UniqueFileLogger::set_log_level ( LogLevel level )

inlineoverridevirtual

Sets the minimal log level for this logger.

Implements logit::ILogger.

Definition at line 243 of file UniqueFileLogger.hpp.

◆ start_logging()

void logit::UniqueFileLogger::start_logging ( )

inlineprivate

Starts the logging process by initializing the directory and removing old logs.

Definition at line 288 of file UniqueFileLogger.hpp.

◆ stop_logging()

void logit::UniqueFileLogger::stop_logging ( )

inlineprivate

Stops the logging process by waiting for tasks.

Definition at line 299 of file UniqueFileLogger.hpp.

◆ wait()

void logit::UniqueFileLogger::wait ( )

inlineoverridevirtual

Waits for all asynchronous tasks to complete.

Implements logit::ILogger.

Definition at line 253 of file UniqueFileLogger.hpp.

◆ write_log()

std::string logit::UniqueFileLogger::write_log	(	const std::string &	message,
		const int64_t &	timestamp_ms )

inlineprivate

Writes a log message to a unique file.

Parameters

message	The log message to write.
timestamp_ms	The timestamp of the log message in milliseconds.

Returns: The name of the file the message was written to.

Definition at line 318 of file UniqueFileLogger.hpp.

Member Data Documentation

◆ m_config

Config logit::UniqueFileLogger::m_config

private

Configuration for the unique file logger.

Definition at line 260 of file UniqueFileLogger.hpp.

◆ m_last_log_ts

std::atomic<int64_t> logit::UniqueFileLogger::m_last_log_ts = ATOMIC_VAR_INIT(0)

private

Timestamp of the last log.

Definition at line 283 of file UniqueFileLogger.hpp.

◆ m_log_level

std::atomic<int> logit::UniqueFileLogger::m_log_level = ATOMIC_VAR_INIT(static_cast<int>(LogLevel::LOG_LVL_TRACE))

private

Definition at line 284 of file UniqueFileLogger.hpp.

◆ m_mutex

std::mutex logit::UniqueFileLogger::m_mutex

mutableprivate

Mutex to protect file operations.

Definition at line 259 of file UniqueFileLogger.hpp.

◆ m_pending_logs_cv

std::condition_variable logit::UniqueFileLogger::m_pending_logs_cv

mutableprivate

Condition variable to wait for pending logs to finish.

Definition at line 280 of file UniqueFileLogger.hpp.

◆ m_thread_log_info

std::unordered_map<std::thread::id, ThreadLogInfo> logit::UniqueFileLogger::m_thread_log_info

private

Map to store log information per thread.

Definition at line 281 of file UniqueFileLogger.hpp.

◆ m_thread_log_info_mutex

std::mutex logit::UniqueFileLogger::m_thread_log_info_mutex

mutableprivate

Mutex to protect access to thread log information.

Definition at line 279 of file UniqueFileLogger.hpp.

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

include/logit_cpp/logit/loggers/UniqueFileLogger.hpp

Classes

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ UniqueFileLogger() [1/3]

◆ UniqueFileLogger() [2/3]

◆ UniqueFileLogger() [3/3]

◆ ~UniqueFileLogger()

Member Function Documentation

◆ create_unique_file_path()

◆ current_timestamp_ms()

◆ format_timestamp()

◆ generate_fixed_length_hash()

◆ get_directory_path()

◆ get_float_param()

◆ get_int_param()

◆ get_last_log_file_name()

◆ get_last_log_file_path()

◆ get_last_log_ts()

◆ get_log_level()

◆ get_string_param()

◆ get_time_since_last_log()

◆ get_timestamp_from_filename()

◆ initialize_directory()

◆ is_valid_log_filename()

◆ log()

◆ remove_old_logs()

◆ set_log_level()

◆ start_logging()

◆ stop_logging()

◆ wait()

◆ write_log()

Member Data Documentation

◆ m_config

◆ m_last_log_ts

◆ m_log_level

◆ m_mutex

◆ m_pending_logs_cv

◆ m_thread_log_info

◆ m_thread_log_info_mutex