You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/logs/log_configuration/processors.md
+19-5Lines changed: 19 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -287,13 +287,27 @@ Use the [Datadog Log Pipeline API endpoint][1] with the following log message re
287
287
288
288
## Remapper
289
289
290
-
The remapper processor remaps any source attribute(s) or tags to another target attribute or tag. For example, remap `user`by `firstname` to target your logs in the Log Explorer.
290
+
The remapper processor remaps one or more source attribute(s) or tags to different target attribute or tag. For example, you can remap the `user`attribute to `firstname` to normalize log data in the Log Explorer.
291
291
292
-
Constraints on the tag/attribute name are explained in the [attributes and tags documentation][5]. Some additional constraints, applied as `:`or `,`, are not allowed in the target tag/attribute name.
292
+
If the remapper target is an attribute, the processor can also try to cast the value to a new type (`String`, `Integer`or `Double`). If the cast fails, the original value and type are preserved.
293
293
294
-
If the target of the remapper is an attribute, the remapper can also try to cast the value to a new type (`String`, `Integer` or `Double`). If the cast is not possible, the original type is kept.
294
+
**Note**: The decimal separator for `Double` values need to be `.`.
295
295
296
-
**Note**: The decimal separator for `Double` need to be `.`.
296
+
### Naming constraints
297
+
298
+
Characters `:` and `,`, are not allowed in the target attribute or tag names. Additionally, tag and attribute names must follow the conventions outlined in [Attributes and Aliasing][5].
299
+
300
+
### Reserved attributes
301
+
302
+
The Remapper processor **cannot be used to remap Datadog reserved attributes**.
303
+
- The `host` attribute cannot be remapped.
304
+
- The following attributes require dedicated remapper processors and cannot be remapped with the generic Remapper. To remap any of the attributes, use the corresponding specialized remapper or processor instead.
305
+
-`message`: Log message remapper
306
+
-`service`: Service remapper
307
+
-`status`: Log status remapper
308
+
-`date`: Log date remapper
309
+
-`trace_id`: Trace remapper
310
+
-`span_id`: Span remapper
297
311
298
312
{{< tabs >}}
299
313
{{% tab "UI" %}}
@@ -1084,7 +1098,7 @@ For detailed setup instructions, configuration examples, and troubleshooting gui
0 commit comments