Kibana requires an index pattern to access the Elasticsearch data that you want to explore. An index pattern selects the data to use and allows you to define properties of the fields.
You’ll learn how to:
- Create index patterns
- Set the default index pattern
- Delete index patterns
Before you beginedit
To access the Index Patterns view, you must have the Kibana privilege
Index Pattern Management. To create an index pattern, you must have the Elasticsearch privilege
view_index_metadata. To add the privileges, open the main menu, then click Stack Management > Roles.
- If a read-only indicator appears in Kibana, you have insufficient privileges to create or save index patterns. The buttons to create new index patterns or save existing index patterns are not visible. For more information, refer to Granting access to Kibana.
Create an index patternedit
If you collected data using one of the Kibana ingest options, uploaded a file, or added sample data, you get an index pattern for free, and can start exploring your data. If you loaded your own data, follow these steps to create an index pattern.
- Open the main menu, then click to Stack Management > Index Patterns.
Click Create index pattern.
Start typing in the Index pattern field, and Kibana looks for the names of Elasticsearch indices that match your input.
Use a wildcard (*) to match multiple indices.
For example, suppose your system creates indices for Apache data
using the naming scheme
filebeat-apache-b, and so on. An index pattern named
filebeat-amatches a single source, and
filebeat-*matches multiple data sources. Using a wildcard is the most popular approach.
Select multiple indices by entering multiple strings,
separated with a comma. Make sure there is no space after the comma.
filebeat-a,filebeat-bmatches two indices, but not other indices you might have afterwards (filebeat-c).
- Use a minus sign (-) to exclude an index, for example, test*,-test3.
- Use a wildcard (*) to match multiple indices. For example, suppose your system creates indices for Apache data using the naming scheme
- Click Next step.
If Kibana detects an index with a timestamp, expand the Time field menu, and then specify the default field for filtering your data by time.
If your index doesn’t have time-based data, or if you don’t want to select the default timestamp field, choose I don’t want to use the Time Filter.
If you don’t set a default time field, you will not be able to use global time filters on your dashboards. This is useful if you have multiple time fields and want to create dashboards that combine visualizations based on different timestamps.
Click Create index pattern.
Kibana is now configured to use your Elasticsearch data.
- Select this index pattern when you search and visualize your data.
Create an index pattern for rolled up dataedit
An index pattern can match one rollup index. For a combination rollup index pattern with both raw and rolled up data, use the standard notation:
For an example, refer to Create and visualize rolled up data.
Create an index pattern that searches across clustersedit
If your Elasticsearch clusters are configured for cross-cluster search, you can create an index pattern to search across the clusters of your choosing. Use the same syntax that you’d use in a raw cross-cluster search request in Elasticsearch:
For example, to query Logstash indices across two Elasticsearch clusters
that you set up for cross-cluster search, named
use this for your index pattern:
You can use wildcards in your cluster names
to match any number of clusters. For example, to search Logstash indices across
cluster_bar, and so on, create this index pattern:
To query across all Elasticsearch clusters that have been configured for cross-cluster search, use a standalone wildcard for your cluster name in your index pattern:
You can use exclusions to exclude indices that might contain mapping errors.
To match indices starting with
logstash-, and exclude those starting with
all clusters having a name starting with
cluster_, you can use
To exclude a cluster, use
Once an index pattern is configured using the cross-cluster search syntax, all searches and aggregations using that index pattern in Kibana take advantage of cross-cluster search.
Delete index patternsedit
When you delete an index pattern, you are unable to recover the associated field formatters, scripted fields, source filters, and field popularity data. Deleting an index pattern does not remove any indices or data documents from Elasticsearch.
Deleting an index pattern breaks all visualizations, saved searches, and other saved objects that reference the index pattern.
- Open the main menu, then click Stack Management > Index Patterns.
- Click the index pattern you want to delete.
- Delete () the index pattern.
Learn how to manage the data fields in your index patterns.