Monitor Application Logs using Humio
Use Humio to monitor log files for the CMS and Site applications running in your Bloomreach Cloud environments.
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/.
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 a Google account, click on Sign in with Google and enter your credentials.
The first time you log in to Humio, you'll have to go through some additional steps:
- Fill in the profile form.
- Choose the free account.
- Follow or skip the tutorial.
Once logged in, you will see two options on the Repos & Views tab: your project/stack and your sandbox:
Click on the name of your stack. Click on a row and at the bottom of the screen you will see 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.
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:
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).
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.
Log entries have a number of different fields. If you click on a row, you will see the fields. Some interesting fields are:
|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.|
Humio has support for alerting and can be configured to notify external systems about error conditions or other events. See Alerting in the Humio docs for instructions.
It's recommended to create an alert for Out of Memory exceptions. See Monitor and Analyze JVM Memory for details.