use crate::transfer::{emit_pending_details, CompositeTransferSummary, TransferContext};
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub(crate) enum UploadObjectsEvent {
WalkDispatched,
WalkDeferredBufferFull,
WalkDeferredWalksInFlight,
WalkDeferredWalksSaturated,
WalkDeferredNoWalk,
ListingExhausted,
ReapScheduled,
ReapCompleted,
}
impl UploadObjectsEvent {
fn fields(self) -> (&'static str, &'static str) {
match self {
Self::WalkDispatched => ("work_scheduled", "advance_walker"),
Self::WalkDeferredBufferFull => ("walk_deferred", "entry_buffer_full"),
Self::WalkDeferredWalksInFlight => ("walk_deferred", "walks_in_flight"),
Self::WalkDeferredWalksSaturated => ("walk_deferred", "walks_saturated"),
Self::WalkDeferredNoWalk => ("walk_deferred", "no_walk"),
Self::ListingExhausted => ("dispatch_closed", "listing_exhausted"),
Self::ReapScheduled => ("work_scheduled", "join_children"),
Self::ReapCompleted => ("state_changed", "children_reaped"),
}
}
}
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub(crate) struct UploadObjectsStateSnapshot {
pub(crate) pending_entries: usize,
pub(crate) walks: usize,
pub(crate) in_flight_walks: usize,
pub(crate) children: usize,
pub(crate) children_reserved: usize,
pub(crate) reaping_in_flight: usize,
pub(crate) successful: u64,
pub(crate) failed: usize,
}
fn events_enabled(ctx: &TransferContext) -> bool {
ctx.handle.config.diagnostics().transfer().events_enabled()
}
pub(crate) fn emit_event(
ctx: &TransferContext,
event: UploadObjectsEvent,
snapshot: UploadObjectsStateSnapshot,
) {
if !events_enabled(ctx) {
return;
}
let (event_name, reason) = event.fields();
tracing::trace!(
target: crate::telemetry::TARGET_TRANSFER_UPLOAD_OBJECTS,
tid = %ctx.id,
event = event_name,
reason,
pending_entries = snapshot.pending_entries,
walks = snapshot.walks,
in_flight_walks = snapshot.in_flight_walks,
children = snapshot.children,
children_reserved = snapshot.children_reserved,
reaping_in_flight = snapshot.reaping_in_flight,
successful = snapshot.successful,
failed = snapshot.failed,
"upload_objects state-machine event",
);
}
pub(crate) fn emit_terminal_summary(
ctx: &TransferContext,
snapshot: UploadObjectsStateSnapshot,
) -> Option<CompositeTransferSummary> {
let summary = CompositeTransferSummary::new(ctx, snapshot.successful, snapshot.failed)?;
let Some(pending) = summary.pending else {
tracing::debug!(
target: crate::telemetry::TARGET_TRANSFER_UPLOAD_OBJECTS,
tid = %ctx.id,
outcome = summary.outcome.as_str(),
error_kind = ?summary.error_kind,
elapsed = ?summary.elapsed,
successful = summary.successful,
failed = summary.failed,
network_tx = summary.metrics.network_tx,
disk_read = summary.metrics.disk_read,
"upload_objects transfer terminal",
);
return Some(summary);
};
if events_enabled(ctx) {
emit_pending_details(ctx.id, &pending);
}
tracing::debug!(
target: crate::telemetry::TARGET_TRANSFER_UPLOAD_OBJECTS,
tid = %ctx.id,
outcome = summary.outcome.as_str(),
error_kind = ?summary.error_kind,
elapsed = ?summary.elapsed,
successful = summary.successful,
failed = summary.failed,
network_tx = summary.metrics.network_tx,
disk_read = summary.metrics.disk_read,
pending_intervals = pending.interval_count(),
pending_time_sum = ?pending.pending_duration(),
pending_time_max = ?pending.max_pending_duration(),
"upload_objects transfer terminal",
);
Some(summary)
}