first draft of Dynatrace guide for http plugin (#1464)

First draft of Dynatrace guide for http plugin
Added Dynatrace to summary.md

Signed-off-by: hans-lougas-dt <[email protected]>
Co-authored-by: Craig Norris <[email protected]>

SUMMARY.md

@@ -170,6 +170,7 @@
   * [Azure Logs Ingestion API](pipeline/outputs/azure_logs_ingestion.md)
   * [Counter](pipeline/outputs/counter.md)
   * [Datadog](pipeline/outputs/datadog.md)
+  * [Dynatrace](pipeline/outputs/dynatrace.md)
   * [Elasticsearch](pipeline/outputs/elasticsearch.md)
   * [File](pipeline/outputs/file.md)
   * [FlowCounter](pipeline/outputs/flowcounter.md)

pipeline/outputs/dynatrace.md

@@ -0,0 +1,58 @@
+---
+description: Send logs to Dynatrace
+---
+
+# Dynatrace
+
+Stream logs to [Dynatrace](https://www.dynatrace.com) by utilizing the **http**
+plugin to send data to the
+[Dynatrace generic log ingest API](https://docs.dynatrace.com/docs/shortlink/lma-generic-log-ingestion).
+
+## Configuration parameters
+
+| Key                        | Description | Default |
+| -------------------------- | ----------- | ------- |
+| `header`                   | The specific header for content-type. | `Content-Type application/json; charset=utf-8` |
+| `header`                   | The specific header for authorization token, where {your-API-token-here} is the Dynatrace API token with log ingest scope. | Authorization Api-Token {your-API-token-here} |
+| `allow_duplicated_headers` | Specifies duplicated header use. | `false` |
+| `host`                     | Your Dynatrace environment hostname where {your-environment-id} is your environment ID. | `{your-environment-id}.live.dynatrace.com` |
+| `port`                     | TCP port of your Dynatrace host. | `443` |
+| `uri`                      | Specify the HTTP URI for Dynatrace log ingest API. | `/api/v2/logs/ingest` |
+| `format`                   | The data format to be used in the HTTP request body. | `json` |
+| `json_date_format`         | Date format standard for JSON. | `iso8601` |
+| `json_date_key`            | Fieldname specifying message timestamp. | `timestamp` |
+| `tls`                      | Specify to use TLS. | `on` |
+| `tls.verify`               | TLS verification. | `on` |
+
+## Getting started
+
+To get started with sending logs to Dynatrace:
+
+1. Get a [Dynatrace API](https://docs.dynatrace.com/docs/shortlink/api-authentication)
+   token with the `logs.ingest` (Ingest Logs) scope.
+1. Determine your Dynatrace
+   [environment ID](https://docs.dynatrace.com/docs/shortlink/monitoring-environment#environment-id).
+1. In your main Fluent Bit configuration file, append the following `Output` section:
+
+   ```text
+   [OUTPUT]
+       name         http
+       match        *
+       header       Content-Type application/json; charset=utf-8
+       header       Authorization Api-Token {your-API-token-here}
+       allow_duplicated_headers false
+       host         {your-environment-id}.live.dynatrace.com
+       Port         443
+       URI          /api/v2/logs/ingest
+       Format       json
+       json_date_format iso8601
+       json_date_key timestamp
+       tls          On
+       tls.verify   On
+
+## References
+
+- [Dynatrace Fluent Bit documentation](https://docs.dynatrace.com/docs/shortlink/lma-stream-logs-with-fluent-bit)
+- [Fluent Bit integration in Dynatrace Hub](https://www.dynatrace.com/hub/detail/fluent-bit/?filter=log-management-and-analytics) 
+- [Video: Stream a Log File to Dynatrace using Fluent Bit](https://www.youtube.com/watch?v=JJJNxhtJ6R0)
+- [Blog: Easily stream logs from Fluent Bit to Dynatrace](https://www.dynatrace.com/news/blog/easily-stream-logs-with-fluent-bit-to-dynatrace/)