Skip to main content

Create an SLO

When creating an SLO, you'll need to define the following:

  • SLI (service level indicator) metric you are tracking and target configuration using ratio- or threshold-based definitions
  • SLO (service level objective) defining the target and duration to monitor (for example, the uptime for the target)
  • Basic details for SLO name and description

You have multiple configurations for creating SLOs:

  • Measurement for SLO: Windows of time or Requests.
  • Query type: Metrics or Logs.
  • Calculation definition: Ratio (tracked amount against a total) or Threshold. Instead of defining two queries to identify successful versus total events to create a Ratio, you can specify a Threshold for the Total Events query that identifies successful events.

The following table lists the available options for an SLO:

Window-basedRequest-based
Metrics-based SLORatio and ThresholdRatio Only
Logs-based SLORatio and ThresholdRatio and Threshold

Create an SLO (General)

  1. Click Manage Data > Monitoring > SLO tab.
  2. Click Add > New SLO. Optionally, you can also:
    • Create folders to manage your SLOs.
    • Import an SLO:
      1. To transfer data immediately and create an SLO using an import, you should first export JSON content to use that formatting. The Sumo Logic JSON format may change without notice. See Export and Import Content in the Library for complete details.
      2. Click Manage Data, then Monitoring. Select the SLO tab if not loaded.
      3. Click Add > Import.
      4. Enter a Name for the SLO.
      5. Copy and paste the JSON in the text editor.
      6. Click Import.
        Reliability Management SLO SLI
  3. Select the Signal Type:
    • Latency. Select to calculate the speed of services, lag time.
    • Error. Select to monitor for errors that occur in your services.
    • Throughput. Select to track the throughput of services and processing.
    • Availability. Select to monitor the uptime of services.
    • Other. Select to monitor any other metric or log for SLIs.
      Reliability Management SLO SLI
  4. Select the Evaluation Type which determines how the events are measured:
    • Window-based. Select the time frame window for the events. Window sizes should be between 1m to 60m.
      Reliability Management SLO SLI
    • Request-based.
      Reliability Management SLO SLI

Select the Query Type to select and build your queries for the SLI data. You have a choice of Metrics or Logs with a ratio-based (partial against the total) or threshold-based (events amount against a set threshold amount) calculation. Review Query recommendations before building.

Follow the instructions below based on the query type:

Metrics: Ratio-basedMetrics: Threshold-based
For Ratio-based definition, define queries for the successful or unsuccessful events to calculate against total events:
  1. Specify Total Events query.
  2. Build a query using metrics and filters. See Overview of Metrics in Sumo.
  3. Select the values to use from Number of data points or Metric value.
  4. Configure the Total Events, including a query and values, to use Number of data points or Metric value. You can copy and paste the previous query, removing filters to get the total.
For Threshold-based definitions, which calculate against success criteria:
  1. Select Successful or Unsuccessful Events to measure.
  2. Build a query using metrics and filters. See Overview of Metrics in Sumo for more information.
  3. For Use values from, it always uses the Metric value.
  4. For Success Criteria for Avg, Min, Max, or Sum of the selected signal type (such as latency) which must be greater than, greater than or equal to, less than, or less than equal to an amount you enter (positive or negative number).
Reliability Management SLO SLI
Logs: Ratio-basedLogs: Threshold-based
For Ratio-based definitions, which calculate successful or unsuccessful events against total events:
  1. Specify Total Events query.
  2. Search logs selecting and entering a log query. See About Search Basics for more information.
  3. For Use values from, select the numeric value available for that query to pull data from.
  4. Then configure the Total Events, including a query and values. You can copy and paste the previous query, perhaps with filters removed to get the total.
