Skip to content
2 changes: 1 addition & 1 deletion docs/en/ingest-management/index.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -233,7 +233,7 @@ include::troubleshooting/troubleshooting.asciidoc[leveloffset=+2]

include::troubleshooting/faq.asciidoc[leveloffset=+2]

include::release-notes/release-notes-8.16.asciidoc[leveloffset=+1]
include::release-notes/release-notes-8.17.asciidoc[leveloffset=+1]

include::elastic-agent/install-fleet-managed-agent.asciidoc[leveloffset=+2]

Expand Down
218 changes: 218 additions & 0 deletions docs/en/ingest-management/release-notes/release-notes-8.17.asciidoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,218 @@
// 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.

* <<release-notes-8.17.0>>

Also see:

* {kibana-ref}/release-notes.html[{kib} release notes]
* {beats-ref}/release-notes.html[{beats} release notes]

// begin 8.17.0 relnotes

[[release-notes-8.17.0]]
== {fleet} and {agent} 8.17.0

Review important information about the {fleet} and {agent} 8.17.0 release.

[discrete]
[[breaking-changes-8.17.0]]
=== 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.

{agent}::
* Install images for {agent} on Debian 10 systems are no longer being made available. Debian 11 is now supported instead. {agent-pull}5847[#5847]
Comment thread
kilfoyle marked this conversation as resolved.
Outdated

[discrete]
[[new-features-8.17.0]]
=== New features

The 8.17.0 release Added the following new and notable features.

{fleet}::
* Expose advanced file logging configuration in the UI. {kibana-pull}200274[#200274]

{agent}::
* Add support for pre-existing Active Directory user for unprivileged mode. {agent-pull}5988[#5988] {agent-issue}4585[#4585]
Comment thread
kilfoyle marked this conversation as resolved.
Outdated
* Add support for the Filestream integration. This will enable migration from the custom log integration which is based on a log input that is planned for deprecation. https://github.com/elastic/integrations/pull/11332[#11332]

@kilfoyle kilfoyle Dec 11, 2024

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This "Filestream integration" one doesn't appear in the Elastic Agent changelog, since the change is from the integrations repo, but it's mentioned in Nima's 8.17 feature release summary so I've included it here.

Comment thread
kilfoyle marked this conversation as resolved.
Outdated

[discrete]
[[enhancements-8.17.0]]
=== Enhancements

{fleet}::
* Filter the integrations/packages list shown in the UI depending on the `policy_templates_behavior` field. {kibana-pull}200605[#200605]
* Add a `<type>@custom` component template to integrations index template's `composed_of` array. {kibana-pull}192731[#192731]

{fleet-server}::
* Update `elastic-agent-libs` to version `0.14.0`. {fleet-server-pull}4042[#4042]

{agent}::
* Enable persistence in the configuration provided with our OTel Collector distribution. {agent-pull}5549[#5549]
* Add Filebeat as a receiver for {agent} running in OTel mode. {agent-pull}5833[#5833]
Comment thread
kilfoyle marked this conversation as resolved.
Outdated
* Restrict using the CLI to upgrade {fleet}-managed {agents}. With this implementation, upgrading a {fleet}-managed agent using the CLI is supported only if the agent is running in privileged mode and the user provides a `force` flag. {agent-pull}5864[#5864] {agent-issue}4890[#4890]
Comment thread
kilfoyle marked this conversation as resolved.
Outdated
* Add `os_family`, `os_platform` and `os_version` to the {agent} host provider, enabling differentiating Linux distributions. This is required to support Debian 12 and other distributions that are moving away from traditional log files in favour of Journald. {agent-pull}5941[#5941] https://github.com/elastic/integrations/issues/10797[10797] https://github.com/elastic/integrations/pull/11618[11618]
* Emit Pod data only for Pods that are running in the Kubernetes provider. {agent-pull}6011[#6011] {agent-issue}5835[#5835] {agent-issue}5991[#5991]
* Remove {endpoint-sec} from Linux container images. {endpoint-sec} cannot run in containers since it has a systemd dependency. {agent-pull}6016[#6016] {agent-issue}5495[#5495]
* Update the outdated Kubernetes composable provider README. {agent-pull}5990[#5990]
Comment thread
kilfoyle marked this conversation as resolved.
Outdated
* Update OTel components to v0.114.0. {agent-pull}6113[#6113]
* Redact common secrets like API keys and passwords in the output from `elastic-agent inspect` command. {agent-pull}6224[#6224]

[discrete]
[[bug-fixes-8.17.0]]
=== Bug fixes

{fleet}::
* Allow creation of an integration policy with no agent policies. {kibana-pull}201051[#201051]

{fleet-server}::
* Fix `server.address` field which was appearing empty in HTTP request logs. {fleet-server-pull}4142[#4142]
* Remove a race condition that may occur when remote ES outputs are used. {fleet-server-pull}4171[#4171] {fleet-server-pull}4170[#4170]

{agent}::
* Make redaction of common keys in diagnostics case insensitive. {agent-pull}6109[#6109]


// end 8.17.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* +
//<Describe new behavior.> For more information, refer to {kibana-pull}PR[#PR].

//*Impact* +
//<Describe how users should mitigate the change.> 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*

//<Describe known issue.>

//*Impact* +

//<Describe impact or workaround.>

//====

//[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