Add documentation for SSO (#2940)
* Add documentation for SSO Signed-off-by: ariamarble <armarble@amazon.com> * added content Signed-off-by: ariamarble <armarble@amazon.com> * technical review changes Signed-off-by: ariamarble <armarble@amazon.com> * Apply suggestions from doc review Co-authored-by: Caroline <113052567+carolxob@users.noreply.github.com> * Made further doc review changes Signed-off-by: ariamarble <armarble@amazon.com> * Apply suggestions from editorial review Co-authored-by: Nathan Bower <nbower@amazon.com> * Made editorial changes Signed-off-by: ariamarble <armarble@amazon.com> * Apply further suggestions from editorial review Co-authored-by: Nathan Bower <nbower@amazon.com> * case changing Signed-off-by: ariamarble <armarble@amazon.com> * sentence re-write Signed-off-by: ariamarble <armarble@amazon.com> * quick link fix Signed-off-by: ariamarble <armarble@amazon.com> --------- Signed-off-by: ariamarble <armarble@amazon.com> Co-authored-by: Caroline <113052567+carolxob@users.noreply.github.com> Co-authored-by: Nathan Bower <nbower@amazon.com>
This commit is contained in:
parent
bcaf1aeab8
commit
9052c45ffc
|
@ -0,0 +1,41 @@
|
|||
---
|
||||
layout: default
|
||||
title: Simple Schema for Observability
|
||||
nav_order: 120
|
||||
---
|
||||
|
||||
# Simple Schema for Observability
|
||||
Introduced 2.6
|
||||
{: .label .label-purple }
|
||||
|
||||
OpenSearch 2.6 introduced a standardization for conforming to a common and unified observability schema: Simple Schema for Observability (SSO). [Observability]({{site.url}}{{site.baseurl}}/observing-your-data/index/) is a collection of plugins and applications that let you visualize data-driven events by using Piped Processing Language (PPL) to explore and query data stored in OpenSearch.
|
||||
|
||||
With the schema in place, Observability tools can ingest, automatically extract, and aggregate data and create custom dashboards, making it easier to understand the system at a higher level.
|
||||
|
||||
SSO is inspired by both [OpenTelemetry](https://opentelemetry.io/docs/) and the Elastic Common Schema (ECS) and uses Amazon Elastic Container Service ([Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_cwe_events.html)) event logs and OpenTelemetry metadata.
|
||||
|
||||
Alerts will be supported in a future release.
|
||||
{: .note }
|
||||
|
||||
## Use cases
|
||||
|
||||
Use cases for SSO include:
|
||||
|
||||
* Ingesting observability data from different data types.
|
||||
* Moving from proprietary configurations that are non-transferable to a consolidated, sharable observability solution that allows users to ingest and display an analysis of any type of telemetry data from any type of provider.
|
||||
|
||||
Data Prepper conforms to the SSO schema for metrics and will gradually support traces and logs.
|
||||
|
||||
Data Prepper's [trace mapping]({{site.url}}{{site.baseurl}}/data-prepper/common-use-cases/trace-analytics/) currently provides `service-map` data in a different way than SSO traces. To make the trace mapping compatible with Observability, it will be integrated with the SSO traces schema and will introduce `service-map` as an enriched field.
|
||||
{: .note }
|
||||
|
||||
## Traces and metrics
|
||||
|
||||
Schema definitions for traces and metrics are defined and supported by the Observability plugin.
|
||||
|
||||
These schema definitions include:
|
||||
|
||||
- The index structure (mapping).
|
||||
- The [index naming conventions](https://github.com/opensearch-project/observability/issues/1405).
|
||||
- A JSON schema for enforcement and validation of the structure.
|
||||
- The [integration](https://github.com/opensearch-project/OpenSearch-Dashboards/issues/3412) feature for adding preconfigured dashboards and assets.
|
Loading…
Reference in New Issue