chore: prepare release v0.84.0-sumo-0 (#1237)

CHANGELOG.md

@@ -9,16 +9,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Released TBD
 
-### Changed
+[Unreleased]: https://github.com/SumoLogic/sumologic-otel-collector/compare/v0.84.0-sumo-0...main
+
+## [v0.84.0-sumo-0]
+
+### Released 2023-09-05
+
+### Breaking changes
 
 - feat(sumologicextension)!: remove support for `install_token` [#1225]
+
+See the [upgrade guide][upgrade_guide_v0.84] for more details.
+
+### Changed
+
 - feat(install.sh): prevent permission error when collecting host metrics [#1228]
 - chore: update otelcol core to v0.84.0 [#1235]
 
 [#1228]: https://github.com/SumoLogic/sumologic-otel-collector/pull/1228
 [#1225]: https://github.com/SumoLogic/sumologic-otel-collector/pull/1225
 [#1235]: https://github.com/SumoLogic/sumologic-otel-collector/pull/1235
-[Unreleased]: https://github.com/SumoLogic/sumologic-otel-collector/compare/v0.83.0-sumo-0...main
+[v0.84.0-sumo-0]: https://github.com/SumoLogic/sumologic-otel-collector/compare/v0.83.0-sumo-0...v0.84.0-sumo-0
+[upgrade_guide_v0.84]: ./docs/upgrading.md#upgrading-to-v0840-sumo-0
 
 ## [v0.83.0-sumo-0]
 

docs/upgrading.md

@@ -1,5 +1,7 @@
 # Upgrading
 
+- [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)
   - [Full Prometheus metric name normalization is now disabled by default](#full-prometheus-metric-name-normalization-is-now-disabled-by-default)
 - [Upgrading to v0.73.0-sumo-1](#upgrading-to-v0730-sumo-1)
@@ -29,6 +31,29 @@
     - [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.84.0-sumo-0
+
+### `sumologic` extension: removed `install_token` in favor of `installation_token`
+
+The `install_token` configuration property was deprecated in `v0.72.0-sumo-0` in February 2023 in favor of `installation_token`.
+It is now being removed in `v0.84.0-sumo-0`. To upgrade, replace `install_token` property with `installation_token` in your Sumo Logic extension configuration.
+
+For example, change this:
+
+```yaml
+extensions:
+  sumologic:
+    install_token: xyz
+```
+
+to this:
+
+```yaml
+extensions:
+  sumologic:
+    installation_token: xyz
+```
+
 ## Upgrading to v0.77.0-sumo-0
 
 ### Full Prometheus metric name normalization is now disabled by default