[DOCS] Updates add data content #81093

gchaps · 2020-10-20T00:15:16Z

This PR updates the "Add Data" content to include content for Fleet.

Preview: https://kibana_81093.docs-preview.app.elstc.co/guide/en/kibana/master/connect-to-elasticsearch.html

gchaps · 2020-10-20T14:59:07Z

@dedemorton Can I please get your input on the "Add data" and "Add Elastic Agent" sections?

dedemorton · 2020-10-20T17:09:18Z

docs/setup/connect-to-elasticsearch.asciidoc


-* Upload a CSV, JSON, or log file with the File Data Visualizer.
+* Add data from popular apps and services
+* Add data using an Elastic Agent


Not exactly clear how line 7 is different from line 8 (Elastic Agent is the new way of adding data from popular apps and services, no?)

I'd also indicate here that this is beta

dedemorton · 2020-10-20T17:17:41Z

docs/setup/connect-to-elasticsearch.asciidoc

+[role="screenshot"]
+image::images/add-data-tutorials.png[Add Data tutorials]
+
+


Might be worth stating explicitly somewhere that Elastic Agent is an alternative to installing and managing Beats individually. I think there will be some confusion for users because Elastic Agent installs and manages Beats under the hood. We really want that to be an implementation detail that most users don't need to know about, though.

dedemorton · 2020-10-20T17:22:43Z

docs/setup/connect-to-elasticsearch.asciidoc

+
+beta[]
+
+Fleet is a single, unified way to collect logs and metrics from systems


