Red Hat Training

A Red Hat training course is available for Red Hat Fuse

Chapter 24. Getting Started

Overview

To get started with Insight, you set up the data store, configure the containers to send messages or events to the data store, and install the embedded Web viewer to show the data in the Management Console. You then configure each container that you want to add to the Insight ensemble to send logs or metrics to the data store.

Prerequisites

Before you install and configure Insight, you must create a fabric or join an existing fabric.

Data store installation

To ensure optimal system resource usage, it is recommended that you install each data store in a separate container.
To install the data store, create a container with the following profiles:
insight-elasticsearch.node
Listener process that collects logs and events from the containers and writes the data to the data store. This profile contains all the configuration for the data store, such as size and location.
To customize the data store configuration, edit the io.fabric8.elasticsearch-insight.properties file. For more information about the Elasticsearch node configuration properties, see the Elasticsearch configuration documentation.
insight-elasticsearch.datastore
Database instance that uses Elasticsearch to store log messages and events from multiple sources. This profile extends the insight-elasticsearch.node profile and inherits its configuration.

Web viewer installation

To install the Web viewer, add the following profiles to the root container:
insight-elasticsearch.node
This profile enables the container to join the Elasticsearch cluster as an Elasticsearch client.
insight-console
Enables the Insight perspective in the Fuse Management Console.
After adding these profiles to the root container, the Web viewer is then available from the Insight perspective.
You can configure a different Web viewer to access logs and metrics. To connect directly to the cluster from an external Web viewer, enter the IP address from the Connect box of the Elasticsearch page as the destination of the data store cluster. You cannot use the command line to query the data store.

Configuring log collection

By default, containers send log messages to standalone log files that you view in the Logs tab of the container. To instruct a container to send the messages to the Insight data store, add the insight-logs.elasticsearch profile to each container that you want to add to the Insight ensemble.

Configuring metrics collection

By default, containers with Camel routes use stack tracing to collect metrics. To instruct a container to send the messages to the Insight data store, add the insight-metrics.elasticsearch and the insight-camel profiles to each Camel container that you want to add to the Insight ensemble.

Viewing and analyzing logs and metrics

You access the logs and metrics for all containers and brokers from the Insight perspective. For more information, see Chapter 25, Insight Perspective.