From 6c3bd1d17a8b5655f17aa019b887f9bcd7916b36 Mon Sep 17 00:00:00 2001
From: "mergify[bot]" <37929162+mergify[bot]@users.noreply.github.com>
Date: Wed, 16 Oct 2024 10:48:55 -0500
Subject: [PATCH] [8.x](backport #4346) [synthetics] Document Synthetics
 availability SLI (#4380)

* [synthetics] Document Synthetics availability SLI (#4346)

* add info on synthetics availability sli

* add note about grouping

* update serverless docs

(cherry picked from commit c33dd958145541864005186c27fb5cd407e1808b)

# Conflicts:
#	docs/en/serverless/slos/create-an-slo.mdx
#	docs/en/serverless/transclusion/synthetics/configuration/monitor-config-options.mdx

* Delete docs/en/serverless directory

---------

Co-authored-by: Colleen McGinnis <colleen.mcginnis@elastic.co>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
---
 docs/en/observability/slo-create.asciidoc     | 23 +++++++++++++++++++
 .../synthetics-configuration.asciidoc         |  4 ++--
 2 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/docs/en/observability/slo-create.asciidoc b/docs/en/observability/slo-create.asciidoc
index 00052f5ba3..e1da49a152 100644
--- a/docs/en/observability/slo-create.asciidoc
+++ b/docs/en/observability/slo-create.asciidoc
@@ -29,6 +29,7 @@ The type of SLI to use depends on the location of your data:
 * <<timeslice-metric-sli, Timeslice metric>> — create an SLI based on a custom equation that uses multiple aggregations.
 * <<histogram-metric-sli, Histogram metric>> — create an SLI based on histogram metrics.
 * <<apm-latency-and-availability-sli, APM latency and APM availability>> — create an SLI based on services using application performance monitoring (APM).
+* <<synthetics-availability-sli>> — create an SLI based on the availability of your synthetic monitors.
 
 [discrete]
 [[custom-kql-sli]]
@@ -161,6 +162,28 @@ When defining an APM latency or APM availability SLI, set the following fields:
 * *Threshold (APM latency only)* — The latency threshold in milliseconds (ms) to consider the request as good.
 * *Query filter* — An optional query filter on the APM data.
 
+[discrete]
+[[synthetics-availability-sli]]
+== Synthetics availability
+
+Create an indicator based on the availability of your synthetic monitors.
+Availability is determined by calculating the percentage of checks that are successful (`monitor.status : "up"`)
+out of the total number of checks.
+
+*Example*: You can define an indicator based on a HTTP monitor being "up" for at least 99% of the time.
+
+When defining a Synthetics availability SLI, set the following fields:
+
+* *Monitor name* — The name of one or more <<synthetics-configuration-monitor-name,synthetic monitors>>.
+* *Project* — The ID of one or more <<synthetics-configuration-project,projects>> containing synthetic monitors.
+* *Tags* — One or more <<synthetics-configuration-monitor-tags,tags>> assigned to synthetic monitors.
+* *Query filter* — An optional KQL query used to filter the Synthetics checks on some relevant criteria.
+
+[NOTE]
+====
+Synthetics availability SLIs are automatically grouped by monitor and location.
+====
+
 [discrete]
 [[set-slo]]
 = Set your objectives
diff --git a/docs/en/observability/synthetics-configuration.asciidoc b/docs/en/observability/synthetics-configuration.asciidoc
index 68854a0f74..0f44da73d3 100644
--- a/docs/en/observability/synthetics-configuration.asciidoc
+++ b/docs/en/observability/synthetics-configuration.asciidoc
@@ -225,9 +225,9 @@ Default values to be applied to _all_ monitors when using the <<elastic-syntheti
 // tag::monitor-config-options[]
 `id` (`string`)::
 A unique identifier for this monitor.
-`name` (`string`)::
+[[synthetics-configuration-monitor-name]] `name` (`string`)::
 A human readable name for the monitor.
-`tags` (`Array<string>`)::
+[[synthetics-configuration-monitor-tags]] `tags` (`Array<string>`)::
 A list of tags that will be sent with the monitor event. Tags are displayed in the {synthetics-app} and allow you to search monitors by tag.
 `schedule` (`number`)::
 The interval (in minutes) at which the monitor should run.