telemetry_query Struct Reference

Query parameters for retrieving telemetry logs. More...

#include <telemetry_query.hpp>

Collaboration diagram for telemetry_query:

Public Attributes
std::chrono::system_clock::time_point	start_time
	Start of the time range (inclusive).
std::chrono::system_clock::time_point	end_time
	End of the time range (exclusive).
std::optional< telemetry_source >	source
	Filter by source type (client or server).
std::optional< std::string >	source_name
	Filter by source application name.
std::optional< boost::uuids::uuid >	session_id
	Filter by session ID.
std::optional< boost::uuids::uuid >	account_id
	Filter by account ID.
std::optional< std::string >	level
	Filter by log level.
std::optional< std::string >	min_level
	Filter by minimum log level.
std::optional< std::string >	component
	Filter by component name.
std::optional< std::string >	tag
	Filter by tag.
std::optional< std::string >	message_contains
	Search text in message body.
std::uint32_t	limit = 1000
	Maximum number of results to return.
std::uint32_t	offset = 0
	Number of results to skip (for pagination).

Detailed Description

Query parameters for retrieving telemetry logs.

All filter fields are optional. When not set, that filter is not applied. Multiple filters are combined with AND logic.

Member Data Documentation

start_time

std::chrono::system_clock::time_point start_time

Start of the time range (inclusive).

Required for efficient hypertable queries.

end_time

std::chrono::system_clock::time_point end_time

End of the time range (exclusive).

Required for efficient hypertable queries.

session_id

std::optional<boost::uuids::uuid> session_id

Filter by session ID.

Useful for debugging specific client sessions.

account_id

std::optional<boost::uuids::uuid> account_id

Filter by account ID.

Useful for viewing logs from a specific user.

level

std::optional<std::string> level

Filter by log level.

Examples: "error", "warn", "info"

min_level

std::optional<std::string> min_level

Filter by minimum log level.

When set, returns logs at this level or higher severity. Severity order: trace < debug < info < warn < error

component

std::optional<std::string> component

Filter by component name.

Supports prefix matching (e.g., "ores.comms" matches all comms logs).

message_contains

std::optional<std::string> message_contains

Search text in message body.

Simple substring search, case-insensitive.