From d8b3ee42e8e162f2c9d6820e1bbb686c64fff9fe Mon Sep 17 00:00:00 2001 From: David Kilfoyle Date: Mon, 3 Feb 2025 19:26:43 -0500 Subject: [PATCH 1/4] Add Fleet & Agent 8.18.0 Release Notes --- docs/en/ingest-management/index.asciidoc | 2 +- .../release-notes/release-notes-8.17.asciidoc | 2 +- .../release-notes/release-notes-8.18.asciidoc | 204 ++++++++++++++++++ 3 files changed, 206 insertions(+), 2 deletions(-) create mode 100644 docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc diff --git a/docs/en/ingest-management/index.asciidoc b/docs/en/ingest-management/index.asciidoc index 220b0ab97..aed381011 100644 --- a/docs/en/ingest-management/index.asciidoc +++ b/docs/en/ingest-management/index.asciidoc @@ -237,7 +237,7 @@ include::troubleshooting/troubleshooting.asciidoc[leveloffset=+2] include::troubleshooting/faq.asciidoc[leveloffset=+2] -include::release-notes/release-notes-8.17.asciidoc[leveloffset=+1] +include::release-notes/release-notes-8.18.asciidoc[leveloffset=+1] include::elastic-agent/install-fleet-managed-agent.asciidoc[leveloffset=+2] diff --git a/docs/en/ingest-management/release-notes/release-notes-8.17.asciidoc b/docs/en/ingest-management/release-notes/release-notes-8.17.asciidoc index 24f0255bb..23d9269a9 100644 --- a/docs/en/ingest-management/release-notes/release-notes-8.17.asciidoc +++ b/docs/en/ingest-management/release-notes/release-notes-8.17.asciidoc @@ -71,7 +71,7 @@ The 8.17.1 release Added the following new and notable features. {agent}:: * During uninstall, call the audit or unenroll API before components are stopped, if {agent} is running a {fleet-server} instance. {agent-pull}6085[#6085] {agent-issue}5752[#5752] -* Update OTel components to v0.1156.0. {agent-pull}6391[#6391] +* Update OTel components to v0.116.0. {agent-pull}6391[#6391] * Restore the `cloud-defend` binary which was accidentally removed in version 8.17.0. {agent-pull}6470[#6470] {agent-issue}6469[#6469] // end 8.17.1 relnotes diff --git a/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc b/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc new file mode 100644 index 000000000..9d448d4c6 --- /dev/null +++ b/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc @@ -0,0 +1,204 @@ +// Use these for links to issue and pulls. +:kibana-issue: https://github.com/elastic/kibana/issues/ +:kibana-pull: https://github.com/elastic/kibana/pull/ +:beats-issue: https://github.com/elastic/beats/issues/ +:beats-pull: https://github.com/elastic/beats/pull/ +:agent-libs-pull: https://github.com/elastic/elastic-agent-libs/pull/ +:agent-issue: https://github.com/elastic/elastic-agent/issues/ +:agent-pull: https://github.com/elastic/elastic-agent/pull/ +:fleet-server-issue: https://github.com/elastic/fleet-server/issues/ +:fleet-server-pull: https://github.com/elastic/fleet-server/pull/ + +[[release-notes]] += Release notes + +This section summarizes the changes in each release. + +* <> + +Also see: + +* {kibana-ref}/release-notes.html[{kib} release notes] +* {beats-ref}/release-notes.html[{beats} release notes] + +// begin 8.18.0 relnotes + +[[release-notes-8.18.0]] +== {fleet} and {agent} 8.18.0 + +Review important information about the {fleet} and {agent} 8.18.0 release. + +[discrete] +[[new-features-8.18.0]] +=== New features + +The 8.18.0 release Added the following new and notable features. + +//{fleet}:: + +{agent}:: +* Add ability to run the Elastic Distribution of OTel Collector at the same time as other inputs. {agent-pull}5767[#5767] {agent-issue}5796[#5796] +* Add a sample configuration to be used when deploying the link:https://github.com/open-telemetry/opentelemetry-helm-charts/tree/main/charts/opentelemetry-kube-stack[OpenTelemetry Kube Stack Helm Chart]. {agent-pull}5822[#5822] +* Add the GeoIP OpenTelemetry processor to {agent}. {agent-pull}6134[#6134] +* Add the metricbeat receiver to the OTel receivers included in {agent}. {agent-pull}6182[#6182] {agent-issue}6138[#6138] +* Add the link:https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/connector/routingconnector[OpenTelemetry routing connector] to the Elastic Distribution of OTel Collector. {agent-pull}6210[#6210] +* Add support for the link:https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/loadbalancingexporter[Otel loadbalancing exporter] to {agent}. {agent-pull}6315[#6315] + + +[discrete] +[[enhancements-8.18.0]] +=== Enhancements + +//{fleet}:: + +{fleet-server}:: +* Update {fleet-server} Go version to 1.23.5. {fleet-server-pull}4353[#4353] + +{agent}:: +* Re-enable the OTel subcommand on Windows. {agent-pull}6068[#6068] {agent-issue}4976[#4976] {agent-issue}5710[#5710] +* Updates the {agent} to only run composable providers if they are referenced in the agent policy. {agent-pull}6169[#6169] {agent-issue}3609[#3609] {agent-issue}4648[#4648] +* Add a flag to skip {fleet} audit or unenroll when uninstalling {agent}. {agent-pull}6206[#6206] {agent-issue}5757[#5757] +* Embed hints-based inputs in the {agent} Kubernetes container image. {agent-pull}6381[#6381] {agent-issue}5661[#5661] + +[discrete] +[[bug-fixes-8.18.0]] +=== Bug fixes + +//{fleet}:: + +//{fleet-server}:: + +{agent}:: +* Prevent installation of {elastic-defend} in emulated environment, in which it's not supported. {agent-pull}6095[#6095] {agent-issue}6082[#6082] +* Re-enable notifying {fleet} when [agent] is uninstalled on Windows. {agent-pull}6257[#6257] {agent-issue}5952[#5952] +* Log a warning on same version upgrade attempts and prevent the agent from reporting a failed upgrade state. {agent-pull}6273[#6273] {agent-issue}6186[#6186] +* Add retries for requesting download verifiers when upgrading an agent. {agent-pull}6276[#6276] {agent-issue}5163[#5163] + + +// end 8.18.0 relnotes + +// --------------------- +//TEMPLATE +//Use the following text as a template. Remember to replace the version info. + +// begin 8.7.x relnotes + +//[[release-notes-8.7.x]] +//== {fleet} and {agent} 8.7.x + +//Review important information about the {fleet} and {agent} 8.7.x release. + +//[discrete] +//[[security-updates-8.7.x]] +//=== Security updates + +//{fleet}:: +//* add info + +//{agent}:: +//* add info + +//[discrete] +//[[breaking-changes-8.7.x]] +//=== Breaking changes + +//Breaking changes can prevent your application from optimal operation and +//performance. Before you upgrade, review the breaking changes, then mitigate the +//impact to your application. + +//[discrete] +//[[breaking-PR#]] +//.Short description +//[%collapsible] +//==== +//*Details* + +// For more information, refer to {kibana-pull}PR[#PR]. + +//*Impact* + +// For more information, refer to {fleet-guide}/fleet-server.html[Fleet Server]. +//==== + +//[discrete] +//[[notable-changes-8.13.0]] +//=== Notable changes + +//The following are notable, non-breaking updates to be aware of: + +//* Changes to features that are in Technical Preview. +//* Changes to log formats. +//* Changes to non-public APIs. +//* Behaviour changes that repair critical bugs. + +//{fleet}:: +//* add info + +//{agent}:: +//* add info + +//[discrete] +//[[known-issues-8.7.x]] +//=== Known issues + +//[[known-issue-issue#]] +//.Short description +//[%collapsible] +//==== + +//*Details* + +// + +//*Impact* + + +// + +//==== + +//[discrete] +//[[deprecations-8.7.x]] +//=== Deprecations + +//The following functionality is deprecated in 8.7.x, and will be removed in +//8.7.x. Deprecated functionality does not have an immediate impact on your +//application, but we strongly recommend you make the necessary updates after you +//upgrade to 8.7.x. + +//{fleet}:: +//* add info + +//{agent}:: +//* add info + +//[discrete] +//[[new-features-8.7.x]] +//=== New features + +//The 8.7.x release Added the following new and notable features. + +//{fleet}:: +//* add info + +//{agent}:: +//* add info + +//[discrete] +//[[enhancements-8.7.x]] +//=== Enhancements + +//{fleet}:: +//* add info + +//{agent}:: +//* add info + +//[discrete] +//[[bug-fixes-8.7.x]] +//=== Bug fixes + +//{fleet}:: +//* add info + +//{agent}:: +//* add info + +// end 8.7.x relnotes From 1f7ff8a78fe671d3206ab76e9c77e377f7da0989 Mon Sep 17 00:00:00 2001 From: David Kilfoyle Date: Tue, 4 Feb 2025 11:23:27 -0500 Subject: [PATCH 2/4] Add second batch --- .../release-notes/release-notes-8.18.asciidoc | 21 +++++++++++++------ 1 file changed, 15 insertions(+), 6 deletions(-) diff --git a/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc b/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc index 9d448d4c6..d5df0f2a9 100644 --- a/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc +++ b/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc @@ -43,7 +43,12 @@ The 8.18.0 release Added the following new and notable features. * Add the metricbeat receiver to the OTel receivers included in {agent}. {agent-pull}6182[#6182] {agent-issue}6138[#6138] * Add the link:https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/connector/routingconnector[OpenTelemetry routing connector] to the Elastic Distribution of OTel Collector. {agent-pull}6210[#6210] * Add support for the link:https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/loadbalancingexporter[Otel loadbalancing exporter] to {agent}. {agent-pull}6315[#6315] - +* Add a new Kubernetes deployment of the Elastic Distribution of OTel Collector named "gateway", to simplify the daemonset collector configuration and unify managed/self-managed scenarios. {agent-pull}6444[#6444] +* Add the `components` command for {agent} in OTel mode, to list the supported components the the Elastic Distribution of OTel Collector includes. {agent-pull}6539[#6539] +* Add the `receivercreator` and `k8sobserver` components to the Elastic Distribution of OTel Collector to help cover autodiscovery scenarios in Kubernetes. {agent-pull}6561[#6561] +* Add the `kafkaexporter` and `kafkareceiver` the Elastic Distribution of OTel Collector to help prepare support for a Kafka output. {agent-pull}6539[#6539] {agent-issue}6562[#6562] +* Add the nopreceiver to the Elastic Distribution of OTel Collector. {agent-pull}6603[#6603] +* Change the default gRPC port to 0 when {agent} is run in a container. {agent-pull}6585[#6585] [discrete] [[enhancements-8.18.0]] @@ -56,9 +61,12 @@ The 8.18.0 release Added the following new and notable features. {agent}:: * Re-enable the OTel subcommand on Windows. {agent-pull}6068[#6068] {agent-issue}4976[#4976] {agent-issue}5710[#5710] -* Updates the {agent} to only run composable providers if they are referenced in the agent policy. {agent-pull}6169[#6169] {agent-issue}3609[#3609] {agent-issue}4648[#4648] +* Update the {agent} to only run composable providers if they are referenced in the agent policy. {agent-pull}6169[#6169] {agent-issue}3609[#3609] {agent-issue}4648[#4648] * Add a flag to skip {fleet} audit or unenroll when uninstalling {agent}. {agent-pull}6206[#6206] {agent-issue}5757[#5757] -* Embed hints-based inputs in the {agent} Kubernetes container image. {agent-pull}6381[#6381] {agent-issue}5661[#5661] +* Embed hints-based inputs in the {agent} Kubernetes container image. {agent-pull}6381[#6381] {agent-issue}5661[#5661] +* Add an error to the Windows Application Event Log if the `install`, `uninstall`, or `enroll` commands fail. {agent-pull}6410[#6410] {agent-issue}6338[#6338] +* Add a logger to print the status and code when an {agent} enrollment call to {fleet} fails. {agent-pull}6477[#6477] {agent-issue}6287[#6287] +* Update OTel components to v0.117.0. {agent-pull}6499[#6499] [discrete] [[bug-fixes-8.18.0]] @@ -66,14 +74,15 @@ The 8.18.0 release Added the following new and notable features. //{fleet}:: -//{fleet-server}:: - {agent}:: * Prevent installation of {elastic-defend} in emulated environment, in which it's not supported. {agent-pull}6095[#6095] {agent-issue}6082[#6082] * Re-enable notifying {fleet} when [agent] is uninstalled on Windows. {agent-pull}6257[#6257] {agent-issue}5952[#5952] * Log a warning on same version upgrade attempts and prevent the agent from reporting a failed upgrade state. {agent-pull}6273[#6273] {agent-issue}6186[#6186] * Add retries for requesting download verifiers when upgrading an agent. {agent-pull}6276[#6276] {agent-issue}5163[#5163] - +* Replace `list` with `items` from from `kibanaFetchToken` as `list` is deprecated in the API response and will be removed. {agent-pull}6437[#6437] {agent-issue}6023[#6023] +* Restore `cloud-defend` as an expected binary after it was accidentally removed from containers in 8.17.0 and later versions. {agent-pull}6470[#6470] {agent-issue}6469[#6469] +* Restore the `maintainer` label for container images rather than the default inherited from a base image. {agent-pull}6512[#6512] +* Fix enrollment for containerised {agent} when the enrollment token changes or the agent is unenrolled. {agent-pull}6568[#6568] {agent-issue}3586[#3586] // end 8.18.0 relnotes From 936d9c02a3d4857d8ef73577402fcd9c26544934 Mon Sep 17 00:00:00 2001 From: David Kilfoyle Date: Thu, 13 Feb 2025 17:51:52 -0500 Subject: [PATCH 3/4] fix PR link --- .../ingest-management/release-notes/release-notes-8.18.asciidoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc b/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc index d5df0f2a9..6fc558c14 100644 --- a/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc +++ b/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc @@ -46,7 +46,7 @@ The 8.18.0 release Added the following new and notable features. * Add a new Kubernetes deployment of the Elastic Distribution of OTel Collector named "gateway", to simplify the daemonset collector configuration and unify managed/self-managed scenarios. {agent-pull}6444[#6444] * Add the `components` command for {agent} in OTel mode, to list the supported components the the Elastic Distribution of OTel Collector includes. {agent-pull}6539[#6539] * Add the `receivercreator` and `k8sobserver` components to the Elastic Distribution of OTel Collector to help cover autodiscovery scenarios in Kubernetes. {agent-pull}6561[#6561] -* Add the `kafkaexporter` and `kafkareceiver` the Elastic Distribution of OTel Collector to help prepare support for a Kafka output. {agent-pull}6539[#6539] {agent-issue}6562[#6562] +* Add the `kafkaexporter` and `kafkareceiver` the Elastic Distribution of OTel Collector to help prepare support for a Kafka output. {agent-pull}6593[#6593] {agent-issue}6562[#6562] * Add the nopreceiver to the Elastic Distribution of OTel Collector. {agent-pull}6603[#6603] * Change the default gRPC port to 0 when {agent} is run in a container. {agent-pull}6585[#6585] From ea5223a4821fee99341d01985c9d4e57969de87e Mon Sep 17 00:00:00 2001 From: David Kilfoyle Date: Thu, 6 Mar 2025 14:17:25 -0500 Subject: [PATCH 4/4] Add BC4 agent item --- .../release-notes/release-notes-8.18.asciidoc | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc b/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc index 6fc558c14..1a67af91b 100644 --- a/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc +++ b/docs/en/ingest-management/release-notes/release-notes-8.18.asciidoc @@ -34,7 +34,10 @@ Review important information about the {fleet} and {agent} 8.18.0 release. The 8.18.0 release Added the following new and notable features. -//{fleet}:: +{fleet}:: +* Add next steps and actions to the agentless integrations flyout. ({kibana-pull}203824[#203824]) +* Add support for columns when exporting agents to CSV. ({kibana-pull}203103[#203103]) +* Add status tracking for agentless integrations. ({kibana-pull}199567[#199567]) {agent}:: * Add ability to run the Elastic Distribution of OTel Collector at the same time as other inputs. {agent-pull}5767[#5767] {agent-issue}5796[#5796] @@ -54,7 +57,8 @@ The 8.18.0 release Added the following new and notable features. [[enhancements-8.18.0]] === Enhancements -//{fleet}:: +{fleet}:: +* Enable sub-feature privileges for {fleet}. ({kibana-pull}203182[#203182]) {fleet-server}:: * Update {fleet-server} Go version to 1.23.5. {fleet-server-pull}4353[#4353] @@ -72,7 +76,13 @@ The 8.18.0 release Added the following new and notable features. [[bug-fixes-8.18.0]] === Bug fixes -//{fleet}:: +{fleet}:: +* Support `is_default` on integration deployment modes. ({kibana-pull}208284[#208284]) +* Fix a UI error caused when an agent becomes orphan. ({kibana-pull}207746[#207746]) +* Restrict non-local {es} output types for agentless integrations and policies. ({kibana-pull}207296[#207296]) +* Fix API code to prevent bulk actions from timing out. ({kibana-pull}205735[#205735]) +* Fix generation of dynamic mapping for objects with specific subfields. ({kibana-pull}204104[#204104]) +* Fix logic to ensure that agents are only considered stuck in updating when an upgrade fails. ({kibana-pull}202126[#202126]) {agent}:: * Prevent installation of {elastic-defend} in emulated environment, in which it's not supported. {agent-pull}6095[#6095] {agent-issue}6082[#6082] @@ -83,6 +93,7 @@ The 8.18.0 release Added the following new and notable features. * Restore `cloud-defend` as an expected binary after it was accidentally removed from containers in 8.17.0 and later versions. {agent-pull}6470[#6470] {agent-issue}6469[#6469] * Restore the `maintainer` label for container images rather than the default inherited from a base image. {agent-pull}6512[#6512] * Fix enrollment for containerised {agent} when the enrollment token changes or the agent is unenrolled. {agent-pull}6568[#6568] {agent-issue}3586[#3586] +* Change how Windows process handles are obtained when assigning sub-processes to Job objects. {agent-pull}6825[#6825] // end 8.18.0 relnotes