For Threshold-based definitions, which calculate against success criteria:
  1. Select Successful or Unsuccessful Events to measure.
  2. Search logs selecting and entering a log query. See About Search Basics for more information.
  3. For Use values from, it always uses the Metric value.
  4. For Success Criteria for Avg, Min, Max, or Sum of the selected signal type (such as latency), which must be greater than, greater than or equal to, less than, or less than equal to an amount you enter (positive or negative number).
Reliability Management SLO SLI
  1. Define your SLO for target amount and duration period to monitor:
    • Target. The value in percentage you want to target for the SLO, for example 99 for 99%.
    • Compliance Type. Rolling provides a sequence of recent days for the Compliance Period, such as the last 7d or last 30d. Calendar calculator over a window of time for a Week.
    • Timezone. Select a timezone. This is important to accurately assign events on the boundary of a compliance period, such as events received at 11:59 PM in a particular time zone.
      Reliability Management SLO SLI
  2. Enter SLO Details, including a Name and Description. This is used in the list and for searches.
    Reliability Management SLO SLI
  3. Click Save. To create a monitor, click Save and Create Monitor.

Create an SLO from Log Search page

You can create SLOs directly from your Sumo Logic log search. This allows you to validate queries, quickly create SLOs, and re-use queries from existing dashboard panels.

  1. Enter a new Log search query (or use an existing one).
    log search
  2. Click the More Actions (kebab icon) dropdown menu.
    More Actions
  3. Click Create an SLO.
    Create an SLO

Create an SLO from Metrics page

Coming soon

You'll be able to create SLOs from Metrics Explorer.

Create an SLO from Monitors list page

Critical Monitors are great candidates to convert to SLOs. From the Monitors section, you can create a Monitor- and window-based SLO for a given trigger condition.

As an example, say you have an existing Monitor that fires a Critical alert if the latency of a customer-critical service exceeds 500ms. By creating an SLO directly through this specific Monitor, those thresholds will automatically carry over into the new SLO, saving you time and effort.

Prerequisite

Your Monitor must be in an active state.

  1. Go to Manage Data > Monitoring > Monitors tab.
  2. Click on any active Monitor to open its panel.
  3. Choose one of the methods below:
    Click More Actions > Create SLO.
    Monitor-based SLO
    Or, click Monitor-based SLO > Add Monitor-based SLO.
    Monitor-based SLO
    This will open the New SLO window.
  4. Define your SLI. Your Monitor's Source, Signal Type, and Trigger Event settings will auto-populate here (you can override these if you need to).
    Monitor-based SLO
  5. Define your SLO. Set your window-based threshold here.
    Monitor-based SLO
  6. When you're done, click Save, which will save the SLO.
    Monitor-based SLO

To edit SLO parameters:

  1. Go to the SLO tab, locate your SLO and click on it. (If you're unable to find it, try applying filters or go to the search bar at the top and enter the SLO name or folder name.)
  2. Edit definition and other parameters.

To edit SLO parameters from a Monitor:

  1. Go to the Monitors tab and click on any Monitor.
    Monitor-based SLO
  2. In the panel, click Monitor-based SLO to view the list of SLOs associated with that particular Monitor.
    Monitor-based SLO
info

Any Monitor update that changes the Monitor definition will lead to a change in the version of related SLOs. This means that the SLO history or SLI will get reset for the SLO. Example include trigger condition changes and evaluation delay changes. Changes unrelated to the definition like Name, Description will not affect the related SLOs.

SLI calculation for Monitor-based SLOs

SLIs for Monitor-based SLOs are calculated at a granularity of 1 minute. A minute is treated as unsuccessful if the Monitor threshold is violated at any point of time within that minute.

SLO as Code

You can use the Sumo Logic Terraform provider to automate SLO folder and SLO creation. This can be useful for organizations that want to templatize SLOs, standardize SLO configuration, Monitors and dashboards and automate SLO-related workflows.

Use the Monitor Terraform provider to create Monitors associated with SLOs.

Legal
Privacy Statement
Terms of Use

Copyright © 2023 by Sumo Logic, Inc.