Monitor Application Logs using Humio - BloomReach Experience - Open Source CMS

Monitor Application Logs using Humio

This documentation applies to Bloomreach Cloud 2 only

Introduction

Goal

Use Humio to monitor log files for the CMS and Site applications running in your Bloomreach Cloud environments. Note that Mission Control also offers the possibility to download the log files from the Tomcat instances. Depending on your use-case, pick the right tool. Humio has very fast search and filter capabilities and a 60 day retention.

Background

Bloomreach Cloud uses the external service humio.com to expose the application logs of the CMS and Site applications running in the environments.

This page provides basic directions for accessing your application logs. More learning resources can be found at https://docs.humio.com/.

Access Humio

As a Bloomreach Cloud customer, you need to provide BloomReach a Google/Github/Bitbucket account to sign in to Humio. BloomReach will add this account to the Humio repo as a user. In case you do not have a Google/Github/Bitbucket account, please contact Helpdesk for a workaround.

Log in at https://cloud.humio.com/ using the credentials you provided to BloomReach. For example when using the Gmail account, Click on Sign in with Google and enter your credentials.

Once logged in, click on the name of your stack (there is only one entry). Click on a row and you will see at the bottom of the screen fields appear that you can use for filtering.

Click on the button in the right upper corner with the time, e.g. Last 5m (static), to change the time window. Check live query to get a tail.

Create Filters for Your Environments

Application logs for all your Bloomreach Cloud environments are collected in the same Humio instance. Therefore, it's a good idea to create a search filter for each of your environments.

For example, for an environment called "blue", enter the following query in the search box:

environments[0]="blue"

Click on the Run button to execute the search. Note: we will remove the need for the array selector.

To save the search, click on Save as...  (on the right side of the screen).

Select a Time Range

In the top right you can see the currently selected time range. By default, this is Last 5 minutes. Click on it to select a different time range. Use the live-query checkbox to get a live tail.

Select Fields to Display

Log entries have a number of different fields. If you click on a row, you will see the fields. Some interesting fields are:

Field Name Description
class The Java class in which the log entry originated.
container Log entries are separated into different containers by type. Available containers are cms-log, site-log, and audit-log.
environment Name of the Bloomreach Cloud environment from in which the log entry originated. For example, blue or green.
severity Severity or log level of the message, for example INFO, WARNING, or ERROR.
stack Name of the Bloomreach Cloud stack in which the log entry originated. For example, mycloud.onehippo.io. Only interested if you are managing more than one stack.

 

Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?