Document Dynatrace output (#1106)

* add dynatrace output

* add dynatrace to allowed words

Author: immavalls

.vale/Vocab/docs/accept.txt

@@ -62,6 +62,7 @@ discoverability
 dcadwallader
 deserialized
 Dev
+Dynatrace
 enum
 errno
 erroring

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)
+- [Dynatrace](/results-output/real-time/dynatrace)
 - [Elasticsearch](/results-output/real-time/elasticsearch)
 - [Grafana Cloud / Prometheus](/results-output/real-time/grafana-cloud)
 - [InfluxDB](/results-output/real-time/influxdb-grafana)

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)
+- [Dynatrace](/results-output/real-time/dynatrace)
 - [Elasticsearch](/results-output/real-time/elasticsearch)
 - [Grafana Cloud](/results-output/real-time/grafana-cloud)
 - [InfluxDB](/results-output/real-time/influxdb-grafana)

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

@@ -0,0 +1,57 @@
+---
+title: 'Dynatrace'
+excerpt: Send k6 output to Dynatrace to visualize load test results and correlate performance testing metrics in Dynatrace.
+---
+
+Using the [Dynatrace k6 extension](https://github.com/Dynatrace/xk6-output-dynatrace) you can send metrics to [Dynatrace](https://www.dynatrace.com/). That allows visualizing and correlating performance testing metrics with other monitored metrics in Dynatrace.
+
+## Build the k6 version
+
+<InstallationInstructions extensionUrl="github.com/Dynatrace/xk6-output-dynatrace"/>
+
+## Run the test
+
+Create a Dynatrace API token to send the data. 
+
+<Blockquote mod="attention">
+The Dynatrace API Token must have the scope name "metrics.ingest" (scope type "API v2").
+</Blockquote> 
+
+You can use the Dynatrace UI:
+
+![Dynatrace API token](./images/Dynatrace/dynatrace-api-token.png)
+
+Or a `curl` command (replace `<environment-id>` and the `Api-Token`):
+
+```bash
+curl -X POST "https://<environment-id>.live.dynatrace.com/api/v2/apiTokens" -H "accept: application/json; charset=utf-8" -H "Content-Type: application/json; charset=utf-8" -d "{\"name\":\"\",\"scopes\":[\"metrics.ingest\"]}" -H "Authorization: Api-Token XXXXXXXX"
+```
+
+Use the previously built k6 binary and run the test passing the Dynatrace URL and API token as follows:
+
+```bash
+# export dynatrace variables
+export K6_DYNATRACE_URL=https://<environmentid>.live.dynatrace.com
+export K6_DYNATRACE_APITOKEN=<Dynatrace API token>
+
+# run the test
+./k6 run script.js -o output-dynatrace
+```
+
+You can now check the metrics in your Dynatrace environment, filtering for `k6`:
+
+![Dynatrace Test result](./images/Dynatrace/dynatrace-k6-metrics.png)
+
+![Dynatrace Test result](./images/Dynatrace/dynatrace-k6-test-result.png)
+
+### Options
+
+When streaming the k6 results to Dynatrace, you can configure the Dynatrace options below:
+
+| Name                                     | Value                                                                                                       |
+| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
+| `K6_DYNATRACE_APITOKEN`                  | Dynatrace API token to write the metrics. The token must have the scope `metrics.ingest API v2`.  |
+| `K6_DYNATRACE_FLUSH_PERIOD`              | Define how often metrics are sent to Dynatrace. The default value is 1 second.  |
+| `K6_DYNATRACE_URL`                       | Dynatrace URL. The default value is `https://dynatrace.live.com`.  |
+| `K6_DYNATRACE_INSECURE_SKIP_TLS_VERIFY`  | If `true`, the HTTP client kips TLS verification on the endpoint. The default value is `true`. |
+| `K6_DYNATRACE_HEADER`                    | Pair of key/value headers to add to Dynatrace requests. |

src/data/markdown/translated-guides/en/03 Results output/200 Real-time/images/Dynatrace/dynatrace-api-token.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 Dynatrace from 'svg/dynatrace.inline.svg';
 import Elasticsearch from 'svg/elastic.inline.svg';
 import Flagger from 'svg/flagger.inline.svg';
 import GitHub from 'svg/github.inline.svg';
@@ -70,6 +71,11 @@ const iconsDataSet1 = [
     name: 'Datadog',
     to: '/results-output/real-time/datadog',
   },
+  {
+    Icon: Dynatrace,
+    name: 'Dynatrace',
+    to: '/results-output/real-time/dynatrace',
+  },
   {
     Icon: Elasticsearch,
     name: 'Elasticsearch',