I help teams fix systemic engineering issues: processes, architecture, and clarity.
→ See how I work with teams.
Symptom
A Hive job fails with an error like:
Ended Job = job_xxxxxx with exception
'org.apache.hadoop.mapreduce.counters.LimitExceededException
(Too many counters: 201 max=200)'
FAILED: Execution Error, return code 1 from org.apache.hadoop.hive.ql.exec.MapRedTask
Intercepting System.exit(1)
The query might be complex, but otherwise looks syntactically fine. The problem is not your SQL, it’s the number of counters that MapReduce is willing to track.
Why this happens: operators and counters
Hive uses counters to track statistics for built-in operators (see the Hive LanguageManual UDF / operators documentation). For each operator, Hive can create multiple counters; historically this was around four counters per operator.
On top of that, a MapReduce job has its own counters for:
- Input / output bytes and records
- Tables, partitions, files
- Custom job- and framework-level metrics
The default maximum number of counters in classic MapReduce was relatively low (for example, 200), so a sufficiently complex query with many operators could exceed this limit and trigger a LimitExceededException.
The fix: raise mapreduce.job.counters.max
To avoid this exception, increase the maximum number of counters allowed per job by setting:
<property>
<name>mapreduce.job.counters.max</name>
<value>1120</value>
</property>
Add this to mapreduce-site.xml (or the equivalent config for your distribution) and restart the relevant services so Hive and MapReduce pick up the new setting.
A value slightly above 1000 is often enough for complex Hive queries while still keeping memory overhead manageable. You can adjust this based on your query patterns and any additional counters used by your environment.
Estimating how many counters you need
The number of counters required is roughly proportional to the number of operators used in the query. A simple way to get a sense of this is:
- Run
EXPLAIN EXTENDEDon your query to see the full operator tree. - Search for “operator” lines in the explain output and count them.
Example workflow:
hive> EXPLAIN EXTENDED <your_query> > explain.out
grep -ri "operator" explain.out | wc -l
This gives you a rough count of operators. Multiply by the number of counters per operator (historically ~4) and add some headroom for framework counters to decide how high you should set mapreduce.job.counters.max.
Impact on other MapReduce jobs
Raising mapreduce.job.counters.max:
- Prevents Hive jobs from failing as they approach the previous counter limit.
- Does not break other MapReduce jobs, but they can now allocate more counters if needed.
- Has a small memory and bookkeeping cost per additional counter; keep the value reasonable and not arbitrarily huge.
If you see the “Too many counters” error, adjusting this single setting is usually enough to unblock Hive while keeping your MapReduce cluster stable.
If you need help with distributed systems, backend engineering, or data platforms, check my Services.