Class McpMetricsSnapshot

java.lang.Object

com.soklet.McpMetricsSnapshot

@ThreadSafe
public final class McpMetricsSnapshot
extends Object

Immutable aggregate of collected MCP metrics.

An empty instance permits the shared MetricsCollector.Snapshot attachment to remain non-null when no MCP metrics have been observed. The fixed core families deliberately expose no generic label map; applications that construct custom event values remain responsible for the confidentiality and cardinality of those values.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	McpMetricsSnapshot.Builder	Builder for immutable McpMetricsSnapshot instances.
static final class	McpMetricsSnapshot.EndpointMethodKey	Key for endpoint-and-method counter aggregates.
static final class	McpMetricsSnapshot.RequestOutcomeKey	Key for completed-request and request-duration aggregates.
static final class	McpMetricsSnapshot.RequestStreamTerminationKey	Key for request-stream duration aggregates.
static final class	McpMetricsSnapshot.SubscriptionMaintenanceKey	Immutable subscription-maintenance aggregate dimensions, shared across supported MCP revisions.
static final class	McpMetricsSnapshot.SubscriptionTerminationKey	Key for subscription-duration aggregates.

Method Summary

Modifier and Type	Method	Description
static @NonNull McpMetricsSnapshot.Builder	builder()	Vends a builder for an MCP metrics snapshot.
static @NonNull McpMetricsSnapshot	emptyInstance()	Returns the shared snapshot containing zero or empty MCP metric values.
@NonNull Long	getActiveHandlerExecutions()	Returns the number of occupied MCP application-handler execution slots.
@NonNull Long	getActiveRequests()	Returns the number of currently active admitted MCP requests.
@NonNull Long	getActiveRequestStreams()	Returns the number of currently active MCP request streams.
@NonNull Long	getActiveSubscriptions()	Returns the number of currently active MCP subscriptions.
@NonNull Map<@NonNull McpMetricsSnapshot.EndpointMethodKey, @NonNull Long>	getCancelationsSignaled()	Returns cooperative request-cancelation signals grouped by bounded endpoint and method dimensions.
@NonNull Long	getConnectionsAccepted()	Returns the number of successfully accepted MCP connections admitted within the configured connection-capacity bound.
@NonNull Long	getConnectionsRejected()	Returns the number of MCP connections rejected because the configured connection-capacity bound was full.
@NonNull Long	getHandlerCapacityRejections()	Returns the number of MCP application requests rejected because the bounded handler queue was full.
@NonNull Long	getHandlerQueueDepth()	Returns the number of MCP application requests waiting for a handler slot.
@NonNull Long	getKeepAlivesEmitted()	Returns the number of MCP keep-alive comments accepted for delivery.
@NonNull Map<@NonNull McpMetricsSnapshot.EndpointMethodKey, @NonNull Long>	getProgressEmitted()	Returns progress notifications accepted for delivery grouped by bounded endpoint and method dimensions.
@NonNull Map<@NonNull Integer, @NonNull Long>	getProtocolErrors()	Returns client-visible MCP protocol errors grouped by error code.
@NonNull Map<@NonNull McpMetricsSnapshot.RequestOutcomeKey, @NonNull MetricsCollector.HistogramSnapshot>	getRequestDurations()	Returns request-duration histograms grouped by bounded endpoint, method, and terminal outcome dimensions.
@NonNull Map<@NonNull McpMetricsSnapshot.RequestOutcomeKey, @NonNull Long>	getRequests()	Returns nonnegative completed-request counts grouped by bounded endpoint, method, and terminal outcome dimensions.
@NonNull Long	getRequestsAccepted()	Returns the number of MCP requests accepted by the bounded protocol processor.
@NonNull Long	getRequestsRejected()	Returns the number of MCP requests rejected before admitted semantic handling.
@NonNull Map<@NonNull McpMetricsSnapshot.RequestStreamTerminationKey, @NonNull MetricsCollector.HistogramSnapshot>	getRequestStreamDurations()	Returns request-stream duration histograms grouped by bounded endpoint, method, and fixed termination reason dimensions.
@NonNull Long	getServerStarts()	Returns the number of successful MCP server starts.
@NonNull Map<@NonNull ShutdownComponentDisposition, @NonNull Long>	getServerStops()	Returns nonnegative server-stop counts grouped by fixed shutdown disposition.
@NonNull Map<@NonNull McpMetricsSnapshot.SubscriptionTerminationKey, @NonNull MetricsCollector.HistogramSnapshot>	getSubscriptionDurations()	Returns subscription-duration histograms grouped by bounded endpoint and fixed termination reason dimensions.
@NonNull Map<@NonNull McpMetricsSnapshot.SubscriptionMaintenanceKey, @NonNull Long>	getSubscriptionMaintenance()	Returns delivered subscription-maintenance event counts grouped by bounded endpoint, fixed work and fixed outcome dimensions across supported MCP revisions.
@NonNull Map<@NonNull MetricsCollector.TransportFailureReason, @NonNull Long>	getTransportFailures()	Returns nonnegative MCP transport-failure counts grouped by fixed reason.
@NonNull Map<@NonNull McpMetricsSnapshot.EndpointMethodKey, @NonNull Long>	getUnknownMirroredHeaders()	Returns unknown mirrored-header occurrences grouped by bounded endpoint and method dimensions.

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

emptyInstance

public static @NonNull McpMetricsSnapshot emptyInstance()

Returns the shared snapshot containing zero or empty MCP metric values.

Returns:

empty MCP metrics snapshot

builder

public static @NonNull McpMetricsSnapshot.Builder builder()

Vends a builder for an MCP metrics snapshot.

Returns:

