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] Adds 7.16.0 release notes #119856

Merged
merged 31 commits into from
Dec 6, 2021
Merged

Conversation

KOTungseth
Copy link
Contributor

@KOTungseth KOTungseth commented Nov 29, 2021

Summary

Adds the release notes for the 7.16.0 release.

Preview

https://kibana_119856.docs-preview.app.elstc.co/guide/en/kibana/7.16/release-notes-7.16.0.html

@KOTungseth KOTungseth added Team:Docs release_note:skip Skip the PR/issue when compiling release notes backport:skip This commit does not require backporting v7.16.0 labels Nov 29, 2021
@KOTungseth KOTungseth self-assigned this Nov 29, 2021
@elasticmachine
Copy link
Contributor

Pinging @elastic/kibana-docs (Team:Docs)

Co-authored-by: Greg Back <1045796+gtback@users.noreply.github.com>
@gtback
Copy link
Member

gtback commented Dec 1, 2021

@elasticmachine run elasticsearch-ci/docs

@melissaburpo
Copy link
Contributor

Hi @KOTungseth, if it's not too late, I'd like to add a note about Osquery to the breaking changes section for 7.16. I've drafted it below, but please feel free to update this as needed.

[discrete]
[[breaking-107345]]
.Replaces Osquery Scheduled Query Groups with Packs
[%collapsible]
====
*Details* +
Queries are now scheduled using Packs. 
For more information, refer to {kibana-pull}107345[#107345].
*Impact* +
When you upgrade to 7.16.0, any existing Scheduled Query Groups are converted to Packs. 
Queries in the updated Packs are scheduled for the same agent policy as the original 
Scheduled Query Group. Action IDs for scheduled queries in a pack have the 
format `pack_<pack_name>_<query ID>`. 
====

Copy link
Contributor

@jportner jportner left a comment

Choose a reason for hiding this comment

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

Sorry for the late review on this!

Copy link
Contributor

@cjcenizal cjcenizal left a comment

Choose a reason for hiding this comment

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

@KOTungseth I'm seeing a missing deprecation notice for the removal of console.proxyFilter and console.proxyConfig Kibana settings (#113555). There's a release note on that PR. Could we please add that to these release notes? Thanks!

@LeeDr
Copy link

LeeDr commented Dec 2, 2021

I'm thinking we should add something else about the Upgrade Assistant and/or upgrade plans.

The only place I see mentioning the Upgrade Assistant is;
Upgrade Assistant now displays the progress of your reindexing tasks {kibana-pull}114275[#114275]

Which glosses right over the fact that the Upgrade Assistant was added in this release.

People who do find the UA, could be easily led to believe that once the critical deprecations are resolved that they can upgrade to 8.0. But they generally shouldn't try that unless it's a test system they don't care about. They can address any deprecations they see in the UA, but they should upgrade to 7.17 and use the UA again before upgrading to 8.0.
One item in particular that is not in the 7.16 UA is the system indices migration.
/cc @cjcenizal

.. Maybe we just make it clear in the 8.0 release notes that users who are upgrading should upgrade to 7.17 first.

@cjcenizal
Copy link
Contributor

@LeeDr Great point. I agree. For these release notes let's add something like this:

Upgrade Assistant

A preview release of Upgrade Assistant is available in 7.16. You can use this version of Upgrade Assistant to address deprecations in your data. We expect to add additional features in subsequent 7.x releases, which will help you prepare for your 8.0 upgrade.

Copy link
Contributor

@lcawl lcawl left a comment

Choose a reason for hiding this comment

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

ML PRs LGTM

@KOTungseth
Copy link
Contributor Author

Upgrade Assistant now displays the progress of your reindexing tasks

@LeeDr @cjcenizal each item in the release notes is tied to a PR. Is there a PR I can reference for the UA work?

For future releases, if you add the release_note:feature label, the PR will automatically be added to the Features section.

@cjcenizal
Copy link
Contributor

@KOTungseth Unfortunately, the Upgrade Assistant work was such a large change that it would be impractical to link to a representative set of PRs. We could link to all Upgrade Assistant PRs, which will help folks discover the work that went into this feature. I expect that as the Stack Management team works on larger projects we'll find ourselves in this situation more often.

FWIW I deliberately excluded the bit about reindexing from the [release note I suggested]
(#119856 (comment)), because the scope of changes extended far beyond it.

@cjcenizal
Copy link
Contributor

It just occurred to me that we plan to write a blog post on Upgrade Assistant. Would it be worth linking to this post from the release notes?

@gchaps
Copy link
Contributor

gchaps commented Dec 6, 2021

The Upgrade Assistant is also mentioned in the What's New. I think that might be the better place to link to the blog.

Copy link
Contributor

@dedemorton dedemorton left a comment

Choose a reason for hiding this comment

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

Adding a few more comments for things that I noticed when I was working on the Fleet/Agent release notes.

* Fixes blank page between loading page and overview {kibana-pull}114550[#114550]
* Fixes shard size alerts {kibana-pull}114357[#114357]
* Adds initial react app {kibana-pull}109218[#109218]
Observability::
Copy link
Contributor

Choose a reason for hiding this comment

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

Again here. @EamonnTP or @bmorelli25 should review. Some of this info just doesn't seem useful to end users, IMO.

For the Elastic Security 7.16.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
Fleet::
* Adds link to integration data retention documentation {kibana-pull}115353[#115353]
* Adds agent modal {kibana-pull}114830[#114830]
Copy link
Contributor

Choose a reason for hiding this comment

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

I'm on the fence about whether to include this one because I think it falls into the category of things users will see when they interact with the UI. If we keep it, I think we need to be more descriptive and say something like:

Adds prompt for users to add an agent if they add an integration to an agent policy with no agents

That's a mouthful, though. WDYT?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Better than what's there! Updated.

KOTungseth and others added 5 commits December 6, 2021 13:42
Co-authored-by: DeDe Morton <dede.morton@elastic.co>
Co-authored-by: DeDe Morton <dede.morton@elastic.co>
Co-authored-by: DeDe Morton <dede.morton@elastic.co>
Co-authored-by: DeDe Morton <dede.morton@elastic.co>
Co-authored-by: DeDe Morton <dede.morton@elastic.co>
@kibana-ci
Copy link
Collaborator

💚 Build Succeeded

History

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream

cc @KOTungseth

KOTungseth and others added 6 commits December 6, 2021 14:01
Co-authored-by: Brandon Morelli <bmorelli25@gmail.com>
Co-authored-by: Brandon Morelli <bmorelli25@gmail.com>
Co-authored-by: Brandon Morelli <bmorelli25@gmail.com>
Co-authored-by: Brandon Morelli <bmorelli25@gmail.com>
@kibana-ci
Copy link
Collaborator

💚 Build Succeeded

History

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream

cc @KOTungseth

@KOTungseth KOTungseth merged commit 1a063c2 into elastic:7.16 Dec 6, 2021
@KOTungseth KOTungseth deleted the docs/7.16.0-rn branch December 6, 2021 20:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport:skip This commit does not require backporting release_note:skip Skip the PR/issue when compiling release notes Team:Docs v7.16.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.