Enum ControllerRequest

pub enum ControllerRequest {
    RequestSendSoon {
        responder: ControllerRequestSendSoonResponder,
    },
    GenerateAggregatedObservations {
        day_index: u32,
        report_specs: Vec<ReportSpec>,
        responder: ControllerGenerateAggregatedObservationsResponder,
    },
    ListenForInitialized {
        responder: ControllerListenForInitializedResponder,
    },
}

The Controller is primarily useful for testing the Cobalt service. Cobalt clients should use the Logger.

Variants

RequestSendSoon

Requests that the collection of Observations that are currently cached locally be sent to the Cobalt server soon. Cobalt will send the Observations in one or more batches and will retry several times upon failure. The response occurs only after that procedure is completed. A return value of true indicates that all Observations were successfully sent. A return value of false indicates otherwise.

Fields

responder: ControllerRequestSendSoonResponder

GenerateAggregatedObservations

Triggers Cobalt to generate Observations based on locally aggregated event data and write them to the local ObservationStore. In a non-test environment this would normally be done periodically by a background thread. In a test environment this method should be invoked against an instance of the Cobalt FIDL service that was passed the flag –start_event_aggregator_worker=false.

day_index The index of the day for which locally aggregated Observations should be generated.

report_specs A vector of specifications identifying the reports to return the number of observations for.

Returns a vector whose k-th element is the number of observations generated for the k-th element of report_specs. If report_specs is the empty vector, then an empty vector is returned.

Fields

day_index: u32

report_specs: Vec<ReportSpec>

responder: ControllerGenerateAggregatedObservationsResponder

ListenForInitialized

Requests that the caller be notified after the Cobalt FIDL service is in the fully-initialized state.

Cobalt starts serving requests before it is fully initialized. In this pre-initialized state it will buffer incoming log events in memory but not complete their processing. After Cobalt becomes fully initialized the events in the bufer are fully processed.

A partial list of things that must happen before Cobalt enters the fully-initialized state are:

• Cobalt must by notified by the timekeeper service that the system clock has become accurate–usually because the time has been fetched from a trusted network resource.

The callback to this method will be invoked after Cobalt transistions

Fields

responder: ControllerListenForInitializedResponder

Implementations

impl ControllerRequest

pub fn into_request_send_soon( self, ) -> Option<ControllerRequestSendSoonResponder>

pub fn into_generate_aggregated_observations( self, ) -> Option<(u32, Vec<ReportSpec>, ControllerGenerateAggregatedObservationsResponder)>

pub fn into_listen_for_initialized( self, ) -> Option<ControllerListenForInitializedResponder>

pub fn method_name(&self) -> &'static str

Name of the method defined in FIDL

Trait Implementations

impl Debug for ControllerRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.