Skip to content

Commit 9218cac

Browse files
authored
Add section on null maps to troubleshooting page (#4731)
1 parent 8494656 commit 9218cac

File tree

1 file changed

+19
-1
lines changed

1 file changed

+19
-1
lines changed

content/en/docs/collector/troubleshooting.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Troubleshooting
33
description: Recommendations for troubleshooting the Collector
44
weight: 25
5-
cSpell:ignore: pprof tracez zpages
5+
cSpell:ignore: confmap pprof tracez zpages
66
---
77

88
On this page, you can learn how to troubleshoot the health and performance of
@@ -359,3 +359,21 @@ container, producing the error message
359359
the `NO_WINDOWS_SERVICE=1` environment variable must be set to force the
360360
Collector to start as if it were running in an interactive terminal, without
361361
attempting to run as a Windows service.
362+
363+
### Collector is experiencing configuration issues
364+
365+
The Collector might experience problems due to configuration issues.
366+
367+
#### Null maps
368+
369+
During configuration resolution of multiple configs, values in earlier configs
370+
are removed in favor of later configs, even if the later value is null. You can
371+
fix this issue by
372+
373+
- Using `{}` to represent an empty map, such as `processors: {}` instead of
374+
`processors:`.
375+
- Omitting empty configurations such as `processors:` from the configuration.
376+
377+
See
378+
[confmap troubleshooting](https://github.com/open-telemetry/opentelemetry-collector/blob/main/confmap/README.md#null-maps)
379+
for more information.

0 commit comments

Comments
 (0)