Chapter 28. Elasticsearch Page
Abstract
You view and and manage the Elasticsearch data stores in the Elasticsearch page. You can view detailed information about all the data stores in the fabric, such as cluster and node state. You can also run custom queries on the database.
Overview
You access the Elasticsearch page from the Insight perspective. This page is available only when you install and configure the Insight plugin for one or more containers in the fabric.
The following image shows an example of the Elasticsearch page:
The Elasticsearch page contains the following sections:
- Cluster overview and toolbar
- General information about the data store cluster, such as the address and the state of the cluster. If you want to connect directly to the cluster from an external Web viewer, you use the IP address from the Connect box to indicate the location of the data store cluster.
- Data Store list and details
- List of all the data stores in the cluster. Each node represents a data store container. The right pane shows general information about each node, such as storage size according to date, number of messages, and so on.
Enabling Basic HTTP Authentication
You can enable baic HTTP authentication on Elasticsearch nodes that are used in Fabic8 v1 insight profiles. To do this:
- Assign the
elasticsearch.basicauth profile
to- Each container that has
elasticsearch.node
assigned - Each
elasticsearch.node
child profile
This adds basic HTTP authentication to the Elasticsearch API. The API authenticates against the JAAS fabric realm. By default, a user with any one of the following roles is authenticated: "admin", "manager", "viewer", "Monitor", "Operator", "Maintainer", "Deployer", "Auditor", "Administrator", "SuperUser". - Optionally, if you want to modify the default settings, insert the following configuration properties into the
io.fabric8.elasticsearch-insight
PID:http.basic.realm
The default iskaraf
. Specify the name of the JAAS realm to use.http.basic.roles
The default is:admin,manager,viewer,Monitor,Operator,Maintainer,Deployer, Auditor,Administrator,SuperUser
. Specify a comma separated list of allowed roles.http.basic.log
The default is false. Specify true for more verbose logging.
Logging In
When you log in to Hawtio, be sure to enable Remember me. This provides a better experience if there are refreshes of the Hawtio page. When the user account that is used to log in to Hawtio is authorized then the Insight panel works out of the box.