mirror of
https://github.com/elastic/kibana.git
synced 2025-04-25 10:23:14 -04:00
418281b2d1
# Backport This will backport the following commits from `main` to `8.x`: - [[Docs] Update nav instructions and sample data installation to accommodate for the solution views (#199163)](https://github.com/elastic/kibana/pull/199163) <!--- Backport version: 9.4.3 --> ### Questions ? Please refer to the [Backport tool documentation](https://github.com/sqren/backport) <!--BACKPORT [{"author":{"name":"florent-leborgne","email":"florent.leborgne@elastic.co"},"sourceCommit":{"committedDate":"2024-11-08T10:10:32Z","message":"[Docs] Update nav instructions and sample data installation to accommodate for the solution views (#199163)\n\nThis PR:\r\n- updates navigation instructions to accommodate for the navigation\r\nchanges related to solution views.\r\n- updates instructions for adding sample data to rely on the\r\nintegrations page instead of the home page, that only exists with the\r\nclassic solution view\r\n- updates references to the home page to avoid confusing users using one\r\nof the new solution views\r\n\r\nCloses: https://github.com/elastic/platform-docs-team/issues/529\r\nCloses: https://github.com/elastic/platform-docs-team/issues/540","sha":"8e7fb7a77e2399e3e946bbba0462517fd7dad0f7","branchLabelMapping":{"^v9.0.0$":"main","^v8.17.0$":"8.x","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","v9.0.0","docs","v8.16.0","backport:version","v8.17.0"],"title":"[Docs] Update nav instructions and sample data installation to accommodate for the solution views","number":199163,"url":"https://github.com/elastic/kibana/pull/199163","mergeCommit":{"message":"[Docs] Update nav instructions and sample data installation to accommodate for the solution views (#199163)\n\nThis PR:\r\n- updates navigation instructions to accommodate for the navigation\r\nchanges related to solution views.\r\n- updates instructions for adding sample data to rely on the\r\nintegrations page instead of the home page, that only exists with the\r\nclassic solution view\r\n- updates references to the home page to avoid confusing users using one\r\nof the new solution views\r\n\r\nCloses: https://github.com/elastic/platform-docs-team/issues/529\r\nCloses: https://github.com/elastic/platform-docs-team/issues/540","sha":"8e7fb7a77e2399e3e946bbba0462517fd7dad0f7"}},"sourceBranch":"main","suggestedTargetBranches":["8.16","8.x"],"targetPullRequestStates":[{"branch":"main","label":"v9.0.0","branchLabelMappingKey":"^v9.0.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/199163","number":199163,"mergeCommit":{"message":"[Docs] Update nav instructions and sample data installation to accommodate for the solution views (#199163)\n\nThis PR:\r\n- updates navigation instructions to accommodate for the navigation\r\nchanges related to solution views.\r\n- updates instructions for adding sample data to rely on the\r\nintegrations page instead of the home page, that only exists with the\r\nclassic solution view\r\n- updates references to the home page to avoid confusing users using one\r\nof the new solution views\r\n\r\nCloses: https://github.com/elastic/platform-docs-team/issues/529\r\nCloses: https://github.com/elastic/platform-docs-team/issues/540","sha":"8e7fb7a77e2399e3e946bbba0462517fd7dad0f7"}},{"branch":"8.16","label":"v8.16.0","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.x","label":"v8.17.0","branchLabelMappingKey":"^v8.17.0$","isSourceBranch":false,"state":"NOT_CREATED"}]}] BACKPORT--> Co-authored-by: florent-leborgne <florent.leborgne@elastic.co>
117 lines
4.3 KiB
Text
117 lines
4.3 KiB
Text
[[connect-to-elasticsearch]]
|
|
== Add data
|
|
|
|
The best way to add data to the Elastic Stack is to use one of our many integrations,
|
|
which are pre-packaged assets that are available for a wide array of popular
|
|
services and platforms. With integrations, you can add monitoring for logs and
|
|
metrics, protect systems from security threats, and more.
|
|
|
|
All integrations are available in a single view on the **Integrations** page.
|
|
|
|
[role="screenshot"]
|
|
image::images/add-integration.png[Integrations page from which you can choose integrations to start collecting and analyzing data]
|
|
|
|
NOTE: When an integration is available for both
|
|
{fleet-guide}/beats-agent-comparison.html[Elastic Agent and Beats],
|
|
the *Integrations* view defaults to the
|
|
Elastic Agent integration, if it is generally available (GA).
|
|
To show a
|
|
Beats integration, use the filter below the side navigation.
|
|
|
|
[float]
|
|
=== Add data with Elastic solutions
|
|
|
|
A good place to start is with one of our Elastic solutions, which
|
|
offer experiences for common use cases.
|
|
|
|
* *Elastic connectors and crawler.*
|
|
** Create searchable mirrors of your data in Sharepoint Online, S3, Google Drive, and many other web services using our open code {ref}/es-connectors.html[Elastic connectors].
|
|
** Discover, extract, and index your web content into {es} using the
|
|
{enterprise-search-ref}/crawler.html[Elastic web crawler].
|
|
|
|
|
|
* *Elastic Observability.*
|
|
Get logs, metrics, traces, and uptime data into the Elastic Stack.
|
|
Integrations are available for popular services and platforms,
|
|
such as Nginx, AWS, and MongoDB,
|
|
and generic input types like log files.
|
|
Refer to {observability-guide}/observability-introduction.html[Elastic Observability]
|
|
for more information.
|
|
|
|
* *Endpoint Security.*
|
|
Protect your hosts and send logs, metrics, and endpoint security data
|
|
to Elastic Security.
|
|
Refer to {security-guide}/ingest-data.html[Ingest data to Elastic Security]
|
|
for more information.
|
|
|
|
[float]
|
|
=== Add data with programming languages
|
|
|
|
Add any data to the Elastic Stack using a programming language,
|
|
such as JavaScript, Java, Python, and Ruby.
|
|
Details for each programming language library that Elastic provides are in the
|
|
https://www.elastic.co/guide/en/elasticsearch/client/index.html[{es} Client documentation].
|
|
|
|
If you are running {kib} on our hosted {es} Service,
|
|
click *Connection details* on the *Integrations* view
|
|
to verify your {es} endpoint and Cloud ID, and create API keys for integration.
|
|
Alternatively, the *Connection details* are also accessible through the top bar help menu.
|
|
|
|
[float]
|
|
=== Add sample data
|
|
|
|
Sample data sets come with sample visualizations, dashboards, and more to help you
|
|
explore {kib} before you add your own data.
|
|
In the *Integrations* view, search for *Sample Data*, and then add the type of
|
|
data you want.
|
|
|
|
[role="screenshot"]
|
|
image::images/add-sample-data.png[eCommerce, flights, and web logs sample data sets that you can explore in Kibana]
|
|
|
|
[discrete]
|
|
[[upload-data-kibana]]
|
|
=== Upload a data file
|
|
|
|
You can upload files, view their fields and metrics, and optionally import them to {es} with the Data Visualizer.
|
|
In the *Integrations* view, search for *Upload a file*, and then drop your file on the target.
|
|
|
|
You can upload different file formats for analysis with the Data Visualizer:
|
|
|
|
File formats supported up to 500 MB:
|
|
|
|
* CSV
|
|
* TSV
|
|
* NDJSON
|
|
* Log files
|
|
|
|
File formats supported up to 60 MB:
|
|
|
|
* PDF
|
|
* Microsoft Office files (Word, Excel, PowerPoint)
|
|
* Plain Text (TXT)
|
|
* Rich Text (RTF)
|
|
* Open Document Format (ODF)
|
|
|
|
NOTE: The upload feature is not intended for use as part of a repeated production
|
|
process, but rather for the initial exploration of your data.
|
|
|
|
[role="screenshot"]
|
|
image::images/add-data-fv.png[Uploading a file in {kib}]
|
|
|
|
The {stack-security-features} provide roles and privileges that control which
|
|
users can upload files. To upload a file in {kib} and import it into an {es}
|
|
index, you'll need:
|
|
|
|
* `manage_pipeline` or `manage_ingest_pipelines` cluster privilege
|
|
* `create`, `create_index`, `manage`, and `read` index privileges for the index
|
|
* `all` {kib} privileges for *Discover* and *Data Views Management*
|
|
|
|
You can manage your roles, privileges, and spaces in **{stack-manage-app}**.
|
|
|
|
[discrete]
|
|
=== What's next?
|
|
|
|
To take your investigation
|
|
to a deeper level, use <<discover, **Discover**>> and quickly gain insight to your data:
|
|
search and filter your data, get information about the structure of the fields,
|
|
and analyze your findings in a visualization.
|