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	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.

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 35 of file UniqueFileLogger.hpp.

Constructor & Destructor Documentation

◆ UniqueFileLogger() [1/3]

logit::UniqueFileLogger::UniqueFileLogger ( )

inline

Default constructor that uses default configuration.

Definition at line 48 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 54 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 63 of file UniqueFileLogger.hpp.

◆ ~UniqueFileLogger()

virtual logit::UniqueFileLogger::~UniqueFileLogger ( )

inlinevirtual

Definition at line 75 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 294 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 392 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 303 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 313 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 268 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 201 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 188 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 402 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 422 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 438 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 173 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 444 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 385 of file UniqueFileLogger.hpp.

◆ initialize_directory()

void logit::UniqueFileLogger::initialize_directory ( )

inlineprivate

Initializes the logging directory.

Definition at line 262 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 377 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 86 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 330 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 246 of file UniqueFileLogger.hpp.

◆ stop_logging()

void logit::UniqueFileLogger::stop_logging ( )

inlineprivate

Stops the logging process by waiting for tasks.

Definition at line 257 of file UniqueFileLogger.hpp.

◆ wait()

void logit::UniqueFileLogger::wait ( )

inlineoverridevirtual

Waits for all asynchronous tasks to complete.

Implements logit::ILogger.

Definition at line 212 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 276 of file UniqueFileLogger.hpp.

Member Data Documentation

◆ m_config

Config logit::UniqueFileLogger::m_config

private

Configuration for the unique file logger.

Definition at line 219 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 242 of file UniqueFileLogger.hpp.

◆ m_mutex

std::mutex logit::UniqueFileLogger::m_mutex

mutableprivate

Mutex to protect file operations.

Definition at line 218 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 239 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 240 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 238 of file UniqueFileLogger.hpp.

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

include/log-it/parts/Logger/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_string_param()

◆ get_time_since_last_log()

◆ get_timestamp_from_filename()

◆ initialize_directory()

◆ is_valid_log_filename()

◆ log()

◆ remove_old_logs()

◆ start_logging()

◆ stop_logging()

◆ wait()

◆ write_log()

Member Data Documentation

◆ m_config

◆ m_last_log_ts

◆ m_mutex

◆ m_pending_logs_cv

◆ m_thread_log_info

◆ m_thread_log_info_mutex