Standard Library Reference

This page contains the artifacts supported by the current version of the standard library. For an explanation of artifact structure, see the Documentation page.

As of the current version, SLO is the only supported artifact in Caffeine's standard library.


SLO - Service Level Objective

Description

SLOs are a very common reliability artifact. This artifact enables users to leverage Caffeine to guide SLO creation, maintenance, and tuning at their engineering organization. In fact, as noted in the origin story blog post, improving the SLO development life cycle (a concept defined here) was the motivating factor for Caffeine's creation.

Definition

Last modified: 12/10/25

{
  "artifacts": [
    {
      "name": "SLO",
      "version": "0.0.1",
      "base_params": {
        "threshold": "Float",
        "window_in_days": "Integer"
      },
      "params": {
        "queries": "Dict(String, String)",
        "value": "String",
        "vendor": "String"
      }
    }
  ]
}

Supported Artifacts

At this time, we only support one vendor: Datadog.

Vendor Notes
Datadog Supported SLO Types
  • good over bad: successful events over valid events.
    Looks like value: numerator / denominator
  • time slice: percentage of time a metric meets a threshold.
    Looks like value: time_slice(query comparator threshold "per" interval)
    Supports comparators: >, >=, <, <=
    Interval format: Ns (seconds) or Nm (minutes)