operations-sla

SLA policy tracking and status calculation

What it is for

# operations-sla

SLA (Service Level Agreement) tracking library crates for Rust applications.

Overview

This crate provides:

• SLA policy definitions with configurable response/resolution times
• Status tracking (on track, at risk, breached, met)
• Breach detection and reporting
• Pluggable policy sources for multi-tenant systems

Example

use operations_sla::{
SlaPolicy, SlaInput, SlaStatus, DefaultSlaPolicySource, SlaPolicySource,
calculate_sla_status,
};
use chrono::{Utc, Duration};
use uuid::Uuid;

// Define an SLA policy
let policy = SlaPolicy::with_times(60, 480); // 1 hour response, 8 hour resolution

// Create input data
let now = Utc::now();
let input = SlaInput::new(Uuid::new_v4(), now - Duration::minutes(30));

// Calculate SLA status
let status = calculate_sla_status(&input, &policy, now);
assert_eq!(status.first_response_status, SlaStatus::OnTrack);

// Use the default policy source for priority-based policies
let source = DefaultSlaPolicySource::new();
let urgent_policy = source.get_policy(Uuid::new_v4(), None, Some("urgent"), None).unwrap();
assert_eq!(urgent_policy.first_response_minutes, 15);

Capabilities

Result

SLA error types.

SlaError

SLA error types.

EntitySlaStatus

SLA data models.

SlaBreach

SLA data models.

SlaBreachType

SLA data models.

SlaInput

SLA data models.

SlaPolicy

SLA data models.

SlaStatus

SLA data models.

policy (other)

SLA policy management and resolution.

DefaultSlaPolicySource

SLA policy management and resolution.

SlaPolicySource

SLA policy management and resolution.

policy::priorities (other)

_No module-level documentation is present in the source._

tracker (other)

SLA status calculation.

How to use it

From this crate's own rustdoc:

use operations_sla::{
    SlaPolicy, SlaInput, SlaStatus, DefaultSlaPolicySource, SlaPolicySource,
    calculate_sla_status,
};
use chrono::{Utc, Duration};
use uuid::Uuid;

// Define an SLA policy
let policy = SlaPolicy::with_times(60, 480); // 1 hour response, 8 hour resolution

// Create input data
let now = Utc::now();
let input = SlaInput::new(Uuid::new_v4(), now - Duration::minutes(30));

// Calculate SLA status
let status = calculate_sla_status(&input, &policy, now);
assert_eq!(status.first_response_status, SlaStatus::OnTrack);

// Use the default policy source for priority-based policies
let source = DefaultSlaPolicySource::new();
let urgent_policy = source.get_policy(Uuid::new_v4(), None, Some("urgent"), None).unwrap();
assert_eq!(urgent_policy.first_response_minutes, 15);

Module structure

operations_sla

• error
• models
• policy
• policy::priorities
• tracker

flowchart TD
  n_operations_sla["operations_sla"]
  n_operations_sla --> n_error["error"]
  n_operations_sla --> n_models["models"]
  n_operations_sla --> n_policy["policy"]
  n_policy --> n_policy__priorities["priorities"]
  n_operations_sla --> n_tracker["tracker"]

Public surface

`error`

`models`

`policy`

`policy::priorities`

`tracker`

Re-exports. Exported here, defined elsewhere.

Boundary

Depends on no other workspace tier.

Shares tier operations with 40 other crates: operations-approval-workflow, operations-assessments, operations-block-imaging, operations-boot-media, operations-browser-agent-worker, operations-camera-discovery, operations-camera-liveview, operations-camera-registry, … (40 total).

_What this crate deliberately does NOT own is a judgment. No committed registry records one for it, so none is stated here._

Where it sits

Dependencies

Runtime, from outside the workspace.

Development. None.

Build. None.

Depended on by. 1 workspace crate.

Signal flow — what reaches this crate, and what it reaches.

flowchart LR
  n_application_sla["application-sla"] -->|uses| SELF
  SELF["operations-sla"]
  classDef self fill:#1f883d,stroke:#1f883d,color:#fff;
  class SELF self;

Feature flags

No Cargo features are defined: every capability is unconditional, so no consumer can receive a half-wired crate.

Targets

Error model

Operational characteristics

No unsafe block, unsafe fn, unsafe impl or unsafe trait was found by the parser anywhere in this crate's source.

Configuration

No environment variable is read with a literal name anywhere in this crate. A variable whose key is computed at run time cannot be listed here, and is not claimed to be absent.

Related capabilities

1 workspace crate depends on this one: application-sla.

Verification

Evidence by module. How often each public module is named by something executable.

What the tests establish, by name:

• test_sla_breach_type_display — src/models.rs
• test_sla_breach_type_parse — src/models.rs
• test_sla_policy_default — src/models.rs
• test_sla_policy_durations — src/models.rs
• test_sla_policy_with_times — src/models.rs
• test_sla_status_display — src/models.rs
• test_sla_status_is_problematic — src/models.rs
• test_sla_status_parse — src/models.rs
• test_default_policy_for_unknown_priority — src/policy.rs
• test_default_policy_selection — src/policy.rs
• test_validate_priority — src/policy.rs
• test_check_breaches_both — src/tracker.rs
• test_check_breaches_first_response — src/tracker.rs
• test_check_breaches_none — src/tracker.rs
• test_first_response_closed_after_deadline_is_breached — src/tracker.rs
• test_first_response_closed_before_deadline_is_met — src/tracker.rs
• test_first_response_resolved_after_deadline_is_breached — src/tracker.rs
• test_first_response_resolved_before_deadline_is_met — src/tracker.rs
• test_first_response_unresolved_still_uses_deadline — src/tracker.rs
• test_sla_status_at_risk — src/tracker.rs
• test_sla_status_breached — src/tracker.rs
• test_sla_status_met — src/tracker.rs
• test_sla_status_met_but_breached — src/tracker.rs
• test_sla_status_on_track — src/tracker.rs
• test_sort_by_urgency — src/tracker.rs

Documentation coverage

pie showData
    title Public items with rustdoc
    "Documented" : 47
    "No rustdoc detected" : 5

Metrics

pie showData
    title Public API by kind
    "constant" : 5
    "enum" : 3
    "function" : 5
    "method" : 32
    "struct" : 5
    "trait" : 1
    "type alias" : 1

pie showData
    title Rust source composition
    "Code" : 775
    "Blank or comment" : 339

Generation

Rendered by tools-corpus corpus readme from repository evidence alone, renderer schema 2, lexicon current. No model, network service or database was consulted. Regenerate with tools-corpus corpus readme --write; verify with --check.