Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add 8.8.0 changelog #2720

Merged
merged 12 commits into from
May 24, 2023
108 changes: 108 additions & 0 deletions changelog/8.8.0.asciidoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,108 @@
// begin 8.8.0 relnotes

[[release-notes-8.8.0]]
== 8.8.0

Review important information about the 8.8.0 release.









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

The 8.8.0 release adds the following new and notable features.




* Agent Actions Signature Validation. {-pull}2348[#2348]
* Adding Cloud Defend Application To Elastic Agent. {-pull}https://github.com/elastic/elastic-agent/pull/2617[#https://github.com/elastic/elastic-agent/pull/2617] {-pull}https://github.com/elastic/elastic-agent/pull/2551[#https://github.com/elastic/elastic-agent/pull/2551]
Add support for providing the ssl key passphrase, or fleet-server service_token through a secret file.::

* Add Support For Fleet-Server Secret Files. {Add support for providing the ssl key passphrase, or fleet-server service_token through a secret file.-pull}https://github.com/elastic/elastic-agent/pull/2424[#https://github.com/elastic/elastic-agent/pull/2424]
agent::

* Feature-Flags. {agent-pull}https://github.com/elastic/elastic-agent/pull/2218[#https://github.com/elastic/elastic-agent/pull/2218] {agent-issue}https://github.com/elastic/elastic-agent/issues/2185[#https://github.com/elastic/elastic-agent/issues/2185]
+
Add support for feature flags, starting with one to toggle FQDN reporting in
events generated by Agent components, via the `host.name` field.

spec::

* Add Universal Profiling Symbolizer. {spec-pull}https://github.com/elastic/elastic-agent/pull/2401[#https://github.com/elastic/elastic-agent/pull/2401]
* Add Universal Profiling Collector. {spec-pull}https://github.com/elastic/elastic-agent/pull/2407[#https://github.com/elastic/elastic-agent/pull/2407]


[discrete]
[[enhancements-8.8.0]]
=== Enhancements




* Add Hostpath To Kubernetes Manifest To Store The Elastic Agent State. {-pull}https://github.com/elastic/elastic-agent/pull/2550[#https://github.com/elastic/elastic-agent/pull/2550]
Now the Elastic Agent logs to `logs/elastic-agent-{hash}` by default.
The upgrade watcher also logs to this folder with the `elastic-agent-watcher-[DATE]` suffix.
When collecting the logs, the diagnostics command also collects the watcher logs and the logs of
a possible new version if the agent which failed during upgrade and then it was rolled back to the
previous version.
::

* Change Default Logs Folder And Upgrade Watcher Logs Are Collected By Diagnostics Command. {Now the Elastic Agent logs to `logs/elastic-agent-{hash}` by default.
The upgrade watcher also logs to this folder with the `elastic-agent-watcher-[DATE]` suffix.
When collecting the logs, the diagnostics command also collects the watcher logs and the logs of
a possible new version if the agent which failed during upgrade and then it was rolled back to the
previous version.
-pull}https://github.com/elastic/elastic-agent/pull/2518[#https://github.com/elastic/elastic-agent/pull/2518]
agent::

* Async Download Of Elastic-Agent Upgrade Artifacts During Fleet Managed Upgrade. {agent-pull}https://github.com/elastic/elastic-agent/pull/2205[#https://github.com/elastic/elastic-agent/pull/2205]
* Make The Language Used In Cli Commands More Consistent. {agent-pull}https://github.com/elastic/elastic-agent/pull/2496[#https://github.com/elastic/elastic-agent/pull/2496]
config-manager::

* Increase Timeout, Add Config For Timeout In Fleet Setup. {config-manager-pull}https://github.com/elastic/elastic-agent/pull/2541[#https://github.com/elastic/elastic-agent/pull/2541]




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




* Fix Actions Acks Delay. {-pull}https://github.com/elastic/elastic-agent/pull/2406[#https://github.com/elastic/elastic-agent/pull/2406] {-issue}https://github.com/elastic/elastic-agent/issues/2410[#https://github.com/elastic/elastic-agent/issues/2410]
* Ensure Local Bin Directory Exists On Mac Os During Installation. {-pull}https://github.com/elastic/elastic-agent/2490[#https://github.com/elastic/elastic-agent/2490]
* Report Not Bootstrapped With Fleet-Server As An Error. {-pull}https://github.com/elastic/elastic-agent/pull/2505[#https://github.com/elastic/elastic-agent/pull/2505] {-issue}https://github.com/elastic/elastic-agent/issues/2170[#https://github.com/elastic/elastic-agent/issues/2170]
* Add Local-Config.yaml To Diagnostics And Merge Together In Inspect. {-pull}https://github.com/elastic/elastic-agent/pull/2529[#https://github.com/elastic/elastic-agent/pull/2529] {-issue}https://github.com/elastic/elastic-agent/issues/2390[#https://github.com/elastic/elastic-agent/issues/2390]
* Fix Pprof Diagnostics. {-pull}https://github.com/elastic/elastic-agent/pull/2617[#https://github.com/elastic/elastic-agent/pull/2617] {-pull}https://github.com/elastic/elastic-agent/pull/2549[#https://github.com/elastic/elastic-agent/pull/2549] {-issue}https://github.com/elastic/elastic-agent/issues/2530[#https://github.com/elastic/elastic-agent/issues/2530]
* Fix Container Service Token Path Issue. {-pull}https://github.com/elastic/elastic-agent/pull/2576[#https://github.com/elastic/elastic-agent/pull/2576]
action handlers::

* An Empty Proxy From The Policy Don't Override The Proxy Set By --Proxy-Url. {action handlers-pull}https://github.com/elastic/elastic-agent/pull/2468[#https://github.com/elastic/elastic-agent/pull/2468]
agent::

* Fix Parsing Of Paths From Container-Paths.yml File. {agent-pull}https://github.com/elastic/elastic-agent/pull/2340[#https://github.com/elastic/elastic-agent/pull/2340]
* Create Install Marker File During Upgrade From Versions < 8.8.0. {agent-pull}https://github.com/elastic/elastic-agent/pull/2655[#https://github.com/elastic/elastic-agent/pull/2655] {agent-issue}https://github.com/elastic/elastic-agent/issues/2645[#https://github.com/elastic/elastic-agent/issues/2645]
config::

* Fix System Config In Example Standalone Config File. {config-pull}https://github.com/elastic/elastic-agent/pull/2338[#https://github.com/elastic/elastic-agent/pull/2338]
diagnostics::

* Fix Diagnostic Zip File Handling Of Sub-Directories In Logs/. {diagnostics-pull}https://github.com/elastic/elastic-agent/pull/2523[#https://github.com/elastic/elastic-agent/pull/2523]
elastic-agent::

* Respecting Logging.level Settings Coming Whether From Fleet Ui Or Config File. {elastic-agent-pull}2456[#2456] {elastic-agent-issue}2450[#2450]
spec::

* Re-Add Lumberjack Input To The Filebeat Spec. {spec-pull}https://github.com/elastic/elastic-agent/pull/2511[#https://github.com/elastic/elastic-agent/pull/2511]

// end 8.8.0 relnotes
287 changes: 287 additions & 0 deletions changelog/8.8.0.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,287 @@
version: 8.8.0
entries:
- kind: enhancement
summary: async download of elastic-agent upgrade artifacts during fleet managed upgrade
AndersonQ marked this conversation as resolved.
Show resolved Hide resolved
description: ""
component: agent
pr:
- https://github.com/elastic/elastic-agent/pull/2205
issue: []
timestamp: 1674840786
file:
name: 1674840786-async-download-upgrade-artifacts.yaml
checksum: 0aa7b1bb3810df922c917dc5015b16a5a4a6d965
- kind: bug-fix
summary: Fix system config in example standalone config file
description: ""
component: config
pr:
- https://github.com/elastic/elastic-agent/pull/2338
issue: []
timestamp: 1677711770
file:
name: 1677711770-fix-standalone-system-config.yaml
checksum: ab73fc45885268717bc74899eca5d14c150a614a
- kind: bug-fix
summary: Fix parsing of paths from container-paths.yml file
description: ""
component: agent
pr:
- https://github.com/elastic/elastic-agent/pull/2340
issue: []
timestamp: 1677780422
file:
name: 1677780422-fix-container-paths-config-parsing.yaml
checksum: 99d209f37ce7d6c57d4d1d3f67016f22696faf28
- kind: feature
summary: Agent actions signature validation
description: ""
component: ""
pr:
- "2348"
issue: []
timestamp: 1678136865
file:
name: 1678136865-Agent-actions-signature-validation.yaml
checksum: 372b3c9abff7d7723e032653d46234143ac647c6
Copy link
Contributor

Choose a reason for hiding this comment

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

I think this can be removed according to Craig's comment This was disabled in https://github.com/elastic/elastic-agent/commit/ce0542fd641ea3e13d29bb2f88ea0ec403d0eed0 without removing the changelog fragment.

- kind: feature
summary: feature-flags
description: |
Add support for feature flags, starting with one to toggle FQDN reporting in
events generated by Agent components, via the `host.name` field.
component: agent
pr:
- https://github.com/elastic/elastic-agent/pull/2218
issue:
- https://github.com/elastic/elastic-agent/issues/2185
timestamp: 1679422558
file:
name: 1679422558-feature-flags.yaml
checksum: f6a2c45b76df4b708f19d25ff569ab0394403eab
Copy link
Contributor

Choose a reason for hiding this comment

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

Same here.

- kind: feature
summary: Add Universal Profiling Symbolizer
description: ""
component: spec
pr:
- https://github.com/elastic/elastic-agent/pull/2401
issue: []
timestamp: 1679899362
file:
name: 1679899362-pf-elastic-symbolizer.yaml
checksum: c73d31af40108ff1b5a0fab01168a004bb19f56f
- kind: feature
summary: Add Universal Profiling Collector
description: ""
component: spec
pr:
- https://github.com/elastic/elastic-agent/pull/2407
issue: []
timestamp: 1679986811
file:
name: 1679986811-pf-elastic-collector.yaml
checksum: c487db9995e37a1c485d0d922e4e71d62491ca00
- kind: bug-fix
summary: Fix actions acks delay
AndersonQ marked this conversation as resolved.
Show resolved Hide resolved
description: ""
component: ""
pr:
- https://github.com/elastic/elastic-agent/pull/2406
issue:
- https://github.com/elastic/elastic-agent/issues/2410
timestamp: 1680101776
file:
name: 1680101776-Fix-actions-acks-delay.yaml
checksum: 1ec1403420a07e550002cc162fdd1d92fae28dfa
- kind: feature
summary: Add support for fleet-server secret files
description: ""
component: Add support for providing the ssl key passphrase, or fleet-server service_token through a secret file.
pr:
- https://github.com/elastic/elastic-agent/pull/2424
issue: []
timestamp: 1680203080
file:
name: 1680203080-Add-support-for-fleet-server-secret-files.yaml
checksum: 0beff457a00af62876793a98b564e366ae567ed4
- kind: bug-fix
summary: Respecting logging.level settings coming whether from Fleet UI or config file.
AndersonQ marked this conversation as resolved.
Show resolved Hide resolved
description: ""
component: elastic-agent
pr:
- "2456"
issue:
- "2450"
timestamp: 1680764383
file:
name: 1680764383-Respecting-logging.level-settings.yaml
checksum: b4c689aa41884020f23848adab7b586d886c3659
- kind: bug-fix
summary: An empty proxy from the policy don't override the proxy set by --proxy-url.
AndersonQ marked this conversation as resolved.
Show resolved Hide resolved
description: ""
component: action handlers
pr:
- https://github.com/elastic/elastic-agent/pull/2468
issue: []
timestamp: 1681211832
file:
name: 1681211832-empty-proxy-from-the-policy-don't-overrides-the-proxy-set-by---proxy-url.yaml
checksum: b5edcf2189cdf6d4a3666f179333fc6398fedfcb
- kind: bug-fix
summary: Ensure local bin directory exists on Mac OS during installation.
description: |
During installation of the Elatic Agent on Mac OS ensure that the /usr/local/bin path exists before
creating the /usr/local/bin/elastic-agent symlink.
component: ""
pr:
- https://github.com/elastic/elastic-agent/2490
issue: []
timestamp: 1681311024
file:
name: 1681311024-Ensure-local-bin-directory-exists-on-Mac-OS-during-installation..yaml
checksum: 648894f466ad911ee06be9c3b4b2477fad3488bc
- kind: enhancement
summary: Make the language used in CLI commands more consistent.
description: ""
component: agent
pr:
- https://github.com/elastic/elastic-agent/pull/2496
issue: []
timestamp: 1681340196
file:
name: 1681340196-More-consistent-language-in-CLI-commands.yaml
checksum: e91dd7f091ca01562479ca131ddfa5d9503e76c9
- kind: bug-fix
summary: Report not bootstrapped with fleet-server as an error.
description: ""
component: ""
pr:
- https://github.com/elastic/elastic-agent/pull/2505
issue:
- https://github.com/elastic/elastic-agent/issues/2170
timestamp: 1681742558
file:
name: 1681742558-Report-not-bootstrapped-with-fleet-server-as-an-error.yaml
checksum: 2c601eb490be451cc5e9e022b8d82d6bc225016e
- kind: bug-fix
summary: Re-add lumberjack input to the Filebeat spec.
description: ""
component: spec
pr:
- https://github.com/elastic/elastic-agent/pull/2511
issue: []
timestamp: 1681842199
file:
name: 1681842199-re-add-lumberjack-input-spec.yaml
checksum: a0bb03fb0a7739946d631eece1dc0c5a807038e6
- kind: bug-fix
summary: Fix diagnostic zip file handling of sub-directories in logs/.
description: ""
component: diagnostics
pr:
- https://github.com/elastic/elastic-agent/pull/2523
issue: []
timestamp: 1681942680
file:
name: 1681942680-fix-diag-zip-file.yaml
checksum: ff3bd63aa3dfa8d9c7d8f708cf7d3febde4e5bae
- kind: bug-fix
summary: Add local-config.yaml to diagnostics and merge together in inspect.
AndersonQ marked this conversation as resolved.
Show resolved Hide resolved
description: ""
component: ""
pr:
- https://github.com/elastic/elastic-agent/pull/2529
issue:
- https://github.com/elastic/elastic-agent/issues/2390
timestamp: 1682005908
file:
name: 1682005908-Add-local-config.yaml-to-diagnostics-and-merge-together-in-inspect..yaml
checksum: 62a404c9dc8b45aa3d17042fa482545709ce1ac2
- kind: enhancement
summary: Increase timeout, add config for timeout in fleet setup
description: ""
component: config-manager
pr:
- https://github.com/elastic/elastic-agent/pull/2541
issue: []
timestamp: 1682117462
file:
name: 1682117462-fleet-connection-changes.yaml
checksum: e4acb525c2183d0e69eabcb6af48ebb14ce0e9e3
- kind: bug-fix
summary: fix pprof diagnostics
description: ""
component: ""
pr:
- https://github.com/elastic/elastic-agent/pull/2617
- https://github.com/elastic/elastic-agent/pull/2549
issue:
- https://github.com/elastic/elastic-agent/issues/2530
timestamp: 1682442537
file:
name: 1682442537-fix-pprof-diagnostics.yaml
checksum: 403815e914a64e726360f3a2219547faf9b8ec80
- kind: feature
summary: Adding Cloud Defend application to Elastic Agent
description: ""
component: ""
pr:
- https://github.com/elastic/elastic-agent/pull/2617
- https://github.com/elastic/elastic-agent/pull/2551
issue: []
timestamp: 1682455535
file:
name: 1682455535-Adding-Cloud-Defend-application-to-Elastic-Agent.yaml
checksum: e2c53fe2bb4dec679c2b8be1e858f02843e69538
- kind: bug-fix
summary: Fix container service token path issue
description: |
Fix issue that occurs when specifing a FLEET_SERVER_SERVICE_TOKEN_PATH with
the agent running in a Docker container where both the token value and path
are passed in the enroll section of the agent setup.
component: ""
pr:
- https://github.com/elastic/elastic-agent/pull/2576
issue: []
timestamp: 1682953274
file:
name: 1682953274-Fix-container-service-token-path-issue.yaml
checksum: 2434964330fe5268c12b60c13db26064f4678bf3
- kind: bug-fix
summary: Create install marker file during upgrade from versions < 8.8.0
description: ""
component: agent
pr:
- https://github.com/elastic/elastic-agent/pull/2655
issue:
- https://github.com/elastic/elastic-agent/issues/2645
timestamp: 1683748237
file:
name: 1683748237-upgrade-install-marker.yaml
checksum: b395497cc60dda4280483d5eaa6eaad7855223b0
AndersonQ marked this conversation as resolved.
Show resolved Hide resolved
- kind: enhancement
summary: add hostPath to Kubernetes manifest to store the Elastic Agent state
description: ""
component: ""
pr:
- https://github.com/elastic/elastic-agent/pull/2550
issue: []
timestamp: 1684747663
file:
name: 1684747663-add-hostPath-to-Kubernetes-mainfest-to-store-the-Elastic-Agent-state.yaml
checksum: fdace615a0393bc65ea3dbc805ccec2c5d38c0a6
- kind: enhancement
summary: change default logs folder and upgrade watcher logs are collected by diagnostics command
description: ""
component: |
Now the Elastic Agent logs to `logs/elastic-agent-{hash}` by default.
The upgrade watcher also logs to this folder with the `elastic-agent-watcher-[DATE]` suffix.
When collecting the logs, the diagnostics command also collects the watcher logs and the logs of
a possible new version if the agent which failed during upgrade and then it was rolled back to the
previous version.
pr:
- https://github.com/elastic/elastic-agent/pull/2518
issue: []
timestamp: 1684749098
file:
name: 1684749098-change-default-logs-folder-and-upgrade-watcher-logs-are-collected-by-diagnostics-command.yaml
checksum: e5186a6b12eda62ef6547ce245da2f3d19c8c293
Loading