Interface MetricsGateway

All Superinterfaces:

HasLocalHandlers, Namespaced<MetricsGateway>

All Known Implementing Classes:

DefaultMetricsGateway

public interface MetricsGateway
extends Namespaced<MetricsGateway>, HasLocalHandlers

Gateway interface for publishing metrics messages in Fluxzero.

This gateway provides a convenient way to log and transmit application performance data, operational metrics, or monitoring signals. Metrics messages can be published either as raw payloads or as fully constructed Message objects. Metadata and delivery guarantees can also be specified.

Metrics are typically not routed for domain logic handling, but can be consumed by local handlers as well as non-local handlers (e.g., for logging or real-time telemetry).

Example usage:

Fluxzero.publishMetrics(new SystemMetrics(...));

See Also:

• Message
• Guarantee
• HasLocalHandlers

Method Summary

Modifier and Type	Method	Description
default void	publish(Object metrics)	Publishes a metrics message using default metadata and Guarantee.NONE.
default void	publish(Object payload, Metadata metadata)	Publishes a metrics payload with the specified metadata and a Guarantee.NONE delivery guarantee.
CompletableFuture<Void>	publish(Object payload, Metadata metadata, Guarantee guarantee)	Publishes a metrics message with the specified metadata and delivery guarantee.

Methods inherited from interface HasLocalHandlers

hasLocalHandlers, registerHandler, registerHandler, setSelfHandlerFilter

Methods inherited from interface Namespaced

forDefaultNamespace, forNamespace

Method Details

publish

default void publish(Object metrics)

Publishes a metrics message using default metadata and Guarantee.NONE.

If the provided value is already a Message, its payload and metadata will be extracted. Otherwise, it is wrapped in a new Message.

Parameters:

metrics - the metrics object or Message to publish

publish

default void publish(Object payload,
 Metadata metadata)

Publishes a metrics payload with the specified metadata and a Guarantee.NONE delivery guarantee.

Parameters:

payload - the payload of the metrics message

metadata - metadata to attach to the message

publish

CompletableFuture<Void> publish(Object payload,
 Metadata metadata,
 Guarantee guarantee)

Publishes a metrics message with the specified metadata and delivery guarantee.

This method may complete asynchronously.

Parameters:

payload - the metrics payload

metadata - metadata to attach to the message

guarantee - delivery guarantee (e.g., Guarantee.SENT or Guarantee.STORED)

Returns:

a CompletableFuture that completes when the message is published (or not, depending on the guarantee)