use crate::transfer::{emit_pending_details, CompositeTransferSummary, TransferContext};
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub(crate) enum DownloadObjectsEvent {
WalkDispatched,
ListingExhausted,
ReapScheduled,
ReapCompleted,
}
impl DownloadObjectsEvent {
fn fields(self) -> (&'static str, &'static str) {
match self {
Self::WalkDispatched => ("work_scheduled", "advance_walker"),
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 DownloadObjectsStateSnapshot {
pub(crate) pending_entries: usize,
pub(crate) walk_in_flight: bool,
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: DownloadObjectsEvent,
snapshot: DownloadObjectsStateSnapshot,
) {
if !events_enabled(ctx) {
return;
}
let (event_name, reason) = event.fields();
tracing::trace!(
target: crate::telemetry::TARGET_TRANSFER_DOWNLOAD_OBJECTS,
tid = %ctx.id,
event = event_name,
reason,
pending_entries = snapshot.pending_entries,
walk_in_flight = snapshot.walk_in_flight,
children = snapshot.children,
children_reserved = snapshot.children_reserved,
reaping_in_flight = snapshot.reaping_in_flight,
successful = snapshot.successful,
failed = snapshot.failed,
"download_objects state-machine event",
);
}
pub(crate) fn emit_terminal_summary(
ctx: &TransferContext,
snapshot: DownloadObjectsStateSnapshot,
) -> Option<CompositeTransferSummary> {
let summary = CompositeTransferSummary::new(ctx, snapshot.successful, snapshot.failed)?;
let Some(pending) = summary.pending else {
tracing::debug!(
target: crate::telemetry::TARGET_TRANSFER_DOWNLOAD_OBJECTS,
tid = %ctx.id,
outcome = summary.outcome.as_str(),
error_kind = ?summary.error_kind,
elapsed = ?summary.elapsed,
successful = summary.successful,
failed = summary.failed,
network_rx = summary.metrics.network_rx,
disk_write = summary.metrics.disk_write,
"download_objects transfer terminal",
);
return Some(summary);
};
if events_enabled(ctx) {
emit_pending_details(ctx.id, &pending);
}
tracing::debug!(
target: crate::telemetry::TARGET_TRANSFER_DOWNLOAD_OBJECTS,
tid = %ctx.id,
outcome = summary.outcome.as_str(),
error_kind = ?summary.error_kind,
elapsed = ?summary.elapsed,
successful = summary.successful,
failed = summary.failed,
network_rx = summary.metrics.network_rx,
disk_write = summary.metrics.disk_write,
pending_intervals = pending.interval_count(),
pending_time_sum = ?pending.pending_duration(),
pending_time_max = ?pending.max_pending_duration(),
"download_objects transfer terminal",
);
Some(summary)
}