Hadoop job analyzer is a tool that analyzes hadoop jobs, aggregates the information according to user specified crosssections, and sends the output to a metrics backend for visualization and analysis.
The tool is non intrusive and is based on analyzing the history folder in the jobtracker.
The tool analyzes and exposes all the information about the job. This ranges from mapper/reducer counts (including failed counts), processing durations, input/output record counts and bytes, up to dynamic counters created by higher layers (such as Hive-Level counters), and even by the tool itself, such as the duration of time between job submission and actually beginning job execution.
All the data for each job is broken down into "fields", each contain a piece of information regarding the jobs. For example, SUBMIT_TIME contains the job submission time, USER contains the name of the user running the job and SOURCE_HOST contains the name of the host submitting the job.
The tool also supports extraction of job metadata from the jobname using regular expressions. The extracted metadata becomes part of the job information and the user can choose to aggregate based on it similar to any other fields. See below for examples.
The tool provides intrinsic aggregation capabilities. The aggregation is done on two levels simultanously:
-
Time based aggregation - Every job is put into a "time bucket", which is calculated from one of the time related fields of the job. By default, the time bucket is calculated to 1 minute intervals according to the job submission time.
-
Field based aggregation - The user can ask for multiple views or "projections" of the data, based on the value of fields. The most common projections are
SOURCE_HOSTandUSER, which will provide views based on the submitting host and the requesting user, respectively. The tool supports an arbitrary number of projections of the same data.
Ultimately, the tool is meant for exposing the job information in a usable way to a metric backend, for analysis, trending and troubleshooting purposes.
Currently, the tool supports sending the metrics to graphite and stdout. Additional metric backends can be supported through a simple plugin mechanism.
A Graphitus dashboard for the metrics sent to graphite is also included, for easy visualization of the data the tool sends. If you don't know graphitus, you should.
To use the graphitus dashboard, look at the README in the graphitus dashboard folder.
The example graphs above were done with the help of graphitus.
- Full slicing and dicing support - Allows to pinpoint exact changes in behavior over time
- Provides insights to all internal job metrics
- Proven in production - Works on three 300-node production clusters for over a year
- Allows extending job metadata through the job name itself, using a job name convention
- Supports both CDH3 and CDH4 hadoop versions.
- Additional metric backends can be easily add if needed
The current stable version is 0.8. To install it follow these steps:
-
Extract this tar.gz to a folder in the job tracker.
-
Run
pip install cElementTree -
Create a script which runs the tool with your selected parameters. You can use the
-lflag and the-C stdoutflags while creating the script in order to see the output before actually productizing it. See usage for details. -
Run this script in cron every time interval (e.g. 1 hour).
Installation through RPM/Debian is under way.
The tool needs to run periodically on the job tracker, using a set of parameters to control its behavior.
Look at the Usage Page for details.
Several examples are provided here.
By default the tool will stop if there is an analysis problem. You can use the -r relaxed mode flag in order ot make the tool continue processing to the next jobs even in the face of errors. Metrics will be sent on job analysis failures and on job name parsing failures.
Part of the problems can reside in minor changes between the various hadoop cluster versions, which can be fixed quickly, so I would appreciate any feedback regarding issues like that, and quickly fix them.
See here for details.
Read here on the metric backend plugins.
The tool writes a rotated log file to the logs/ folder under the location of the tool itself.
Note that this doesn't affect the stdout metric plugin, which writes directly to stdout regardless of the logging.
-
Metric names are currently fully processed by the infrastructure and not by the metric plugin. This might change in the future.
-
Currently, all aggregations are sum() aggregations. If needed, aggregation types will be added, possibly by providing a
.AVG,.SUMversions of the metrics.
Any feedback would be much appreciated, as well as pull requests, of course.
Harel Ben-Attia, harelba@gmail.com, @harelba on Twitter