summaryrefslogtreecommitdiff
path: root/sig-scalability
diff options
context:
space:
mode:
authorwojtekt <wojtekt@google.com>2018-08-30 14:07:00 +0200
committerwojtekt <wojtekt@google.com>2018-08-30 15:17:27 +0200
commit45827d8ec912a2d2a2e0160f3f3a62f583399a62 (patch)
treeea5420f153ea54407f28356912e170afeffe8041 /sig-scalability
parent3e186d12c5b629579f779b180ce920d26194ebc4 (diff)
Clarify concepts in main slo page
Diffstat (limited to 'sig-scalability')
-rw-r--r--sig-scalability/slos/slos.md27
1 files changed, 15 insertions, 12 deletions
diff --git a/sig-scalability/slos/slos.md b/sig-scalability/slos/slos.md
index 6f7ffff0..37241cdc 100644
--- a/sig-scalability/slos/slos.md
+++ b/sig-scalability/slos/slos.md
@@ -11,26 +11,29 @@ in these areas.
## What do we require from SLIs/SLOs?
-We are going to define more SLIs and SLOs based on the most important indicators
-in the system.
+We are in the process of extending the number of SLIs ([Service Level Indicators])
+and SLOs ([Service Level Objectives]) built on top of these SLIs to cover more areas
+of the system and user expectations.
-Our SLOs need to have the following properties:
+Our SLIs/SLOs need to have the following properties:
- <b> They need to be testable </b> <br/>
- That means that we need to have a benchmark to measure if it's met.
+ Ideally, they (SLIs and SLOs) should be measurable in all running clusters,
+ but if that isn't possible a benchmark may be enough in some situations.
+ That means that not every SLO may be translatable to SLA ([Service
+ Level Agreement]).
- <b> They need to be understandable for users </b> <br/>
In particular, they need to be understandable for people not familiar
with the system internals, i.e. their formulation can't depend on some
arcane knowledge.
-However, we may introduce some internal (for developers only) SLIs, that
-may be useful for understanding performance characterstic of the system,
-but for which we don't provide any guarantees for users and thus may not
-be fully understandable for users.
+We may also introduce internal(for developers only) SLIs, that may be useful
+for understanding performance characterstic of the system, but for which
+we don't provide any guarantees for users (and thus don't require them to be
+that easily understandable).
-On the other hand, we do NOT require that our SLOs:
-- are measurable in a running cluster (though that's desired if possible) <br/>
- In other words, not SLOs need to be easily translatable to SLAs.
- Being able to benchmark is enough for us.
+[Service Level Indicators]: https://en.wikipedia.org/wiki/Service_level_indicator
+[Service Level Objectives]: https://en.wikipedia.org/wiki/Service_level_objective
+[Service Level Agreement]: https://en.wikipedia.org/wiki/Service-level_agreement
## Types of SLOs