Completion Rate

Completion Rate Definition

For a given time window, completion rate is calculated as:

completion_rate = interaction_responses_total / interaction_published_total * 100

The complementary rate — timeout rate — is:

timeout_rate = interaction_timeout_total / interaction_published_total * 100

Blocked interactions (rejected by pre-send hooks) are counted separately in interaction_blocked_total and are excluded from the completion rate denominator, since they were never delivered.

Example Breakdown

Metrics Involved

PromQL Queries for BizFirst Observe

// Completion rate (%) over 1h sliding window — all types
100 * (
  sum(increase(interaction_responses_total[1h]))
  /
  sum(increase(interaction_published_total[1h]))
)

// Timeout rate (%) — approval interactions only
100 * (
  sum(increase(interaction_timeout_total{type="approval"}[1h]))
  /
  sum(increase(interaction_published_total{type="approval"}[1h]))
)

// Blocked rate (%) — segmented by hook name
100 * (
  sum by (blocked_by) (increase(interaction_blocked_total[1h]))
  /
  sum(increase(interaction_published_total[1h]) + increase(interaction_blocked_total[1h]))
)

Alert Thresholds

Querying Completion Rate in Code

// Admin API endpoint — completion rate by type for last 24h
[HttpGet("stats/completion-rate")]
[Authorize(Roles = "admin")]
public async Task<CompletionRateReport> GetCompletionRateAsync(
    [FromQuery] string? type,
    [FromQuery] int windowHours = 24,
    CancellationToken ct = default)
{
    var since = DateTime.UtcNow.AddHours(-windowHours);
    var query = new AuditQuery { Type = type, CreatedAfter = since };

    var all    = await _auditStore.CountAsync(query, ct);
    var responded = await _auditStore.CountAsync(
        query with { Statuses = [InteractionStatus.Responded] }, ct);
    var timedOut  = await _auditStore.CountAsync(
        query with { Statuses = [InteractionStatus.TimedOut] }, ct);
    var blocked   = await _auditStore.CountAsync(
        query with { Statuses = [InteractionStatus.Blocked] }, ct);

    return new CompletionRateReport
    {
        TotalPublished    = all,
        Responded         = responded,
        TimedOut          = timedOut,
        Blocked           = blocked,
        CompletionRatePct = all > 0 ? (double)responded / all * 100 : 0,
        TimeoutRatePct    = all > 0 ? (double)timedOut  / all * 100 : 0
    };
}

Interpreting Low Completion Rates