diff --git a/docs/send-data/opentelemetry-collector/troubleshooting.md b/docs/send-data/opentelemetry-collector/troubleshooting.md index 7612ac3722..854d2759fe 100644 --- a/docs/send-data/opentelemetry-collector/troubleshooting.md +++ b/docs/send-data/opentelemetry-collector/troubleshooting.md @@ -282,3 +282,61 @@ The other problem is that it is not currently possible for Filelog receiver to s There is currently no workaround for this. [filelogreceiver_docs]: https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/v0.71.0/receiver/filelogreceiver/README.md + +### Collector name not updating after configuration change for locally managed collectors + +Starting from **Sumo Logic OpenTelemetry Collector version `0.137.0-sumo-0`**, changing the `extensions.sumologic.collector.name` property in the configuration file **does not automatically update** the locally managed collector name upon restart. + +#### Cause +The collector retains the previous name from the local credentials file and does not regenerate it unless the credentials are removed. + +#### Resolution +To apply the new collector name after modifying the configuration: + +1. **Stop** the collector. +2. **Delete all files in the local credentials directory** (path differs by OS). +3. **Start** the collector again. + + +#### Example commands + + + + + +```bash +sudo systemctl stop otelcol-sumo +sudo rm /var/lib/otelcol-sumo/credentials/* +sudo systemctl start otelcol-sumo +``` + + + + + +```powershell +net stop otelcol-sumo +Remove-Item "C:\ProgramData\Sumo Logic\OpenTelemetry Collector\data\credentials\*" -Force +net start otelcol-sumo +``` + + + + + +```bash +sudo launchctl unload /Library/LaunchDaemons/com.sumologic.otelcol-sumo.plist +sudo rm /var/lib/otelcol-sumo/credentials/* +sudo launchctl load /Library/LaunchDaemons/com.sumologic.otelcol-sumo.plist +``` + + + +