mirror of
https://github.com/elastic/kibana.git
synced 2025-04-24 17:59:23 -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>
123 lines
4.4 KiB
Text
123 lines
4.4 KiB
Text
[role="xpack"]
|
|
[[graph-getting-started]]
|
|
== Create a graph
|
|
|
|
You must index data into {es} before you can create a graph.
|
|
<<data-views, Learn how>> or get started with a <<add-sample-data, sample data set>>.
|
|
|
|
[float]
|
|
[[exploring-connections]]
|
|
=== Graph a data connection
|
|
|
|
. Go to *Graph*.
|
|
+
|
|
If this is your first graph, follow the prompts to create it.
|
|
For subsequent graphs, click *New*.
|
|
|
|
. Select a data source to explore.
|
|
|
|
. Add one or more multi-value fields that contain the terms you want to
|
|
graph.
|
|
+
|
|
The vertices in the graph are selected from these terms.
|
|
|
|
. Enter a search query to discover relationships between terms in the selected
|
|
fields.
|
|
+
|
|
For example, if you are using the {kib} sample web logs data set, and you want
|
|
to generate a graph of the successful requests to
|
|
particular pages from different locations, you could search for the 200
|
|
response code. The weight of the connection between two vertices indicates how strongly they
|
|
are related.
|
|
+
|
|
[role="screenshot"]
|
|
image::user/graph/images/graph-url-connections.png["URL connections"]
|
|
|
|
. To view more information about the relationship, click any connection.
|
|
+
|
|
[role="screenshot"]
|
|
image::user/graph/images/graph-link-summary.png["Link summary"]
|
|
|
|
. Use the control bar to explore
|
|
additional connections:
|
|
+
|
|
* To display additional vertices that connect to your graph, click the expand icon
|
|
image:user/graph/images/graph-expand-button.png[Expand Selection].
|
|
* To display additional
|
|
connections between the displayed vertices, click the link icon
|
|
image:user/graph/images/graph-link-button.png[Add links to existing terms].
|
|
* To explore a particular area of the
|
|
graph, select the vertices you are interested in, and then click expand or link.
|
|
* To step back through your changes to the graph, click undo
|
|
image:user/graph/images/graph-undo-button.png[Undo] and redo
|
|
image:user/graph/images/graph-redo-button.png[Redo].
|
|
|
|
. To see more relationships in your data, submit additional queries.
|
|
+
|
|
[role="screenshot"]
|
|
image::user/graph/images/graph-add-query.png["Adding networks"]
|
|
|
|
. *Save* your graph.
|
|
|
|
[float]
|
|
[[style-vertex-properties]]
|
|
=== Style vertex properties
|
|
|
|
Each vertex has a color, icon, and label. To change
|
|
the color or icon of all vertices
|
|
of a certain field, click it's badge, and then
|
|
select *Edit settings*.
|
|
|
|
To change the color and label of selected vertices,
|
|
click the style icon image:user/graph/images/graph-style-button.png[Style]
|
|
in the control bar.
|
|
|
|
|
|
[float]
|
|
[[edit-graph-settings]]
|
|
=== Edit graph settings
|
|
|
|
By default, *Graph* is configured to tune out noise in your data.
|
|
If this isn't a good fit for your data, use *Settings > Advanced settings*
|
|
to adjust the way *Graph* queries your data. You can tune the graph to show
|
|
only the results relevant to you and to improve performance.
|
|
For more information, see <<graph-troubleshooting, Graph troubleshooting>>.
|
|
|
|
You can configure the number of vertices that a search or
|
|
expand operation adds to the graph.
|
|
By default, only the five most relevant terms for any given field are added
|
|
at a time. This keeps the graph from overflowing. To increase this number, click
|
|
a field, select *Edit Settings*, and change *Terms per hop*.
|
|
|
|
[float]
|
|
[[graph-block-terms]]
|
|
=== Block terms from the graph
|
|
Documents that match a blocked term are not allowed in the graph.
|
|
To block a term, select its vertex and click
|
|
the block icon
|
|
image:user/graph/images/graph-block-button.png[Block list]
|
|
in the control panel.
|
|
For a list of blocked terms, go to *Settings > Blocked terms*.
|
|
|
|
[float]
|
|
[[graph-drill-down]]
|
|
=== Drill down into raw documents
|
|
With drilldowns, you can display additional information about a
|
|
selected vertex in a new browser window. For example, you might
|
|
configure a drilldown URL to perform a web search for the selected vertex term.
|
|
|
|
Use the drilldown icon image:user/graph/images/graph-info-icon.png[Drilldown selection]
|
|
in the control panel to show the drilldown buttons for the selected vertices.
|
|
To configure drilldowns, go to *Settings > Drilldowns*. See also
|
|
<<disable-drill-down, Disabling drilldown configuration>>.
|
|
|
|
[float]
|
|
[[graph-run-layout]]
|
|
=== Run and pause layout
|
|
Graph uses a "force layout", where vertices behave like magnets,
|
|
pushing off of one another. By default, when you add a new vertex to
|
|
the graph, all vertices begin moving. In some cases, the movement might
|
|
go on for some time. To freeze the current vertex position,
|
|
click the pause icon
|
|
image:user/graph/images/graph-pause-button.png[Block selection]
|
|
in the control panel.
|