soulfire.metrics_connect.MetricsServiceSync

class soulfire.metrics_connect.MetricsServiceSync[source]

Bases: Protocol

Service for retrieving instance metrics and monitoring data. Metrics are collected server-side and stored in a ring buffer. All operations require appropriate permissions.

get_instance_metrics(request: soulfire.metrics_pb2.GetInstanceMetricsRequest, ctx: connectrpc.request.RequestContext[soulfire.metrics_pb2.GetInstanceMetricsRequest, soulfire.metrics_pb2.GetInstanceMetricsResponse], /) → soulfire.metrics_pb2.GetInstanceMetricsResponse[source]

Returns time-series metrics and current distributions for an instance. Supports incremental fetching via the “since” parameter. Requires: READ_BOT_INFO permission on the instance Errors: NOT_FOUND if instance does not exist

get_server_metrics(request: soulfire.metrics_pb2.GetServerMetricsRequest, ctx: connectrpc.request.RequestContext[soulfire.metrics_pb2.GetServerMetricsRequest, soulfire.metrics_pb2.GetServerMetricsResponse], /) → soulfire.metrics_pb2.GetServerMetricsResponse[source]

Returns server-level system metrics (CPU, memory, threads, GC, aggregate bots). Supports incremental fetching via the “since” parameter. Requires: READ_SERVER_CONFIG global permission