Skip to content

Commit 3875c9c

Browse files
committed
Clarify remapper processor
1 parent 6ffc813 commit 3875c9c

File tree

1 file changed

+19
-5
lines changed

1 file changed

+19
-5
lines changed

content/en/logs/log_configuration/processors.md

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -287,13 +287,27 @@ Use the [Datadog Log Pipeline API endpoint][1] with the following log message re
287287

288288
## Remapper
289289

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.
291291

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.
293293

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 `.`.
295295

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
297311

298312
{{< tabs >}}
299313
{{% tab "UI" %}}
@@ -1084,7 +1098,7 @@ For detailed setup instructions, configuration examples, and troubleshooting gui
10841098
[2]: /agent/logs/advanced_log_collection/?tab=configurationfile#scrub-sensitive-data-from-your-logs
10851099
[3]: /logs/log_configuration/parsing/?tab=matchers#parsing-dates
10861100
[4]: https://en.wikipedia.org/wiki/Syslog#Severity_level
1087-
[5]: /logs/log_collection/?tab=host#attributes-and-tags
1101+
[5]: /logs/log_configuration/attributes_naming_convention/
10881102
[6]: /logs/search_syntax/
10891103
[7]: /integrations/guide/reference-tables/
10901104
[8]: /tracing/other_telemetry/connect_logs_and_traces/

0 commit comments

Comments
 (0)