diff --git a/docs/logs/images/alert-actions-menu.png b/docs/logs/images/alert-actions-menu.png
new file mode 100644
index 000000000000..3f96a700a0ac
Binary files /dev/null and b/docs/logs/images/alert-actions-menu.png differ
diff --git a/docs/logs/images/alert-flyout.png b/docs/logs/images/alert-flyout.png
new file mode 100644
index 000000000000..30c8857758a8
Binary files /dev/null and b/docs/logs/images/alert-flyout.png differ
diff --git a/docs/logs/index.asciidoc b/docs/logs/index.asciidoc
index b12dc096bff4..0d225e5e89c1 100644
--- a/docs/logs/index.asciidoc
+++ b/docs/logs/index.asciidoc
@@ -17,6 +17,7 @@ In this case, you will only see the logs for the selected component.
 * <<xpack-logs-using>>
 * <<xpack-logs-configuring>>
 * <<xpack-logs-analysis>>
+* <<xpack-logs-alerting>>
 
 [role="screenshot"]
 image::logs/images/logs-console.png[Log Console in Kibana]
@@ -30,3 +31,5 @@ include::using.asciidoc[]
 include::configuring.asciidoc[]
 
 include::log-rate.asciidoc[]
+
+include::logs-alerting.asciidoc[]
diff --git a/docs/logs/logs-alerting.asciidoc b/docs/logs/logs-alerting.asciidoc
new file mode 100644
index 000000000000..f08a09187a0c
--- /dev/null
+++ b/docs/logs/logs-alerting.asciidoc
@@ -0,0 +1,27 @@
+[role="xpack"]
+[[xpack-logs-alerting]]
+== Logs alerting
+
+[float]
+=== Overview
+
+To use the alerting functionality you need to {kibana-ref}/alerting-getting-started.html#alerting-setup-prerequisites[set up alerting].
+
+You can then select the *Create alert* option, from the *Alerts* actions dropdown.
+
+[role="screenshot"]
+image::logs/images/alert-actions-menu.png[Screenshot showing alerts menu]
+
+Within the alert flyout you can configure your logs alert:
+
+[role="screenshot"]
+image::logs/images/alert-flyout.png[Screenshot showing alerts flyout]
+
+[float]
+=== Fields and comparators
+
+The comparators available for conditions depend on the chosen field. The combinations available are:
+
+- Numeric fields: *more than*, *more than or equals*, *less than*, *less than or equals*, *equals*, and *does not equal*.
+- Aggregatable fields: *is* and *is not*.
+- Non-aggregatable fields: *matches*, *does not match*, *matches phrase*, *does not match phrase*.