out_datadog: Document dd_hostname configuration option (#1401)

* out_datadog: Document `dd_hostname` configuration option Added by fluent/fluent-bit#8988 Signed-off-by: Jesse Szwedko <[email protected]> * Update pipeline/outputs/datadog.md Co-authored-by: Craig Norris <[email protected]> Signed-off-by: Jesse Szwedko <[email protected]> * Added link Signed-off-by: Jesse Szwedko <[email protected]> --------- Signed-off-by: Jesse Szwedko <[email protected]> Signed-off-by: Jesse Szwedko <[email protected]> Co-authored-by: Craig Norris <[email protected]>
fluent · Nov 29, 2024 · b5509e7 · b5509e7
1 parent f5d285d
commit b5509e7
Showing 1 changed file with 2 additions and 0 deletions.
diff --git a/pipeline/outputs/datadog.md b/pipeline/outputs/datadog.md
@@ -25,6 +25,7 @@ Before you begin, you need a [Datadog account](https://app.datadoghq.com/signup)
 | dd_source       | _Recommended_ - A human readable name for the underlying technology of your service (e.g. `postgres` or `nginx`). If unset, Datadog will look for the source in the [`ddsource` attribute](https://docs.datadoghq.com/logs/log_configuration/pipelines/?tab=source#source-attribute).                                                                                                                                                                                                                                                                                                                   |                                  |
 | dd_tags         | _Optional_ - The [tags](https://docs.datadoghq.com/tagging/) you want to assign to your logs in Datadog. If unset, Datadog will look for the tags in the [`ddtags` attribute](https://docs.datadoghq.com/api/latest/logs/#send-logs).                                                                                                                                                                                                                                                                                                                                   |                                  |
 | dd_message_key  | By default, the plugin searches for the key 'log' and remap the value to the key 'message'. If the property is set, the plugin will search the property name key.                                                                                                                                                                                                                                                                          |                                  |
+| dd_hostname     | The host the emitted logs should be associated with. If unset, Datadog expects the host to be set with `host`, `hostname`, or `syslog.hostname` attributes. See [Datadog Logs preprocessor documentation](https://docs.datadoghq.com/logs/log_configuration/pipelines/?tab=host#preprocessing) for recognized attributes. | _none_ |
 | workers | The number of [workers](../../administration/multithreading.md#outputs) to perform flush operations for this output. | `0` |
 | header | Add additional arbitrary HTTP header key/value pair. Multiple headers can be set. | _none_ |
 
@@ -43,6 +44,7 @@ Get started quickly with this configuration file:
     dd_service  <my-app-service>
     dd_source   <my-app-source>
     dd_tags     team:logs,foo:bar
+    dd_hostname myhost
 ```
 
 ## Troubleshooting