Added observability plugin

Signed-off-by: keithhc2 <[email protected]>

Author: keithhc2

_config.yml

@@ -48,6 +48,9 @@ collections:
   replication-plugin:
     permalink: /:collection/:path/
     output: true
+  observability-plugins:
+    permalink: /:collection/:path/
+    output: true
   monitoring-plugins:
     permalink: /:collection/:path/
     output: true
@@ -87,6 +90,9 @@ just_the_docs:
     replication-plugin:
       name: Replication plugin
       nav_fold: true
+    observability-plugins:
+      name: Observability plugins
+      nav_fold: true
     monitoring-plugins:
       name: Monitoring plugins
       nav_fold: true

_observability-plugins/event-analytics.md

@@ -0,0 +1,33 @@
+---
+layout: default
+title: Event analytics
+nav_order: 10
+---
+
+# Event analytics
+
+Event analytics in observability is where you can use [Piped Processing Language]({{site.url}}{{site.baseurl}}/observability-plugins/ppl/index) (PPL) queries to build and view different visualizations of your data.
+
+## Get started with event analytics
+
+To get started, choose **Observability** in OpenSearch Dashboards, and then choose **Event analytics**. If you want to start exploring without adding any of your own data, choose **Add sample Events Data**, and Dashboards adds some sample visualizations you can interact with.
+
+## Build a query
+
+To generate custom visualizations, you must first specify a PPL query. OpenSearch Dashboards then automatically creates a visualization based on the results of your query.
+
+For example, the following PPL query returns a count of how many host addresses are currently in your data.
+
+```
+source = opensearch_dashboards_sample_data_logs | fields host | stats count()
+```
+
+By default, Dashboards shows results from the last 15 minutes of your data. To see data from a different timeframe, use the date and time selector.
+
+For more information about building PPL queries, see [Piped Processing Language]({{site.url}}{{site.baseurl}}/observability-plugins/ppl/index).
+
+## Save a visualization
+
+After Dashboards generates a visualization, you must save it if you want to return to it at a later time or if you want to add it to an [operational panel]({{site.url}}{{site.baseurl}}/observability-plugins/operational-panels).
+
+To save a visualization, expand the save dropdown menu next to **Run**, enter a name for your visualization, then choose **Save**. You can reopen any saved visualizations on the event analytics page.

_observability-plugins/index.md

@@ -0,0 +1,22 @@
+---
+layout: default
+title: About Observability
+nav_order: 1
+has_children: false
+redirect_from:
+  - /observability-plugins/
+---
+
+# About Observability
+OpenSearch Dashboards
+{: .label .label-yellow :}
+
+The Observability plugins are a collection of plugins that let you visualize data-driven events by using Piped Processing Language to explore, discover, and query data stored in OpenSearch.
+
+Your experience of exploring data might differ, but if you're new to exploring data to create visualizations, we recommend trying a work flow like the following:
+
+1. Explore data over a certain timeframe using [Piped Processing Language]({{site.url}}{{site.baseurl}}/observability-plugins/ppl/index).
+1. Use [event analytics]({{site.url}}{{site.baseurl}}/observability-plugins/event-analytics) to turn data-driven events into visualizations.
+1. Create [operational panels]({{site.url}}{{site.baseurl}}/observability-plugins/plugins/operational-panels) and add visualizations to compare data the way you like.
+1. Use [trace analytics]({{site.url}}{{site.baseurl}}/observability-plugins/plugins/trace/index) to create traces and dive deep into your data.
+1. Leverage [notebooks]({{site.url}}{{site.baseurl}}/observability-plugins/plugins/notebooks) to combine different visualizations and code blocks that you can share with team members.

_dashboards/notebooks.md renamed to _observability-plugins/notebooks.md

@@ -0,0 +1,25 @@
+---
+layout: default
+title: Operational panels
+nav_order: 30
+---
+
+# Operational panels
+
+Operational panels in OpenSearch Dashboards are collections of visualizations generated using [Piped Processing Language]({{site.url}}{{site.baseurl}}/observability-plugins/ppl/index) (PPL) queries.
+
+## Get started with operational panels
+
+If you want to start using operational panels without adding any data, expand the **Action** menu, choose **Add samples**, and Dashboards adds a set of operational panels with saved visualizations for you to explore.
+
+## Create an operational panel
+
+To create an operational panel and add visualizations:
+
+1. From the **Add Visualization** dropdown menu, choose **Select Existing Visualization** or **Create New Visualization**, which takes you to the [event analytics]({{site.url}}{{site.baseurl}}/observability-plugins/event-analytics) explorer, where you can use PPL to create visualizations.
+1. If you're adding already existing visualizations, choose a visualization from the dropdown menu.
+1. Choose **Add**.
+
+![Sample operational panel]({{site.url}}{{site.baseurl}}/images/operational-panel.png)
+
+To search for a particular visualization in your operation panels, use PPL queries to search for data you've already added to your panel.