aboutsummaryrefslogtreecommitdiffstats
path: root/docs/observability.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/observability.md')
-rw-r--r--docs/observability.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/docs/observability.md b/docs/observability.md
new file mode 100644
index 0000000..4efa297
--- /dev/null
+++ b/docs/observability.md
@@ -0,0 +1,30 @@
+# Observability
+
+"Observability v2" is considered an evolution of the [Observability-v1
+(or Monitoring)][1] paradigm. The goal of Observability (v1 or v2) is to
+provide understanding of how an application operates at runtime.
+
+As a common shorthand,
+
+### Definitions
+
+_Copied from the O
+
+Certain words have different definitions from their common use in
+conversation. For the purposes of monitoring and alerting, the
+following definitions apply:
+
+- **Observe**: to understand how an application behaves, with real world
+ use cases.
+- **Monitoring**: the act of collecting information used to _Observe_ an
+ application.
+- **Event**: a record of something which happened, produced by a
+ Monitor.
+ - A monitoring _event_ is not the same as events used in other systems
+ such as Databases, Cloud Providers, Apache Kafka, etc.
+ - Events are records, not signals, and MUST represent something that
+ actually happened. Such occurrences represent decisions made by the
+ Development, SRE, and Security teams to highlight _meaningful_
+ occurrences.
+
+[1]: monitoring.md