mirror of
https://github.com/elastic/kibana.git
synced 2025-04-25 10:23:14 -04:00
1ea53f3352
# Backport This will backport the following commits from `main` to `8.5`: - [[DOCS] Fix link in Kibana Add Data (#145480)](https://github.com/elastic/kibana/pull/145480) <!--- Backport version: 8.9.7 --> ### Questions ? Please refer to the [Backport tool documentation](https://github.com/sqren/backport) <!--BACKPORT [{"author":{"name":"Lisa Cawley","email":"lcawley@elastic.co"},"sourceCommit":{"committedDate":"2022-11-17T01:02:29Z","message":"[DOCS] Fix link in Kibana Add Data (#145480)","sha":"d68b016953c406c52928b008447687f8ae109ffe","branchLabelMapping":{"^v8.7.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","docs","auto-backport","v7.16.4","v8.0.2","v8.1.4","v8.2.4","v8.3.4","v8.6.0","v8.4.4","v7.17.8","v8.7.0","v8.5.2"],"number":145480,"url":"https://github.com/elastic/kibana/pull/145480","mergeCommit":{"message":"[DOCS] Fix link in Kibana Add Data (#145480)","sha":"d68b016953c406c52928b008447687f8ae109ffe"}},"sourceBranch":"main","suggestedTargetBranches":["7.16","8.0","8.1","8.2","8.3","8.6","8.4","7.17","8.5"],"targetPullRequestStates":[{"branch":"7.16","label":"v7.16.4","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.0","label":"v8.0.2","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.1","label":"v8.1.4","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.2","label":"v8.2.4","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.3","label":"v8.3.4","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.6","label":"v8.6.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.4","label":"v8.4.4","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"7.17","label":"v7.17.8","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"main","label":"v8.7.0","labelRegex":"^v8.7.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/145480","number":145480,"mergeCommit":{"message":"[DOCS] Fix link in Kibana Add Data (#145480)","sha":"d68b016953c406c52928b008447687f8ae109ffe"}},{"branch":"8.5","label":"v8.5.2","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"}]}] BACKPORT--> Co-authored-by: Lisa Cawley <lcawley@elastic.co>
104 lines
4.2 KiB
Text
104 lines
4.2 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, and
|
|
{kib} guides you there from the *Welcome* screen, home page, and main menu.
|
|
|
|
[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.
|
|
|
|
* *Web site search crawler.*
|
|
Discover, extract, and index your web content into App Search engines using the
|
|
{app-search-ref}/web-crawler.html[Enterprise Search web site crawler].
|
|
Search across Google Drive, GitHub, Salesforce, and many other web services using
|
|
{workplace-search-ref}/workplace-search-content-sources.html[Workplace Search content sources].
|
|
|
|
* *Elastic APM.*
|
|
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 *View deployment details* on the *Integrations* view
|
|
to verify your {es} endpoint and Cloud ID, and create API keys for integration.
|
|
|
|
[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
|
|
|
|
If you have a log file or delimited CSV, TSV, or JSON file, you can upload it,
|
|
view its fields and metrics, and optionally import it into {es}.
|
|
In the *Integrations* view, search for *Upload a file*, and then drop your file on the target.
|
|
|
|
By default, you can upload a file up to 100 MB. This value is configurable up to 1 GB in
|
|
<<fileupload-maxfilesize,Advanced Settings>>.
|
|
|
|
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.
|