MCP metrics snapshot builder

getActiveHandlerExecutions

public @NonNull Long getActiveHandlerExecutions()

Returns the number of occupied MCP application-handler execution slots.

Returns:

active handler executions

getHandlerQueueDepth

public @NonNull Long getHandlerQueueDepth()

Returns the number of MCP application requests waiting for a handler slot.

Returns:

handler queue depth

getHandlerCapacityRejections

public @NonNull Long getHandlerCapacityRejections()

Returns the number of MCP application requests rejected because the bounded handler queue was full.

Returns:

handler capacity rejections

getServerStops

public @NonNull Map<@NonNull ShutdownComponentDisposition, @NonNull Long> getServerStops()

Returns nonnegative server-stop counts grouped by fixed shutdown disposition.

Returns:

immutable, enum-ordered server-stop counts

getConnectionsAccepted

public @NonNull Long getConnectionsAccepted()

Returns the number of successfully accepted MCP connections admitted within the configured connection-capacity bound.

Returns:

accepted MCP connections

getConnectionsRejected

public @NonNull Long getConnectionsRejected()

Returns the number of MCP connections rejected because the configured connection-capacity bound was full.

Returns:

rejected MCP connections

getTransportFailures

public @NonNull Map<@NonNull MetricsCollector.TransportFailureReason, @NonNull Long> getTransportFailures()

Returns nonnegative MCP transport-failure counts grouped by fixed reason.

Returns:

immutable, enum-ordered MCP transport-failure counts

getServerStarts

public @NonNull Long getServerStarts()

Returns the number of successful MCP server starts.

Returns:

successful MCP server starts

getRequestsAccepted

public @NonNull Long getRequestsAccepted()

Returns the number of MCP requests accepted by the bounded protocol processor. Processor acceptance can precede a later pre-admission rejection, so this count is independent of getRequestsRejected().

Returns:

accepted MCP requests

getRequestsRejected

public @NonNull Long getRequestsRejected()

Returns the number of MCP requests rejected before admitted semantic handling. This count is not the complement of getRequestsAccepted().

Returns:

rejected MCP requests

getActiveRequests

public @NonNull Long getActiveRequests()

Returns the number of currently active admitted MCP requests.

Returns:

active admitted MCP requests

getRequests

public @NonNull Map<@NonNull McpMetricsSnapshot.RequestOutcomeKey, @NonNull Long> getRequests()

Returns nonnegative completed-request counts grouped by bounded endpoint, method, and terminal outcome dimensions.

Returns:

immutable completed-request counts

getRequestDurations

public @NonNull Map<@NonNull McpMetricsSnapshot.RequestOutcomeKey, @NonNull MetricsCollector.HistogramSnapshot> getRequestDurations()

Returns request-duration histograms grouped by bounded endpoint, method, and terminal outcome dimensions.

Returns:

immutable request-duration histograms

getActiveRequestStreams

public @NonNull Long getActiveRequestStreams()

Returns the number of currently active MCP request streams.

Returns:

active MCP request streams

getRequestStreamDurations

public @NonNull Map<@NonNull McpMetricsSnapshot.RequestStreamTerminationKey, @NonNull MetricsCollector.HistogramSnapshot> getRequestStreamDurations()

Returns request-stream duration histograms grouped by bounded endpoint, method, and fixed termination reason dimensions.

Returns:

immutable request-stream duration histograms

getActiveSubscriptions

public @NonNull Long getActiveSubscriptions()

Returns the number of currently active MCP subscriptions.

Returns:

active MCP subscriptions

getSubscriptionDurations

public @NonNull Map<@NonNull McpMetricsSnapshot.SubscriptionTerminationKey, @NonNull MetricsCollector.HistogramSnapshot> getSubscriptionDurations()

Returns subscription-duration histograms grouped by bounded endpoint and fixed termination reason dimensions.

Returns:

immutable subscription-duration histograms

getSubscriptionMaintenance

public @NonNull Map<@NonNull McpMetricsSnapshot.SubscriptionMaintenanceKey, @NonNull Long> getSubscriptionMaintenance()

Returns delivered subscription-maintenance event counts grouped by bounded endpoint, fixed work and fixed outcome dimensions across supported MCP revisions. Counts include coalescing and stale-result discards; they do not measure unique subscriptions, started attempts, durations or active work.

Returns:

immutable subscription-maintenance event counts

getCancelationsSignaled

public @NonNull Map<@NonNull McpMetricsSnapshot.EndpointMethodKey, @NonNull Long> getCancelationsSignaled()

Returns cooperative request-cancelation signals grouped by bounded endpoint and method dimensions.

Returns:

immutable cancelation-signaled counts

getProgressEmitted

public @NonNull Map<@NonNull McpMetricsSnapshot.EndpointMethodKey, @NonNull Long> getProgressEmitted()

Returns progress notifications accepted for delivery grouped by bounded endpoint and method dimensions.

Returns:

immutable progress-emitted counts

getKeepAlivesEmitted

public @NonNull Long getKeepAlivesEmitted()

Returns the number of MCP keep-alive comments accepted for delivery.

Returns:

keep-alive comments accepted for delivery

getProtocolErrors

public @NonNull Map<@NonNull Integer, @NonNull Long> getProtocolErrors()

Returns client-visible MCP protocol errors grouped by error code.

Returns:

immutable protocol-error counts

getUnknownMirroredHeaders

public @NonNull Map<@NonNull McpMetricsSnapshot.EndpointMethodKey, @NonNull Long> getUnknownMirroredHeaders()

Returns unknown mirrored-header occurrences grouped by bounded endpoint and method dimensions.

Returns:

immutable unknown mirrored-header counts