Document/elasticsearch output (#1104)

* fix typo and missing metrics link

* Add Elasticsearch output

* Fix lint:prose error

---------

Co-authored-by: Pepe Cano <[email protected]>

Author: immavalls

.vale/Vocab/docs/accept.txt

@@ -87,6 +87,7 @@ jmx
 j[qQ]uery
 jq
 loki
+Kibana
 Lua
 maxfiles
 Netdata

src/data/markdown/docs/04 integrations/04 Results visualization/14 elasticsearch.md

@@ -0,0 +1,4 @@
+---
+title: 'Elasticsearch'
+redirect: 'https://k6.io/docs/results-output/real-time/elasticsearch'
+---

src/data/markdown/translated-guides/en/01 Get started/04 Results Output.md

@@ -85,6 +85,7 @@ The available built-in outputs include:
 - [Cloud](/results-output/real-time/cloud)
 - [CSV](/results-output/real-time/csv)
 - [Datadog](/results-output/real-time/datadog)
+- [Elasticsearch](/results-output/real-time/elasticsearch)
 - [Grafana Cloud / Prometheus](/results-output/real-time/grafana-cloud)
 - [InfluxDB](/results-output/real-time/influxdb-grafana)
 - [JSON](/results-output/real-time/json)

src/data/markdown/translated-guides/en/03 Results output/200 Real-time.md

@@ -31,6 +31,7 @@ You can also stream real-time metrics to the following services:
 - [Apache Kafka](/results-output/real-time/apache-kafka)
 - [Cloud](/results-output/real-time/cloud)
 - [Datadog](/results-output/real-time/datadog)
+- [Elasticsearch](/results-output/real-time/elasticsearch)
 - [Grafana Cloud](/results-output/real-time/grafana-cloud)
 - [InfluxDB](/results-output/real-time/influxdb-grafana)
 - [Netdata](/results-output/real-time/netdata)

src/data/markdown/translated-guides/en/03 Results output/200 Real-time/00 Elasticsearch.md

@@ -0,0 +1,76 @@
+---
+title: 'Elasticsearch'
+excerpt: k6 has an output extension to store k6 metrics in Elasticsearch. This document shows you how to configure the k6 Elasticsearch integration.
+---
+
+Using the [Elasticsearch k6 extension](https://github.com/elastic/xk6-output-elasticsearch), you can store k6 metrics in [Elasticsearch](https://github.com/elastic/elasticsearch) and analyze your performance results with Kibana or Grafana.
+
+
+## Build the k6 version
+
+<InstallationInstructions extensionUrl="github.com/elastic/xk6-output-elasticsearch"/>
+
+## Run the test
+
+Check that the Elasticsearch instance which will store the k6 metrics is running. 
+
+If you are running on Elasticsearch cloud, use the previous k6 binary and run the test passing the cloud credentials as follows:
+
+```bash
+# export cloud configuration
+export K6_ELASTICSEARCH_CLOUD_ID=your-cloud-id-here
+export K6_ELASTICSEARCH_USER=your-user-here
+export K6_ELASTICSEARCH_PASSWORD=your-password-here
+
+# run the test
+./k6 run script.js -o output-elasticsearch
+```
+
+k6 runs the test script and sends the metrics in real-time to Elasticsearch. 
+
+You can also send the metrics to a local Elasticsearch cluster:
+
+```bash
+# export local url
+export K6_ELASTICSEARCH_URL=http://localhost:9200
+
+# run the test
+./k6 run script.js -o output-elasticsearch
+```
+
+<Blockquote mod="attention">
+Security and self-signed certificates for non-cloud clusters are not yet supported
+</Blockquote>
+
+You can now connect to Elasticsearch and query the [k6 metrics](/using-k6/metrics/) stored in the `k6-metrics` index. The example below uses an unsecured local Elasticsearch version `7.17.9`:
+
+```bash
+curl -XGET 'http://localhost:9200/k6-metrics/_search?pretty' -H 'Content-Type: application/json' -d'
+{
+  "sort": [
+    {
+      "Time": {
+        "order": "desc"
+      }
+    }
+  ],
+  "size": 10
+}'
+```
+
+Or use [Kibana Discover](https://www.elastic.co/guide/en/kibana/7.17/discover.html):
+
+![Kibana Discover k6 results](./images/Elasticsearch/kibana-discover-test-result.png)
+
+### Options
+
+Here is the full list of options that can be configured and passed to the extension:
+
+| Name                                     | Value                                                                                                       |
+| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
+| `K6_ELASTICSEARCH_CLOUD_ID`                     | Elasticsearch `cloud.id`, which can be found in the Elastic Cloud web console.  |
+| `K6_ELASTICSEARCH_FLUSH_PERIOD`                     | Define how often metrics are sent to Elasticsearch. The default value is 1 second.  |
+| `K6_ELASTICSEARCH_URL`                     | Elasticsearch URL.  |
+| `K6_ELASTICSEARCH_USER`                     | Elasticsearch username.  |
+| `K6_ELASTICSEARCH_PASSWORD`                     | Elasticsearch password.  |
+

src/data/markdown/translated-guides/en/03 Results output/200 Real-time/00 TimescaleDB.md

@@ -21,7 +21,7 @@ Use the previous k6 binary and run the test passing the Postgres connection stri
 k6 run script.js -o timescaledb=postgresql://<postgresql_user_name>:<password>@<ip>:<port>/<database>
 ```
 
-k6 runs the test script and send the metrics in real-time to the TimescaleDB instance. You can now connect to TimescaleDB and query the [k6 metrics]().
+k6 runs the test script and sends the metrics in real-time to the TimescaleDB instance. You can now connect to TimescaleDB and query the [k6 metrics](/using-k6/metrics/).
 
 ```bash
 k6=# SELECT metric,AVG (value) FROM samples GROUP BY metric;

src/data/markdown/translated-guides/en/03 Results output/200 Real-time/images/Elasticsearch/kibana-discover-test-result.png

@@ -24,6 +24,7 @@ import Buddy from 'svg/buddy.inline.svg';
 import CircleCI from 'svg/circleci.inline.svg';
 import CSV from 'svg/csv.inline.svg';
 import Datadog from 'svg/datadog.inline.svg';
+import Elasticsearch from 'svg/elastic.inline.svg';
 import Flagger from 'svg/flagger.inline.svg';
 import GitHub from 'svg/github.inline.svg';
 import Gitlab from 'svg/gitlab.inline.svg';
@@ -69,6 +70,11 @@ const iconsDataSet1 = [
     name: 'Datadog',
     to: '/results-output/real-time/datadog',
   },
+  {
+    Icon: Elasticsearch,
+    name: 'Elasticsearch',
+    to: '/results-output/real-time/elasticsearch',
+  },
   {
     Icon: Grafana,
     name: 'Grafana Cloud',