kibana/docs/infrastructure/infra-ui.asciidoc
Kaarina Tungseth d0aa9f1418
[DOCS] Changed time picker to time filter (#46956)
* [DOCS] Changed time picker to time filter

* Final changes

* Review comments

* Review comments pt 2
2019-10-07 15:21:40 -05:00

112 lines
5 KiB
Text

[role="xpack"]
[[infra-ui]]
== Using the Infrastructure app
Use the Infrastructure app in {kib} to monitor your infrastructure and identify problems in real time.
You can explore metrics for hosts, containers, and services.
You can also drill down to view more detailed metrics, or seamlessly switch to view the corresponding logs, application traces, and uptime information.
Initially, the *Inventory* tab shows an overview of the hosts in of your infrastructure and the current CPU usage for each host.
From here, you can drill down into areas of interest.
[role="screenshot"]
image::infrastructure/images/infra-sysmon.png[Infrastructure Overview in Kibana]
[float]
[[infra-cat]]
=== Choose the high-level view of your infrastructure
Select the high-level view from *Hosts*, *Kubernetes*, or *Docker*.
When you change views, you see the same data through the perspective of a different category.
The default representation is the *Map view*, which shows your components in a _waffle map_ of one or more rectangular grids.
If the view you select has a large number of components, you can hover over a component to see the details for that component. Alternatively, if you would prefer to see your infrastructure as a table, click *Table view*.
[float]
[[infra-metric]]
=== Select the metric to view
Select the metric to view from the *Metric* dropdown list.
The available metrics are those that are most relevant for the high-level view you selected.
[float]
[[infra-group]]
=== Group components
Select the way you want to group the infrastructure components from the *Group By* dropdown list.
The available options are specific to your physical, virtual, or container-based infrastructure.
Examples of grouping options include *Availability Zone*, *Machine Type*, *Project ID*, and *Cloud Provider* for hosts, and *Namespace* and *Node* for Kubernetes.
[float]
[[infra-search]]
=== Use the power of search
Use the search bar to perform ad hoc searches for specific text.
You can also create structured searches using {kibana-ref}/kuery-query.html[Kibana Query Language].
For example, enter `host.hostname : "host1"` to see only the information for `host1`.
[float]
[[infra-date]]
=== Specify the time and date
Click the time filter image:infrastructure/images/infra-time-selector.png[time filter icon] to choose the timeframe for the metrics.
The values shown are the values for the last minute at the specified time and date.
[float]
[[infra-refresh]]
=== Auto-refresh metrics
Select *Auto-refresh* to keep up-to-date metrics information coming in, or *Stop refreshing* to focus on historical data without new distractions.
[float]
[[infra-configure-source]]
=== Configure the data to use for your metrics
The default source configuration for metrics is specified in the {kibana-ref}/infrastructure-ui-settings-kb.html[Infrastructure app settings] in the {kibana-ref}/settings.html[Kibana configuration file].
The default configuration uses the `metricbeat-*` index pattern to query the data.
The default configuration also defines field settings for things like timestamps and container names.
If your metrics have custom index patterns, or use non-default field settings, you can override the default settings.
Click *Configuration* to change the settings.
This opens the *Configure source* fly-out dialog.
NOTE: These settings are shared with logs. Changes you make here may also affect the settings used by the *Logs* app.
In the *Configure source* dialog, you can change the following values:
* *Name*: the name of the source configuration
* *Indices*: the index pattern or patterns in the Elasticsearch indices to read metrics data and log data
from
* *Fields*: the names of specific fields in the indices that are used to query and interpret the data correctly
TIP: If <<xpack-spaces>> are enabled in your Kibana instance, any configuration changes you make here are specific to the current space.
You can make different subsets of data available by creating multiple spaces with different data source configurations.
TIP: If you don't see the *Configuration* option, you may not have sufficient privileges to change the source configuration.
For more information see <<xpack-security-authorization>>.
[float]
[[infra-metrics-explorer]]
=== Visualize multiple metrics in Metrics Explorer
<<metrics-explorer, Metrics Explorer>> allows you to visualize and analyze metrics for multiple components in a powerful and configurable way. Click the *Metrics Explorer* tab to get started.
[float]
[[infra-drill-down]]
=== Drill down for related information
Hover over a component to see more information about that component.
Click a component to see the other actions available for that component.
You can:
* Select *View Metrics* to <<xpack-view-metrics, view detailed infrastructure metrics>>.
* Select *View Logs* to <<xpack-logs-using, view the logs>> in the *Logs* app.
Depending on the features you have installed and configured, you may also be able to:
* Select *View APM* to <<traces, view APM traces>> in the *APM* app.
* Select *View Uptime* to <<uptime-overview, view uptime information>> in the *Uptime* app.