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.

Sign up for GitHub

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

Add Feature Flag page with new FQDN setting #2817

Merged
merged 8 commits into from
Apr 6, 2023
Merged

Add Feature Flag page with new FQDN setting #2817

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
0892c27
Add Feature Flag page with new FQDN setting
kilfoyle Mar 31, 2023
5010a3f
Fix up host.name description
kilfoyle Apr 3, 2023
309d049
Touchup
kilfoyle Apr 3, 2023
4d95589
Fix up the feature flag description
kilfoyle Apr 3, 2023
38f2b70
Add FQDN prereqs
kilfoyle Apr 3, 2023
f628c0a
touchup
kilfoyle Apr 3, 2023
cd78011
Update docs/en/ingest-management/elastic-agent/configuration/elastic-…
kilfoyle Apr 3, 2023
dbebee5
Revert rephrasing of feature flag intro cd78011
kilfoyle Apr 4, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions ...nagement/elastic-agent/configuration/elastic-agent-standalone-features.asciidoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
[[elastic-agent-standalone-feature-flags]]
= Configure feature flags for standalone {agent}s

++++
<titleabbrev>Feature flags</titleabbrev>
++++

include::{fleet-repo-dir}/standalone-note.asciidoc[]

The Feature Flags section of the `elastic-agent.yml` config file contains settings in {agent} that are disabled by default. Having these settings behind a feature flag prevents accidentally exposing any breaking changes that might be inconsistent with the naming formats expected in your configured {agent} output.
kilfoyle marked this conversation as resolved.
Show resolved Hide resolved

To enable any of the settings listed on this page, change the associated `enabled` flag from `false` to `true`.

[source,yaml]
----
agent.features:
mysetting:
enabled: true
----

[discrete]
[[elastic-agent-standalone-feature-flag-settings]]
== Feature flag configuration settings

You can specify the following settings in the Feature Flag section of the
`elastic-agent.yml` config file.

Fully qualified domain name (FQDN)::
When enabled, information provided about the current host through the <<host-provider,host.name>> key, in events produced by {agent}, is in FQDN format (`somehost.example.com` rather than `somehost`). This helps you to distinguish between hosts on different domains that have similar names. With `fqdn` enabled, the fully qualified hostname allows each host to be more easily identified when viewed in {kib}.
+
To enable fully qualified domain names set `enabled: true` for the `fqdn` setting:
+
["source","yaml",subs="attributes"]
----
agent.features:
fqdn:
enabled: true
----
kilfoyle marked this conversation as resolved.
Show resolved Hide resolved
2 changes: 2 additions & 0 deletions docs/en/ingest-management/index.asciidoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -155,6 +155,8 @@ include::elastic-agent/configuration/authentication/ssl-settings.asciidoc[levelo

include::elastic-agent/configuration/elastic-agent-standalone-logging.asciidoc[leveloffset=+2]

include::elastic-agent/configuration/elastic-agent-standalone-features.asciidoc[leveloffset=+2]

include::elastic-agent/configuration/autodiscovery/elastic-agent-kubernetes-autodiscovery.asciidoc[leveloffset=+2]

include::elastic-agent/configuration/autodiscovery/kubernetes-conditions-autodiscover.asciidoc[leveloffset=+3]
Expand Down