Starting page for Tools section and minor changes (microsoft#514)

* Starting page for Tools section and minor changes * Fixing path lints * file rename * Update observability/tools/readme.md Co-authored-by: Tess Ferrandez <[email protected]> * Update observability/tools/readme.md Co-authored-by: Tess Ferrandez <[email protected]> * Update observability/tools/readme.md Co-authored-by: Tess Ferrandez <[email protected]> Co-authored-by: Narmatha <[email protected]> Co-authored-by: Tess Ferrandez <[email protected]>
daparm · Feb 10, 2021 · 3185ec5 · 3185ec5
1 parent 8d512d9
commit 3185ec5
Show file tree

Hide file tree

Showing 2 changed files with 15 additions and 1 deletion.
diff --git a/observability/readme.md b/observability/readme.md
@@ -17,14 +17,15 @@ Building observable systems enables development teams at CSE to measure how well
 - [Observability of CI/CD Pipelines](#Observability-of-CI/CD-pipelines)
 - [Recommended Practices](#recommended-practices)
 - [Logs vs Metrics](log-vs-metric.md)
+- [Dashboards and Reporting](pillars/dashboard.md)
+- [Tools](tools/readme.md)
 - [Recipes](#recipes)
 
 ## Pillars of Observability
 
 1. [Logging](pillars/logging.md)
 2. [Tracing](pillars/tracing.md)
 3. [Metrics](pillars/metrics.md)
-4. [Dashboard](pillars/dashboard.md)
 
 ## Observability in Machine Learning
 

diff --git a/observability/tools/readme.md b/observability/tools/readme.md
@@ -0,0 +1,13 @@
+# Tools
+
+There are a number of modern tools to make systems observable. While identifying and/or creating tools that work for your system, here are a few things to consider to help guide the choices.
+
+- Must be simple to integrate and easy to use.
+- It must be possible to aggregrate and visualize data.
+- Tools must provide real-time data.
+- Must be able to guide users to the problem area with suitable, adequete end-to-end context.
+
+## Choices
+
+- [Loki](./loki.md)
+- [OpenTelemetry](./OpenTelemetry.md)