Method BeginPhase

Namespace

MailFathom.Infrastructure.Observability

Assembly

MailFathom.Infrastructure.dll

BeginPhase(MailSynchronizationPhase, CancellationToken)

Opens the report of one stage of a folder run, and publishes it when the returned scope is disposed.

public IMailSynchronizationPhaseScope BeginPhase(MailSynchronizationPhase phase, CancellationToken cancellationToken)

Parameters

phase MailSynchronizationPhase

Which stage is beginning.

cancellationToken CancellationToken

The run's token, read as the scope is disposed to tell shutdown from a failure.

Returns

IMailSynchronizationPhaseScope

The scope, which the caller must dispose exactly once and which the stage must be conducted inside.

Remarks

The stage carries no account and no folder alias of its own. It is always started inside the folder run's span, which already names both, so repeating them here would put the same two dimensions on every stage of every run to say what the parent says once.