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.propertiesfile. 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.nodeprofile 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.
