Define and observe your reliability

In this section you will learn how to define and observe your reliability by implementing Service Level Objectives with Reliably. After an initial setup with the CLI, you will define your Objectives and Indicators, push Indicator instances, and view a report. This will enable you to take an SLO-oriented approach to reliability.

Before you begin

Install

If you haven't already, you will first need to install Reliably's CLI.

Login

Once you install the CLI, make sure you are logged in with:

reliably auth login

Additional information can be found in the Login section.

Define your Objectives

To get started, you will generate a manifest file defining your Objectives and an Indicator selector for each. These two entities will allow you to define what good looks like for your system from the perspective of your users. In order to do this, you first need to determine your data provider for the resources you wish to target. This may be the cloud platform which contains the resources such as AWS or GCP, or alternatively a monitoring service such as Datadog.

Note

If you would prefer to start with a sandboxed deployment, instead of your own resources, follow the instructions of deployment for your preferred platform below and then return to this section.

AWS / GCP

    Push Indicators

    Once you have defined your Objectives and Indicator selectors, it's time to configure a way to push Indicators to Reliably's API. When these Indicators are received, they will be matched with any Objective that has the appropriate selector for that Indicator. This will then record an Objective Result.

    There are two primary ways to push Indicators. You may deploy or locally run the CLI in agent mode, or push custom Indicators manually, with an API client such as curl.

    For a brief introduction on how this works, it is recommended to run in agent mode locally which will allow you to view results immediately.

      View your report

      Finally, once you've pushed Indicators and generated Objective Results, you may see your results by running:

      reliably slo report

      At this stage you should be able to view the results table of the Objectives you defined combined with the Indicators you have pushed.

      An example of the default view:

      reliably slo report
                                                Current Objective   / Time Window  Type             Trend
        Service #1: http-api
         Availability over 1 hour           100.00%  99%        /  1h0m0s      Availability     ✓ ✓ ✓ ✓
         Request latency under 1s           98.59%   99.9%      /  1d          Latency          ✓ ✓ ✓ ✓
      
        Service #2: products-api
         Availability over 1 day            100.00%  99%        /  1d          Availability      ✓ ✓ ✓ ✓ ✓
         Request latency under 200ms        100.00%  99.5%      /  1d          Latency           ✓ ✓ ✓ ✓ ✓

      Additional information about the report command can be found in Generate SLO Reports.

      What's next?