The OpenTelemetry Collector provides an integration with Hadoop. The Collector fetches Hadoop metrics from JMX. From there the metrics are processed and exported to Lightstep Observability.
To complete the integration, you will:
- Configure the JMX receiver for the Collector to ingest Hadoop metrics
- Enable the integration by adding it to a pipeline
- Java 8, to run Hadoop:
- Apache Hadoop v3 or later
- A running Hadoop single cluster instance
- Download OpenTelemetry JMX Metric JAR release version 1.9 or later.
- The path to the
- You’ve configured the Collector to export metric data to Lightstep Observability.
The Hadoop JMX receiver periodically fetches metrics using a built-in OpenTelemetry helper utilizing a Groovy script. The script is configured to poll both the JMX Agent and the OpenTelemetry JMX Metric Gatherer operation.
For more details regarding configuring the Hadoop remote connection, see the official Hadoop documentation.
Configure the Collector receiver
In the Collector configuration file, add JMX as a receiver and set the following:
jar_path: The path to the
endpoint: The hostname/IP address and port or unix socket file path of the Hadoop instance
target_system: The metrics to collect. Valid values for this integration are
1 2 3 4 5 6 receivers: jmx: jar_path: /opt/opentelemetry-jmx-metrics.jar endpoint: "localhost:9999" target_system: jvm,hadoop
The OpenTelemetry repo’s readme provides additional details about JMX configuration.
Enable the Collector receiver
Once the Hadoop receiver is configured, enable it by adding it to one or more pipelines as described in the Collector configuration documentation.
Validate metrics are reporting to Lightstep
You can validate that the metrics are reporting to Lightstep from the Metric details section of the Project Settings page.
Open the Project settings page and scroll to the Metric details section.
Search for Hadoop metric names.
See the OpenTelemtry repo for a complete list of emitted metrics.
- If needed, click on the metric to edit the description and how the units are displayed in Lightstep.
Create a dashboard for the metrics
Use the Lightstep Terraform Provider to create a dashboard for the metrics.
For a more complete example that’s ready to run, see the Hadoop integration in Lightstep OpenTelemetry Examples.