This description blurs the lines between Fleet and agent. Agent is how you collect logs/metrics. Fleet is the UI you use to add and manage agents. You might want to look at the Fleet overview (thought honestly I want to rework that because it's a bit disjointed). https://www.elastic.co/guide/en/ingest-management/7.10/fleet-overview.html

dedemorton · 2020-10-20T17:28:42Z

docs/setup/connect-to-elasticsearch.asciidoc

+beta[]
+
+Fleet is a single, unified way to collect logs and metrics from systems
+and services across your organization. You don't have to install multiple


"You don't have to" makes it sound like this is optional.

Maybe: "Instead of installing multiple agents on each host you want to monitor, you install a single agent that manages data collection, making it easier to deploy policies across your infrastructure."

(Kind of wordy and I'm not sure users will understand what a policy is at this point, but hopefully you see my point.)

dedemorton · 2020-10-20T17:32:07Z

@gchaps One thing we need to be aware of: I don't think we are recommending that users try this in a production environment. Check with @ph to be sure.

ph · 2020-10-21T13:29:14Z

Correct we recommend a testing/dev environment.

elasticmachine · 2020-10-22T21:28:30Z

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

nreese · 2020-10-22T21:33:04Z

docs/setup/connect-to-elasticsearch.asciidoc


-To start working with your data in {kib}, you can:
+The fastest way to add data to {kib} is to use one of the built-in options.


One comment about "add data to Kibana". This statement is a little technically misleading. Kibana does not store data so you never add data to kibana. You add data to Elasticsearch or the Elastic stack. Sometimes you add data by using kibana like with sample data or file upload.

nreese · 2020-10-22T21:38:32Z

docs/setup/connect-to-elasticsearch.asciidoc

 <<kibana-ml-settings, Advanced Settings>>.

 [role="screenshot"]
 image::images/add-data-fv.png[File Data Visualizer]

-The File Data Visualizer uses the {ref}/ml-find-file-structure.html[find_file_structure API] to analyze
-the uploaded file and to suggest ingest pipelines and mappings for your data.
+For geospatial data, you can use the File Data Visualizer or the


I don't think you need to call out File Data Visualizer or GeoJSon Uploader. How about just changing to "See <<import-geospatial-data, Import geospatial data>> for uploading files with geospatial data."

alexfrancoeur

Dropped in a few comments, let me know what you think @gchaps !

alexfrancoeur · 2020-10-26T17:23:11Z

docs/setup/connect-to-elasticsearch.asciidoc

@@ -1,108 +1,75 @@
 [[connect-to-elasticsearch]]
 == Add data to {kib}


Similar to the comment from Nathan, should we simply have "Add data" here to avoid confusion?

alexfrancoeur · 2020-10-26T17:29:06Z

docs/setup/connect-to-elasticsearch.asciidoc

-If you're not ready to use your own data, you can add a <<get-started, sample data set>>
-to see all that you can do in {kib}.
+[discrete]
+=== Add Elastic Agent


I think the split between add data and add Elastic agent is fine now, because we have them in product. We'll have to work with @mostlyjason on when we can begin to default to agent and remove add data from the docs (similarly to how we did with Lens) and eventually, product

These two things are very similar, integrations with Agent + Fleet are the next generation of modules. I wonder if we can spin this in a way with "get a sneak peak of where we're going with.." or something along those lines.

alexfrancoeur · 2020-10-26T18:41:42Z

docs/setup/connect-to-elasticsearch.asciidoc

-[[upload-data-kibana]]
-=== Upload a CSV, JSON, or log file
+beta[] *Elastic Agent* is a centralized way to set up your data integrations.
+With the *Fleet* UI, you can add


Should we just say with "Fleet" instead of "Fleet UI"?

alexfrancoeur · 2020-10-26T18:43:22Z

docs/setup/connect-to-elasticsearch.asciidoc


-To start working with your data in {kib}, you can:
+The fastest way to add data to {kib} is to use one of the built-in options.


Thoughts on replacing "use one of our built in options" with "one of our many ingest options"?

alexfrancoeur · 2020-10-26T18:46:26Z

docs/setup/connect-to-elasticsearch.asciidoc

-Beats data shipper to periodically collect and send data to {es}.
-You can then use the pre-built dashboards to explore and analyze the data.
+[discrete]
+=== Custom options for loading your data


Thoughts on using "Additional options for loading your data"? or "Options for loading your custom data"

alexfrancoeur · 2020-10-26T18:46:57Z

docs/setup/connect-to-elasticsearch.asciidoc

-You access the tutorials from the home page.
-If a tutorial doesn’t exist for your data, go to the {beats-ref}/beats-reference.html[Beats overview]
-to learn about other data shippers in the Beats family.
+If the built-in options don't work for you, you can index your


Similar to my comment above, thoughts on replacing "If the built-in options don't work for you" with "If one of our multiple ingest options don't work for you"?

alexfrancoeur · 2020-10-26T18:48:21Z

docs/setup/connect-to-elasticsearch.asciidoc

-+
-When searching in *Discover* and creating visualizations, you choose a pattern
-from the index pattern menu to specify the {es} indices that contain the data you want to explore.
+* To add data for Elastic Observability, see {observability-guide}/add-observability-data.html[Send data to Elasticsearch].


Probably another discussion, but a common naming convention and framework for ingestion "How to's" might make it easier to consume for our end users.

alexfrancoeur · 2020-10-26T18:48:48Z

docs/setup/connect-to-elasticsearch.asciidoc

 <<kibana-ml-settings, Advanced Settings>>.

 [role="screenshot"]
 image::images/add-data-fv.png[File Data Visualizer]

-The File Data Visualizer uses the {ref}/ml-find-file-structure.html[find_file_structure API] to analyze
-the uploaded file and to suggest ingest pipelines and mappings for your data.
+For geospatial data, you can use the File Data Visualizer or the


dedemorton

It's looking good...just one minor correction to your note.

dedemorton · 2020-10-26T18:48:53Z

docs/setup/connect-to-elasticsearch.asciidoc


-*Data Visualizer*.
+NOTE: This feature is not intended for use as part of a


Not sure I like this note because it's a little misleading. Eventually it will be the main way to ingest data, but right now, it's not recommended in a production environment. Maybe qualify it by saying, "The beta release of this feature...."

dedemorton · 2020-10-26T18:50:56Z

docs/setup/connect-to-elasticsearch.asciidoc


-To start working with your data in {kib}, you can:
+The fastest way to add data to {kib} is to use one of the built-in options.


…dd-fleet

nreese

LGTM

KOTungseth · 2020-10-29T21:26:23Z

docs/setup/connect-to-elasticsearch.asciidoc

@@ -1,108 +1,73 @@
 [[connect-to-elasticsearch]]
-== Add data to {kib}
+== Add data


It is confusing that this line and line 18 are both Add data.

docs/setup/connect-to-elasticsearch.asciidoc

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

* [DOCS] Updates add data content * [DOCS] Incorporated review comments * [DOCS] Adds content for geojson upload * [DOCS] Fixes link * [DOCS] Incorporates review comments * [DOCS] Minor edits * Update docs/setup/connect-to-elasticsearch.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/setup/connect-to-elasticsearch.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/setup/connect-to-elasticsearch.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/setup/connect-to-elasticsearch.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/setup/connect-to-elasticsearch.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> # Conflicts: # docs/setup/connect-to-elasticsearch.asciidoc

* master: Add derivative function (elastic#81178) [Discover] Deangularize context_app.html, part 3 (elastic#81838) [Visualize] Vis listing page breaks on unknown vis type (elastic#82018) Rename `batchSize` parameter to `batch_size` to be consisten with the API namings guidelines. (elastic#82123) Minor edits in Single Metric Viewer (elastic#82159) [Actions] Fix type contract (elastic#82168) Upgrade EUI to v30.1.1 (elastic#81499) Skip failing ES snapshot test (elastic#82207) Skip ES snapshot failing suite (elastic#82206) [Alerting UI] Grouped list of alert types using producers in Types filter of Alerts tab (elastic#81876) [Maps] convert vector style component to typescript round 1 (elastic#81961) Fix link to upgrade assistant (elastic#82138) Rename "service overview" to "service inventory" (elastic#81933) adjust policy test to drop test for server addresses (elastic#82120) Cleanup/codeowners (elastic#82146) [DOCS] Updates add data content (elastic#81093) [DOCS] Remove index mgmt docs (elastic#82099) [Search] fix cancelation related memory leaks (elastic#81996)

[DOCS] Updates add data content

2938e3e

gchaps added Team:Docs v8.0.0 release_note:skip Skip the PR/issue when compiling release notes v7.10.0 v7.11.0 labels Oct 20, 2020

dedemorton reviewed Oct 20, 2020

View reviewed changes

gchaps and others added 4 commits October 21, 2020 10:59

[DOCS] Incorporated review comments

b862531

[DOCS] Adds content for geojson upload

0457d09

[DOCS] Fixes link

7f06994

Merge branch 'master' into docs/add-fleet

ad122d0

gchaps marked this pull request as ready for review October 22, 2020 21:28

gchaps requested review from nreese and alexfrancoeur October 22, 2020 21:28

nreese reviewed Oct 22, 2020

View reviewed changes

alexfrancoeur reviewed Oct 26, 2020

View reviewed changes

dedemorton reviewed Oct 26, 2020

View reviewed changes

gchaps added 2 commits October 26, 2020 16:57

[DOCS] Incorporates review comments

3717987

Merge branch 'docs/add-fleet' of github.com:gchaps/kibana into docs/a…

0be0960

…dd-fleet

nreese approved these changes Oct 27, 2020

View reviewed changes

[DOCS] Minor edits

1d6e585

gchaps requested a review from KOTungseth October 29, 2020 15:40

KOTungseth reviewed Oct 29, 2020

View reviewed changes

gchaps and others added 3 commits October 29, 2020 14:32

Update docs/setup/connect-to-elasticsearch.asciidoc

b9e7e54

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/setup/connect-to-elasticsearch.asciidoc

572a496

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/setup/connect-to-elasticsearch.asciidoc

e845479

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

gchaps and others added 2 commits October 29, 2020 14:32

Update docs/setup/connect-to-elasticsearch.asciidoc

ec19d62

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

Update docs/setup/connect-to-elasticsearch.asciidoc

a3a1481

Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>

gchaps merged commit 3fbaf22 into elastic:master Oct 30, 2020

gchaps deleted the docs/add-fleet branch October 30, 2020 17:29

This was referenced Oct 30, 2020

Fixed typo in documentation #78722

Closed

[7.x] [DOCS] Updates add data content (#81093) #82171

Merged

gchaps mentioned this pull request Oct 30, 2020

[7.10] [DOCS] Updates add data content (#81093) #82172

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[DOCS] Updates add data content #81093

[DOCS] Updates add data content #81093

gchaps commented Oct 20, 2020 •

edited

Loading

gchaps commented Oct 20, 2020

dedemorton Oct 20, 2020

dedemorton Oct 20, 2020

dedemorton Oct 20, 2020

dedemorton Oct 20, 2020

dedemorton Oct 20, 2020

dedemorton commented Oct 20, 2020

ph commented Oct 21, 2020

elasticmachine commented Oct 22, 2020

nreese Oct 22, 2020

dedemorton Oct 26, 2020

nreese Oct 22, 2020

alexfrancoeur Oct 26, 2020

alexfrancoeur left a comment

alexfrancoeur Oct 26, 2020

alexfrancoeur Oct 26, 2020

alexfrancoeur Oct 26, 2020

alexfrancoeur Oct 26, 2020

alexfrancoeur Oct 26, 2020

alexfrancoeur Oct 26, 2020

alexfrancoeur Oct 26, 2020

alexfrancoeur Oct 26, 2020

alexfrancoeur Oct 26, 2020

dedemorton left a comment

dedemorton Oct 26, 2020

dedemorton Oct 26, 2020

nreese left a comment

KOTungseth Oct 29, 2020

		[role="screenshot"]
		image::images/add-data-tutorials.png[Add Data tutorials]


		beta[]

		Fleet is a single, unified way to collect logs and metrics from systems


		To start working with your data in {kib}, you can:
		The fastest way to add data to {kib} is to use one of the built-in options.

		@@ -1,108 +1,75 @@
		[[connect-to-elasticsearch]]
		== Add data to {kib}


		Data Visualizer.
		NOTE: This feature is not intended for use as part of a

[DOCS] Updates add data content #81093

[DOCS] Updates add data content #81093

Conversation

gchaps commented Oct 20, 2020 • edited Loading

gchaps commented Oct 20, 2020

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

dedemorton commented Oct 20, 2020

ph commented Oct 21, 2020

elasticmachine commented Oct 22, 2020

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

alexfrancoeur left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

dedemorton left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

nreese left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

gchaps commented Oct 20, 2020 •

edited

Loading