docs: add release v0.89.0-sumo-0 (#1338)

CHANGELOG.md

@@ -7,6 +7,40 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- towncrier release notes -->
 
+## [v0.89.0-sumo-0]
+
+### Released 2023-11-17
+
+See the [upgrade guide][upgrade_guide_v0.89] for more details on the breaking changes.
+
+### Breaking Changes
+
+- feat(processor/remoteobserver)!: rename `remoteobserver` processor to `remotetap` [#1333]
+- feat(exporter/sumologic)!: change default timeout from `5s` to `30s` [#1332]
+- feat(extension/sumologic)!: change `discover_collector_tags` to be `true` by default [#1330]
+
+### Added
+
+- feat(receiver/active_directory_inv): add Windows Active Directory Inventory receiver [#1273]
+- feat(opamp): Support OpAmp remote management for the opentelemetry collector, via the --remote-config flag [#1310]
+- feat(processor/sumologic): add upstream `sumologic` processor [#1334]
+
+### Changed
+
+- chore: update otel core to `v0.89.0` [#1333]
+- feat(processor/sumologicschema): deprecate `sumologic_schema` processor in favor of newly added upstream `sumologic` processor [#1334]
+
+  To migrate, simply change the name `sumologic_schema` to `sumologic` in your configuration files.
+
+[#1330]: https://github.com/SumoLogic/sumologic-otel-collector/pull/1330
+[#1273]: https://github.com/SumoLogic/sumologic-otel-collector/pull/1273
+[#1310]: https://github.com/SumoLogic/sumologic-otel-collector/pull/1310
+[#1334]: https://github.com/SumoLogic/sumologic-otel-collector/pull/1334
+[#1332]: https://github.com/SumoLogic/sumologic-otel-collector/pull/1332
+[#1333]: https://github.com/SumoLogic/sumologic-otel-collector/pull/1333
+[v0.89.0-sumo-0]: https://github.com/SumoLogic/sumologic-otel-collector/releases/v0.89.0-sumo-0
+[upgrade_guide_v0.89]: ./docs/upgrading.md#upgrading-to-v0890-sumo-0
+
 ## [v0.88.0-sumo-1]
 
 ### Released 2023-11-03

docs/upgrading.md

@@ -1,5 +1,9 @@
 # Upgrading
 
+- [Upgrading to v0.89.0-sumo-0](#upgrading-to-v0890-sumo-0)
+  - [`remoteobserver` processor: renamed to `remotetap` processor](#remoteobserver-processor-renamed-to-remotetap-processor)
+  - [`sumologic` exporter: changed default `timeout` from `5s` to `30s`](#sumologic-exporter-changed-default-timeout-from-5s-to-30s)
+  - [`sumologic` extension: changed default `discover_collector_tags` from `false` to `true`](#sumologic-extension-changed-default-discover_collector_tags-from-false-to-true)
 - [Upgrading to v0.84.0-sumo-0](#upgrading-to-v0840-sumo-0)
   - [`sumologic` extension: removed `install_token` in favor of `installation_token`](#sumologic-extension-removed-install_token-in-favor-of-installation_token)
 - [Upgrading to v0.77.0-sumo-0](#upgrading-to-v0770-sumo-0)
@@ -31,6 +35,79 @@
     - [Removing unnecessary metadata using the resourceprocessor](#removing-unnecessary-metadata-using-the-resourceprocessor)
     - [Moving record-level attributes used for metadata to the resource level](#moving-record-level-attributes-used-for-metadata-to-the-resource-level)
 
+## Upgrading to v0.89.0-sumo-0
+
+### `remoteobserver` processor: renamed to `remotetap` processor
+
+To migrate, change the processor name `remoteobserver` to `remotetap` in your configuration files.
+
+For example, given the following configuration:
+
+```yaml
+processors:
+  remoteobserver:
+    port: 1234
+  remoteobserver/another-one:
+    limit: 2
+
+pipelines:
+  logs:
+    exporters: ["..."]
+    processors:
+    - remoteobserver
+    receivers: ["..."]
+  metrics:
+    exporters: ["..."]
+    processors:
+    - remoteobserver/another-one
+    receivers: ["..."]
+```
+
+change it to:
+
+```yaml
+processors:
+  remotetap:
+    port: 1234
+  remotetap/another-one:
+    limit: 2
+
+pipelines:
+  logs:
+    exporters: ["..."]
+    processors:
+    - remotetap
+    receivers: ["..."]
+  metrics:
+    exporters: ["..."]
+    processors:
+    - remotetap/another-one
+    receivers: ["..."]
+```
+
+### `sumologic` exporter: changed default `timeout` from `5s` to `30s`
+
+We believe 30 seconds is a better default timeout for the Sumo Logic exporter.
+The bigger the payload is, the longer it takes for the Sumo Logic backend to process it.
+
+If you want to revert to the previous behavior, set the `timeout` property to `5s` or another value. Example:
+
+```yaml
+exporters:
+  sumologic:
+    timeout: 5s
+```
+
+### `sumologic` extension: changed default `discover_collector_tags` from `false` to `true`
+
+If you want to revert to the previous behavior, set the `discover_collector_tags` property to `false`. Example:
+
+```yaml
+extensions:
+  sumologic:
+    discover_collector_tags: false
+```
+
 ## Upgrading to v0.84.0-sumo-0
 
 ### `sumologic` extension: removed `install_token` in favor of `installation_token`