From d06b6dea26ad0d875f8fcbc92b1fd3c9fcc736e7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?=
<25320357+eedugon@users.noreply.github.com>
Date: Wed, 16 Oct 2024 14:51:36 +0200
Subject: [PATCH 01/15] troubleshoot file added
---
docs/en/observability/index.asciidoc | 2 +
.../observability/slo-troubleshoot.asciidoc | 55 +++++++++++++++++++
2 files changed, 57 insertions(+)
create mode 100644 docs/en/observability/slo-troubleshoot.asciidoc
diff --git a/docs/en/observability/index.asciidoc b/docs/en/observability/index.asciidoc
index 2f77024025..a4152e4d92 100644
--- a/docs/en/observability/index.asciidoc
+++ b/docs/en/observability/index.asciidoc
@@ -233,6 +233,8 @@ include::slo-privileges.asciidoc[leveloffset=+3]
include::slo-create.asciidoc[leveloffset=+3]
+include::slo-troubleshoot.asciidoc[leveloffset=+3]
+
//Data Set Quality
include::logs-monitor-datasets.asciidoc[leveloffset=+1]
diff --git a/docs/en/observability/slo-troubleshoot.asciidoc b/docs/en/observability/slo-troubleshoot.asciidoc
new file mode 100644
index 0000000000..9cc190613c
--- /dev/null
+++ b/docs/en/observability/slo-troubleshoot.asciidoc
@@ -0,0 +1,55 @@
+[[slo-troubleshoot-slos]]
+= Troubleshoot SLOs
+
+++++
+Troubleshoot SLOs
+++++
+
+// tag::slo-license[]
+[IMPORTANT]
+====
+To create and manage SLOs, you need an {subscriptions}[appropriate license] and <> must be configured.
+====
+// end::slo-license[]
+
+This section provides solutions to common questions and problems,
+and processing and performance guidance.
+
+TBD (table of contents with links APM style?)
+
+screenshot available: https://github.com/elastic/kibana/pull/181351
+
+transforms troubleshooting doc: https://www.elastic.co/guide/en/elasticsearch/reference/current/transform-troubleshooting.html
+
+
+explain a SLO rely on Transforms (at least on stateful).
+
+- Help users to to make use of the warning page introduced in 8.15 about unhealthy transforms, and point to the transform troubleshooting docs (https://www.elastic.co/guide/en/elasticsearch/reference/current/transform-troubleshooting.html). We shouldn't focus much on transforms troubleshooting as it's not our domain.
+
+- explain a SLO rely on Transforms and the cluster requires at least 1 node with the transform role
+
+- explain a SLO rely on Ingest pipelines and the cluster requires at least 1 node with the ingest role
+
+- explain SLO relies on some built-in transforms slo-summary* and those have not be deleted or stopped - and eventually document if they're auto-recreated (or how to do it)
+
+associated issue: https://github.com/elastic/observability-docs/issues/4237
+
+
+
+[discrete]
+[[slo-and-transforms]]
+== SLO and Transforms relation
+
+Explain the relation between SLOs and transforms
+
+[discrete]
+[[slo-and-pipelines]]
+== SLO and Ingest Pipelines
+
+Explain the relation between SLOs and Ingest pipelines
+
+[discrete]
+[[transforms-troubleshoot]]
+== Transforms troubleshooting
+
+Introduction and link to the relevant doc about transforms.
From 987d1e8179f781cb68e1fc2baa1142dc3a2c11bc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?=
<25320357+eedugon@users.noreply.github.com>
Date: Tue, 22 Oct 2024 12:30:07 +0200
Subject: [PATCH 02/15] initial draft prepared
---
docs/en/observability/slo-create.asciidoc | 6 +
.../observability/slo-troubleshoot.asciidoc | 373 +++++++++++++++++-
2 files changed, 358 insertions(+), 21 deletions(-)
diff --git a/docs/en/observability/slo-create.asciidoc b/docs/en/observability/slo-create.asciidoc
index e1da49a152..c6b45cf70a 100644
--- a/docs/en/observability/slo-create.asciidoc
+++ b/docs/en/observability/slo-create.asciidoc
@@ -18,6 +18,12 @@ From here, complete the following steps:
. <>.
. <>.
+[NOTE]
+====
+For SLOs to function, the cluster must include one or more nodes with both `ingest` and `transform` {ref}/modules-node.html#node-roles[roles] (they can co-exist or be distributed across separate nodes).
+On ESS deployments (Elastic Cloud), this is handled by the hot nodes, which serve as both `ingest` and `transform` nodes.
+====
+
[discrete]
[[define-sli]]
= Define your SLI
diff --git a/docs/en/observability/slo-troubleshoot.asciidoc b/docs/en/observability/slo-troubleshoot.asciidoc
index 9cc190613c..88045ca240 100644
--- a/docs/en/observability/slo-troubleshoot.asciidoc
+++ b/docs/en/observability/slo-troubleshoot.asciidoc
@@ -1,5 +1,5 @@
[[slo-troubleshoot-slos]]
-= Troubleshoot SLOs
+= Troubleshoot service-level objectives (SLOs)
++++
Troubleshoot SLOs
@@ -12,44 +12,375 @@ To create and manage SLOs, you need an {subscriptions}[appropriate license] and
====
// end::slo-license[]
-This section provides solutions to common questions and problems,
-and processing and performance guidance.
+This document provides an overview of common issues encountered when working with service-level objectives (SLOs). It explores the relationships between SLOs and other core functionalities within the stack, such as {ref}/transforms.html[transforms] and {ref}/ingest.html[ingest pipelines], highlighting how these integrations can impact the functionality of SLOs.
-TBD (table of contents with links APM style?)
+* <>
+* <>
+* <>
+* <>
+** <>
+** <>
+** <>
+** <>
+** <>
+* <>
+** <>
+** <>
+** <>
+** <>
+** <>
+** <>
+** <>
+* <>
+** <>
-screenshot available: https://github.com/elastic/kibana/pull/181351
+[discrete]
+[[slo-resources-details]]
+== SLO Overview
-transforms troubleshooting doc: https://www.elastic.co/guide/en/elasticsearch/reference/current/transform-troubleshooting.html
+An SLO is represented by several system resources:
+* *Definition*: Stored as a Kibana Saved Object
+* *Transforms*: For each SLO, {kib} creates two transforms:
+ * *Rolling-up transform*: rolls up the data into a smaller set of documents.
+ * *Summarising transform*: Updates the latest values, such as the observed SLI or remaining error budget, for efficient searching and filtering of SLOs.
+* *Additional resources*: {kib} also installs and manages shared resources to the SLOs, including index templates, indices, and ingest pipelines, among others.
-explain a SLO rely on Transforms (at least on stateful).
+The rollup documents are stored in `.slo-observability.sli-v3` (index split per month through an ingest pipeline) while summary documents are stored in `.slo-observability.summary-v3`.
-- Help users to to make use of the warning page introduced in 8.15 about unhealthy transforms, and point to the transform troubleshooting docs (https://www.elastic.co/guide/en/elasticsearch/reference/current/transform-troubleshooting.html). We shouldn't focus much on transforms troubleshooting as it's not our domain.
+Each time an SLO is updated, a new transform is created using the latest definition. The transform ID is generated by combining the SLO id and the SLO revision, following the format: `slo-{slo.id}-{slo.revision}`.
-- explain a SLO rely on Transforms and the cluster requires at least 1 node with the transform role
+One of the common issues with SLOs arises when there are underlying problems in the cluster, such as unavailable shards or failed transforms. Since SLOs rely on transforms to aggregate and process data, any failure or misconfiguration in these components can lead to inaccurate or incomplete SLO calculations. Additionally, unavailable shards can affect the data retrieval process, further complicating the reliability of SLO metrics.
-- explain a SLO rely on Ingest pipelines and the cluster requires at least 1 node with the ingest role
+Ensuring that transforms are functioning correctly and that the cluster is healthy is crucial for maintaining accurate and reliable SLOs.
-- explain SLO relies on some built-in transforms slo-summary* and those have not be deleted or stopped - and eventually document if they're auto-recreated (or how to do it)
+[discrete]
+[[slo-and-transforms]]
+== SLOs and Transforms
-associated issue: https://github.com/elastic/observability-docs/issues/4237
+(TBD: should we skip this section if we have already explained enough in the previous one?)
+When working with Service Level Objectives (SLOs) in Elasticsearch, ensuring that the associated transforms function correctly is crucial. Transforms are responsible for generating the data needed for SLOs, and typically, two transforms are created for each SLO. If you notice that your SLOs are not displaying the expected data, it's time to check the health of these associated transforms.
+[discrete]
+[[slo-and-ingest]]
+== SLOs and Ingest Pipelines
+
+(anything specific to add here more than the previous content?)
+(should we add more details about index templates and indices being used?)
[discrete]
-[[slo-and-transforms]]
-== SLO and Transforms relation
+[[slo-common-problems]]
+== Common Problems
+
+[discrete]
+[[slo-no-transform-ingest-node]]
+=== No transform or ingest nodes
+
+Since SLOs depend on both ingest pipelines and transforms to process the data, it's essential to ensure that the cluster has nodes with the appropriate {ref}/modules-node.html#node-roles[roles].
+
+Ensure the cluster includes one or more nodes with both `ingest` and `transform` {ref}/modules-node.html#node-roles[roles] (they can co-exist or be distributed across separate nodes), to support the data processing and transformations required for SLOs to function properly.
+
+[discrete]
+[[slo-transform-unhealthy]]
+=== Unhealthy transforms
+
+(TBD: pending introductory text)
+UI message: "The following transform is an unhealthy state"
+(add screenshot of how the unhealthy transform report looks like, the warning introduced in 8.15)
+
+Possible reasons:
+* SLO source data is malformed (example problems parsing timestamps)
+
+Refer to the {ref}/transform-troubleshooting.html[troubleshooting transforms] documentation for detailed guidance on diagnosing and resolving transform-related issues.
+
+(
+TBD: These 2 KBs have also very good data, should we cover them here or link them?
+https://support.elastic.co/knowledge/8669ddeb
+https://support.elastic.co/knowledge/ad17899e (this is purely for transforms, probably irrelevant here)
+)
+
+Transforms checks:
+* Ensure the needed transforms for the SLOs haven't been deleted or stopped.
++
+If a transform has been deleted the easiest way to recreate it is to update the SLO, as every time the SLO is updated a new transform will be created.
+* Other checks? (TBD)
+
+Tips:
+
+* Fetch a specific transform for a given SLO using this query:
+
+[source,console]
+----------------------------------
+GET kbn:/s/{space}/api/saved_objects/_find?type=slo
+----------------------------------
+
+GET _transform/slo-{id}-{revision}
+
+* Fetch all transforms related with SLOs using:
+[source,console]
+----------------------------------
+GET _transform/slo-*
+----------------------------------
+
+* Fetch stats of a given transform:
+
+[source,console]
+----------------------------------
+GET _transforms/id/_stats
+----------------------------------
+
+[discrete]
+[[slo-missing-pipeline]]
+=== Missing Ingest Pipelines
-Explain the relation between SLOs and transforms
+(decide what to do here)
[discrete]
-[[slo-and-pipelines]]
-== SLO and Ingest Pipelines
+[[slo-missing-template]]
+=== Missing Templates
-Explain the relation between SLOs and Ingest pipelines
+(decide what to do here)
[discrete]
-[[transforms-troubleshoot]]
-== Transforms troubleshooting
+[[slo-missing-indices]]
+=== Missing Indices or Shards
+
+(decide what to do here. I'm sharing error examples I have collected to see if it makes sense to offer some background and context for issues that are not really related with SLOs logic but with other parts of the stack).
+
+Other examples:
+> Failed to execute phase [can_match], start; org.elasticsearch.action.search.SearchPhaseExecutionException: Search rejected due to missing shards [[.ds-metrics-apm.internal-default-2024.06.08-000030][1], [.ds-metrics-apm.service_transaction.1m-default-2024.06.07-000023][1], [.ds-metrics-apm.transaction.1m-default-2024.06.07-000024][1]]. Consider using `allow_partial_search_results` setting to bypass this error.
+
+another (unavailable remote cluster (CCS))
+> Validation Failed: 1: no such remote cluster: [metrics];2: no such remote cluster: [metrics];
+
+> Some Transform failures can be totally unrelated to SLO/O11y but to platform (example: circuit breaker exceptions due to low memory on ES side).
+
+[source,bash]
+----
+ "reason": """Failed to index documents into destination index due to permanent error: [org.elasticsearch.xpack.transform.transforms.BulkIndexingException: Bulk index experienced [500] failures and at least 1 irrecoverable [unable to parse date [1702842480000]]. Other failures:
+[IngestProcessorException] message [org.elasticsearch.ingest.IngestProcessorException: java.lang.IllegalArgumentException: unable to parse date [1702842480000]]; java.lang.IllegalArgumentException: unable to parse date [1702842480000]]""",
+
+ "issue": "Transform task state is [failed]",
+ "details": """Failed to index documents into destination index due to permanent error: [org.elasticsearch.xpack.transform.transforms.BulkIndexingException: Bulk index experienced [500] failures and at least 1 irrecoverable [unable to parse date [1702842480000]]. Other failures:
+[IngestProcessorException] message [org.elasticsearch.ingest.IngestProcessorException: java.lang.IllegalArgumentException: unable to parse date [1702842480000]]; java.lang.IllegalArgumentException: unable to parse date [1702842480000]]""",
+ "count": 1
+----
+
+[discrete]
+[[slo-troubleshoot-beta]]
+=== After upgrading from a Beta version, SLOs don't show up
+
+If upgrading from a Beta version (<8.12) to 8.12+, it is possible that some SLOs are not recoverable. Therefore it is recommended to clean up any residual resources and start fresh.
+
+In order to completely remove an SLO and its resources you have to:
+
+. Remove the rollup transform: `slo-{id}-{revision}`.
+
+. Remove the summary transform: `slo-summary-{id}-{revision}`.
+
+. Remove the summary ingest pipeline: `.slo-observability.summary.pipeline-{id}-{revision}`.
+
+. Remove the SLO saved object.
+
+
+[discrete]
+[[slo-api-calls]]
+== Using API calls to retrieve SLO details
+
+The following {kib} API calls are useful to retrieve different level of details of the SLOs and surrounding components.
+
+[discrete]
+[[slo-api-find]]
+=== Find SLO definitions
+
+You can achieve this in multiple ways:
+
+* From Saved Objects
+
+The following query returns the stored SLO definitions. SLO, and therefore this API, is space aware.
+
+[source,console]
+----------------------------------
+GET kbn:/s/{space}/api/saved_objects/_find?type=slo
+----------------------------------
+
+* Through _definitions API
+
+The following internal API returns the SLO definitions. It is space aware.
+
+[source,console]
+----------------------------------
+GET kbn:/s/{space}/api/observability/slos/_definitions
+----------------------------------
+
+* Through slos API
+
+The following public API returns the total number of SLOs, including the group by instances. It is space aware.
+
+[source,console]
+----------------------------------
+GET kbn:/s/{space}/api/observability/slos
+----------------------------------
+
+* Through UI
+
+Users can also get the total number of SLOs through the SLO UI. In the SLO Overview page we display the total number of SLOs.
+
+* Via Raw Kibana index
+
+[source,console]
+----------------------------------
+GET .kibana*/_search
+{
+ "size": 10, # adjust this
+ "query": {
+ "term": {
+ "type": {
+ "value": "slo"
+ }
+ }
+ }
+}
+----------------------------------
+
+
+[discrete]
+[[slo-api-find-specific]]
+=== Find definition for a specific SLO
+
+The following internal API returns the SLO definition for a specific SLO, filtered by the name of the SLO:
+
+[source,console]
+----------------------------------
+GET kbn:/api/observability/slos/_definitions?search=Some SLO
+----------------------------------
+
+
+
+[discrete]
+[[slo-api-find-rollup]]
+=== Find rollup SLO transforms
+
+Each SLO creates a rollup transform, and everytime you update the SLO a new transform is created with the latest definition.
+
+The transform id is built with the slo id and the slo revision as `slo-{slo.id}-{slo.revision}`.
+
+Fetch a specific transform for a given SLO using this call:
+
+[source,console]
+----------------------------------
+GET _transform/slo-{id}-{revision}
+----------------------------------
+
+You can also fetch all transforms using:
+
+GET _transform/slo-*
+
+[discrete]
+[[slo-api-rollup-documents]]
+=== Search the rollup documents for an SLO
+
+It can be useful to fetch the latest rollup document for a given slo id and optionally an instance id, in case investigating why an SLO shows as no data for too long.
+
+[source,console]
+----------------------------------
+POST .slo-observability.sli-v3*/_search
+{
+ "sort": [
+ {
+ "event.ingested": {
+ "order": "desc"
+ }
+ }
+ ],
+ "query": {
+ "bool": {
+ "filter": [
+ {
+ "term": {
+ "slo.id": "id"
+ }
+ },
+ {
+ "term": {
+ "slo.instanceId": "instanceId"
+ }
+ }
+ ]
+ }
+ }
+}
+----------------------------------
+
+[discrete]
+[[slo-api-summary-documents]]
+=== Search the summary documents for an SLO
+
+It can be useful to fetch the latest summary document for a given slo id and optionally an instance id:
+
+[source,console]
+----------------------------------
+POST .slo-observability.summary-v3*/_search
+{
+ "query": {
+ "bool": {
+ "filter": [
+ {
+ "term": {
+ "slo.id": "id"
+ }
+ },
+ {
+ "term": {
+ "slo.instanceId": "instanceId"
+ }
+ }
+ ]
+ }
+ }
+}
+----------------------------------
+
+[discrete]
+[[slo-troubleshoot-inspect]]
+=== Inspect SLO Assets
+
+In order to inspect any of the following:
+
+. SLO Configuration
+. Rollup Transform Configuration
+. Summary Transform Configuration
+. SLO Ingest Pipeline
+. Temporary Document
+
+Follow the steps:
+. Open Kibana's *Stack Management* -> *Advanced Settings*
+. Enable `observability:enableInspectEsQueries`
+. Visit the SLO edit page and click on *SLO Inspect*
+
+[discrete]
+[[slo-troubleshooting-actions]]
+== Actions (TBD)
+
+intro text?
+
+[discrete]
+[[slo-troubleshooting-reset]]
+=== Reset transforms
+
+[NOTE]
+====
+While resetting an SLO can help resolve certain issues, it may not always address the root cause of errors. Most errors related to transforms typically arise from improperly structured source data, such as unparseable timestamps, which prevent the transform from progressing. Additionally, misformatted SLO queries, and consequently transform queries, can also lead to failures.
+
+Therefore, before resetting the SLO, verify that the source data and queries are correctly formatted and validated. Resetting should only be used as a last resort when all other troubleshooting steps have been exhausted.
+====
+
+If you are on 8.12+, you should try and reset the SLO using the following Dev console command to reset the SLO:
+
+[source,console]
+----
+POST kbn:/api/observability/slos/{sloId}/_reset
+----
-Introduction and link to the relevant doc about transforms.
+This action deletes all SLI data, summary data, and transforms, and then reinstalls and processes the data. Essentially, it recreates the SLO as if it had been deleted and re-created by the user.
From 68848a573886a519057be2bdba94cea22b601dfc Mon Sep 17 00:00:00 2001
From: Colleen McGinnis
Date: Mon, 21 Oct 2024 11:33:08 -0500
Subject: [PATCH 03/15] [APM] Adds information on excluding data tiers from
searches (#4327)
* initial draft
* address feedback
* add feedback
---------
Co-authored-by: Brandon Morelli
Co-authored-by: Brandon Morelli
---
.../cross-cluster-search.asciidoc | 15 ++++++++++++++-
1 file changed, 14 insertions(+), 1 deletion(-)
diff --git a/docs/en/observability/apm/view-and-analyze/filter-and-search/cross-cluster-search.asciidoc b/docs/en/observability/apm/view-and-analyze/filter-and-search/cross-cluster-search.asciidoc
index 875d0c827a..16e3494026 100644
--- a/docs/en/observability/apm/view-and-analyze/filter-and-search/cross-cluster-search.asciidoc
+++ b/docs/en/observability/apm/view-and-analyze/filter-and-search/cross-cluster-search.asciidoc
@@ -21,7 +21,7 @@ and allowing for better performance while managing multiple observability use ca
If you're using the Hosted {ess}, see {cloud}/ec-enable-ccs.html[Enable cross-cluster search].
// lint ignore elasticsearch
-You can add remote clusters directly in {kib}, under *Management* > *Elasticsearch* > *Remote clusters*.
+You can add remote clusters directly in {kib}, under *Management* → *Elasticsearch* → *Remote clusters*.
All you need is a name for the remote cluster and the seed node(s).
Remember the names of your remote clusters, you'll need them in step two.
See {ref}/ccr-getting-started.html[managing remote clusters] for detailed information on the setup process.
@@ -48,3 +48,16 @@ There are two ways to edit the default {data-source}:
include remote clusters.
* In `kibana.yml` -- Update the {kibana-ref}/apm-settings-kb.html[`xpack.apm.indices.*`] configuration values to
include remote clusters.
+
+[TIP]
+.Exclude data tiers from search
+====
+In a cross-cluster search (CCS) environment, it's possible for different clusters to serve different data tiers in responses.
+If one of the requested clusters responds slowly, it can cause a timeout at the proxy after 320 seconds.
+This results in 502 Bad Gateway server error responses presented as failure toast messages in the UI, and no data loaded.
+
+To prevent this, you can exclude {ref}/data-tiers.html[data tiers] that might slow down responses from search: the `data_frozen` and `data_cold` tiers. To exclude data tiers from search in the APM UI:
+
+. In {kib}, go to *Stack Management* → *Advanced Settings*.
+. In the *Observability* section, update the *Excluded data tiers from search* option with a list of data tiers.
+====
From 3b604b3495d8f0b454b1c03422f70c1054d54f61 Mon Sep 17 00:00:00 2001
From: DeDe Morton
Date: Tue, 22 Oct 2024 09:53:15 -0700
Subject: [PATCH 04/15] Add disk metrics to list of docker container metrics
(#4396)
* Add network metrics to list of docker container metrics
* Fix build error
* Fix typo
---
.../images/metrics-overlay-containers.png | Bin 49099 -> 62565 bytes
.../container-details-partial.asciidoc | 2 +-
.../monitor-infra/container-metrics.asciidoc | 22 +++++++++
.../images/metrics-overlay-containers.png | Bin 49099 -> 62565 bytes
.../infra-monitoring/container-metrics.mdx | 42 +++++++++++++++++-
.../transclusion/container-details.mdx | 2 +-
6 files changed, 64 insertions(+), 4 deletions(-)
diff --git a/docs/en/observability/images/metrics-overlay-containers.png b/docs/en/observability/images/metrics-overlay-containers.png
index adf2c9be3db94ae8c3786787de4e6ec4dc3717e2..bed3b15e90f8e0e69a9f491b736ddd2e99483967 100644
GIT binary patch
literal 62565
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