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:
  1. 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".
  2. 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 is karaf. 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.