Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

How to Monitor GridGain Clusters With New Relic

Export GridGain 8 metrics and logs to New Relic using the OpenTelemetry Java agent, then visualize them with a prebuilt dashboard.

Prerequisites

Overview

Monitoring and alerting are essential parts of any production system. GridGain has its own management and diagnostics tools in Control Center. However, if you want to monitor your entire application portfolio, you need a more generalized solution. One popular option is New Relic, an "all-in-one observability platform" that provides "data for engineers to monitor, debug, and improve their entire stack."

This guide shows you how to export GridGain metrics and logs to New Relic. It uses the OpenTelemetry Java agent to extract metrics from GridGain and export them to New Relic, assuming a basic GridGain installation on bare metal or a VM. More sophisticated approaches may be available when deploying to Kubernetes.

The integration process has four steps:

Find Your New Relic Account Details

  1. Log into your New Relic account.

  2. Find your API key:

    New Relic account details
    1. Click your username in the bottom left corner of the screen.

    2. Select API keys.

    3. Find the correct license key of type INGEST - LICENSE.

    4. From the license key's context menu, select Copy key.

    5. Save the key aside — you will need it later.

Install the OpenTelemetry Java Agent

  1. Get the latest version of the OpenTelemetry Java agent.

  2. Make sure you install a copy of the agent on each of your GridGain nodes.

Configure GridGain to use the Agent

Set the necessary server parameters in your JVM_OPTS. For example:

$NEW_RELIC_ENDPOINT is https://otlp.eu01.nr-data.net:4317 if you are in the US, https://otlp.nr-data.net:4317 otherwise. Check the New Relic documentation for the most up-to-date information.

$NEW_RELIC_API is the key you have copied from your New Relic account.

$SERVICE_NAME is the name of a cluster or application. This should uniquely identify the entire cluster. An example might be gridgain-prod.

To identify your GridGain nodes in New Relic, name them. It is recommended to use the consistent ID; for example:

To collect logs in New Relic, set the following:

The sample startup script includes all the above parameters.

The sample configuration file maps many of GridGain's JMX metrics to New Relic. You can import other metrics to meet your specific requirements.

View Cluster Metrics in the Dashboard

The sample dashboard looks like this:

GridGain dashboard in New Relic

To import the dashboard and use it for viewing the cluster metrics:

  1. In New Relic, select Dashboard from the menu bar on the left-hand side.

  2. At the top right of the screen, click Import dashboard.

  3. Copy the JSON content from the sample dashboard file and paste it into the dialog.

  4. Click Import dashboard.

This page is: Copyright © 2026 MariaDB. All rights reserved.

Last updated

Was this helpful?