MapReduce 计数器简介

1、计数器简介

在许多情况下，一个用户需要了解待分析的数据，尽管这并非所要执行的分析任务 的核心内容。以统计数据集中无效记录数目的任务为例，如果发现无效记录的比例 相当高，那么就需要认真思考为何存在如此多无效记录。是所采用的检测程序存在 缺陷，还是数据集质量确实很低，包含大量无效记录？如果确定是数据集的质量问 题，则可能需要扩大数据集的规模，以增大有效记录的比例，从而进行有意义的 分析。  
计数器是一种收集作业统计信息的有效手段，用于质量控制或应用级统计。计数器 还可辅助诊断系统故障。如果需要将日志信息传输到map或reduce任务，更好的 方法通常是尝试传输计数器值以监测某一特定事件是否发生。对于大型分布式作业 而言，使用计数器更为方便。首先，获取计数器值比输出日志更方便，其次，根据 计数器值统计特定事件的发生次数要比分析一堆日志文件容易得多。  

2、内置计数器

Hadoop为每个作业维护若干内置计数器, 以描述该作业的各项指标。例如，某些计数器记录已处理的字节数和记录数，使用户可监控已处理的输入数据量和已产生的输出数据量，并以此对 job 做适当的优化。

01	14/06/08 15:13:35 INFO mapreduce.Job: Counters: 46

02	File System Counters

03	FILE: Number of bytes read=159

04	FILE: Number of bytes written=159447

05	FILE: Number of read operations=0

06	FILE: Number of large read operations=0

07	FILE: Number of write operations=0

08	HDFS: Number of bytes read=198

09	HDFS: Number of bytes written=35

10	HDFS: Number of read operations=6

11	HDFS: Number of large read operations=0

12	HDFS: Number of write operations=2

13	Job Counters

14	Launched map tasks=1

15	Launched reduce tasks=1

16	Rack-local map tasks=1

17	Total time spent by all maps in occupied slots (ms)=3896

18	Total time spent by all reduces in occupied slots (ms)=9006

19	Map-Reduce Framework

20	Map input records=3

21	Map output records=12

22	Map output bytes=129

23	Map output materialized bytes=159

24	Input split bytes=117

25	Combine input records=0

26	Combine output records=0

27	Reduce input groups=4

28	Reduce shuffle bytes=159

29	Reduce input records=12

30	Reduce output records=4

31	Spilled Records=24

32	Shuffled Maps =1

33	Failed Shuffles=0

34	Merged Map outputs=1

35	GC time elapsed (ms)=13

36	CPU time spent (ms)=3830

37	Physical memory (bytes) snapshot=537718784

38	Virtual memory (bytes) snapshot=7365263360

39	Total committed heap usage (bytes)=2022309888

40	Shuffle Errors

41

BAD_ID=0

42	CONNECTION=0

43	IO_ERROR=0

44	WRONG_LENGTH=0

45	WRONG_MAP=0

46	WRONG_REDUCE=0

47	File Input Format Counters

48	Bytes Read=81

49	File Output Format Counters

50	Bytes Written=35

计数器由其关联任务维护，并定期传到tasktracker，再由tasktracker传给 jobtracker.因此，计数器能够被全局地聚集。详见第 hadoop 权威指南第170页的“进度和状态的更新”小节。与其他计数器（包括用户定义的计数器）不同，内置的作业计数器实际上 由jobtracker维护，不必在整个网络中发送。  
一个任务的计数器值每次都是完整传输的，而非自上次传输之后再继续数未完成的传输，以避免由于消息丢失而引发的错误。另外，如果一个任务在作业执行期间失 败，则相关计数器值会减小。仅当一个作业执行成功之后，计数器的值才是完整可 靠的。  

3、用户定义的Java计数器

MapReduce允许用户编写程序来定义计数器，计数器的值可在mapper或reducer 中增加。多个计数器由一个Java枚举(enum)类型来定义，以便对计数器分组。一 个作业可以定义的枚举类型数量不限，各个枚举类型所包含的字段数量也不限。枚 举类型的名称即为组的名称，枚举类型的字段就是计数器名称。计数器是全局的。 换言之，MapReduce框架将跨所有map和reduce聚集这些计数器，并在作业结束 时产生一个最终结果。

Notice1：需要说明的是，不同的 hadoop 版本定义的方式会有些许差异。

（1）在0.20.x版本中使用counter很简单,直接定义即可，如无此counter，hadoop会自动添加此counter.

1	Counter ct = context.getCounter("INPUT_WORDS", "count");

2	ct.increment(1);

（2）在0.19.x版本中,需要定义enum  

1	enum MyCounter {INPUT_WORDS };

2	reporter.incrCounter(MyCounter.INPUT_WORDS, 1);

3	RunningJob job = JobClient.runJob(conf);

4	Counters c = job.getCounters();

5	long cnt = c.getCounter(MyCounter.INPUT_WORDS);

Notice2：使用计数器需要清楚的是它们都存储在jobTracker的内存里。Mapper/Reducer 任务序列化它们，连同更新状态被发送。为了运行正常且jobTracker不会出问题，计数器的数量应该在10-100个，计数器不仅仅只用来聚合MapReduce job的统计值。新版本的hadoop限制了计数器的数量，以防给jobTracker带来损害。你最不想看到的事情就是由于定义上百个计数器而使jobTracker宕机。
下面咱们来看一个计数器的实例（以下代码请运行在 0.20.1 版本以上）：

3.1 测试数据：

1	hello world 2013 mapreduce

2	hello world 2013 mapreduce

3	hello world 2013 mapreduce

3.2 代码：

001

/**

002	* Project Name:CDHJobs

003	* File Name:MapredCounter.java

004	* Package Name:tmp

005	* Date:2014-6-8下午2:12:48

006	* Copyright (c) 2014, decli#qq.com All Rights Reserved.

007

*

008

*/

009

010	package tmp;

011

012	import java.io.IOException;

013	import java.util.StringTokenizer;

014

015	import org.apache.commons.lang3.StringUtils;

016	import org.apache.hadoop.conf.Configuration;

017	import org.apache.hadoop.fs.Path;

018	import org.apache.hadoop.io.IntWritable;

019	import org.apache.hadoop.io.Text;

020	import org.apache.hadoop.mapreduce.Counter;

021	import org.apache.hadoop.mapreduce.CounterGroup;

022	import org.apache.hadoop.mapreduce.Counters;

023	import org.apache.hadoop.mapreduce.Job;

024	import org.apache.hadoop.mapreduce.Mapper;

025	import org.apache.hadoop.mapreduce.Reducer;

026	import org.apache.hadoop.mapreduce.lib.input.FileInputFormat;

027	import org.apache.hadoop.mapreduce.lib.output.FileOutputFormat;

028

029	public class WordCountWithCounter {

030

031	static enum WordsNature {

032	STARTS_WITH_DIGIT, STARTS_WITH_LETTER, ALL

033

}

034

035

/**

036	* The map class of WordCount.

037

*/

038	public static class TokenCounterMapper extends Mapper<Object, Text, Text, IntWritable> {

039

040	private final static IntWritable one = new IntWritable(1);

041	private Text word = new Text();

042

043	public void map(Object key, Text value, Context context) throws IOException, InterruptedException {

044	StringTokenizer itr = new StringTokenizer(value.toString());

045	while (itr.hasMoreTokens()) {

046	word.set(itr.nextToken());

047	context.write(word, one);

048

}

049

}

050

}

051

052

/**

053	* The reducer class of WordCount

054

*/

055	public static class TokenCounterReducer extends Reducer<Text, IntWritable, Text, IntWritable> {

056	public void reduce(Text key, Iterable<IntWritable> values, Context context) throws IOException,

057	InterruptedException {

058	int sum = 0;

059

060	String token = key.toString();

061	if (StringUtils.isNumeric(token)) {

062	context.getCounter(WordsNature.STARTS_WITH_DIGIT).increment(1);

063	} else if (StringUtils.isAlpha(token)) {

064	context.getCounter(WordsNature.STARTS_WITH_LETTER).increment(1);

065

}

066	context.getCounter(WordsNature.ALL).increment(1);

067

068	for (IntWritable value : values) {

069	sum += value.get();

070

}

071	context.write(key, new IntWritable(sum));

072

}

073

}

074

075

/**

076	* The main entry point.

077

*/

078	public static void main(String[] args) throws Exception {

079	Configuration conf = new Configuration();

080	Job job = new Job(conf, "WordCountWithCounter");

081	job.setJarByClass(WordCountWithCounter.class);

082	job.setMapperClass(TokenCounterMapper.class);

083	job.setReducerClass(TokenCounterReducer.class);

084	job.setOutputKeyClass(Text.class);

085	job.setOutputValueClass(IntWritable.class);

086	FileInputFormat.addInputPath(job, new Path("/tmp/dsap/rawdata/june/a.txt"));

087	FileOutputFormat.setOutputPath(job, new Path("/tmp/dsap/rawdata/june/a_result"));

088	int exitCode = job.waitForCompletion(true) ? 0 : 1;

089

090	Counters counters = job.getCounters();

091	Counter c1 = counters.findCounter(WordsNature.STARTS_WITH_DIGIT);

092	System.out.println("-------------->>>>: " + c1.getDisplayName() + ": " + c1.getValue());

093

094	// The below example shows how to get built-in counter groups that Hadoop provides basically.

095	for (CounterGroup group : counters) {

096	System.out.println("==========================================================");

097	System.out.println("* Counter Group: " + group.getDisplayName() + " (" + group.getName() + ")");

098	System.out.println("  number of counters in this group: " + group.size());

099	for (Counter counter : group) {

100	System.out.println("  ++++ " + counter.getDisplayName() + ": " + counter.getName() + ": "

101	+ counter.getValue());

102

}

103

}

104	System.exit(exitCode);

105

}

106

}

3.3 结果与计数器详解

运行结果下面会一并给出。Counter有"组group"的概念，用于表示逻辑上相同范围的所有数值。MapReduce job提供的默认Counter分为7个组，下面逐一介绍。这里也拿上面的测试数据来做详细比对，我将会针对具体的计数器，挑选一些主要的简述一下。 

001	... 前面省略 job 运行信息 xx 字 ...

002

ALL=4

003	STARTS_WITH_DIGIT=1

004	STARTS_WITH_LETTER=3

005	-------------->>>>: STARTS_WITH_DIGIT: 1

006	==========================================================

007	#MapReduce job执行所依赖的数据来自于不同的文件系统，这个group表示job与文件系统交互的读写统计

008	* Counter Group: File System Counters (org.apache.hadoop.mapreduce.FileSystemCounter)

009	number of counters in this group: 10

010	#job读取本地文件系统的文件字节数。假定我们当前map的输入数据都来自于HDFS，那么在map阶段，这个数据应该是0。但reduce在执行前，它 的输入数据是经过shuffle的merge后存储在reduce端本地磁盘中，所以这个数据就是所有reduce的总输入字节数。

011	++++ FILE: Number of bytes read: FILE_BYTES_READ: 159

012	#map的中间结果都会spill到本地磁盘中，在map执行完后，形成最终的spill文件。所以map端这里的数据就表示map task往本地磁盘中总共写了多少字节。与map端相对应的是，reduce端在shuffle时，会不断地拉取map端的中间结果，然后做merge并 不断spill到自己的本地磁盘中。最终形成一个单独文件，这个文件就是reduce的输入文件。

013	++++ FILE: Number of bytes written: FILE_BYTES_WRITTEN: 159447

014	++++ FILE: Number of read operations: FILE_READ_OPS: 0

015	++++ FILE: Number of large read operations: FILE_LARGE_READ_OPS: 0

016	++++ FILE: Number of write operations: FILE_WRITE_OPS: 0

017	# 整个job执行过程中，只有map端运行时，才从HDFS读取数据，这些数据不限于源文件内容，还包括所有map的split元数据。所以这个值应该比FileInputFormatCounters.BYTES_READ 要略大些。

018	++++ HDFS: Number of bytes read: HDFS_BYTES_READ: 198

019	#Reduce的最终结果都会写入HDFS，就是一个job执行结果的总量。

020	++++ HDFS: Number of bytes written: HDFS_BYTES_WRITTEN: 35

021	++++ HDFS: Number of read operations: HDFS_READ_OPS: 6

022	++++ HDFS: Number of large read operations: HDFS_LARGE_READ_OPS: 0

023	++++ HDFS: Number of write operations: HDFS_WRITE_OPS: 2

024	==========================================================

025	#这个group描述与job调度相关的统计

026	* Counter Group: Job Counters (org.apache.hadoop.mapreduce.JobCounter)

027	number of counters in this group: 5

028	#Job在被调度时，如果启动了一个data-local(源文件的幅本在执行map task的taskTracker本地)

029	++++ Data-local map tasks

030	#当前job为某些map task的执行保留了slot，总共保留的时间是多少

031	++++ FALLOW_SLOTS_MILLIS_MAPS/REDUCES

032	#所有map task占用slot的总时间，包含执行时间和创建/销毁子JVM的时间

033	++++ SLOTS_MILLIS_MAPS/REDUCES

034	# 此job启动了多少个map task

035	++++ Launched map tasks: TOTAL_LAUNCHED_MAPS: 1

036	# 此job启动了多少个reduce task

037	++++ Launched reduce tasks: TOTAL_LAUNCHED_REDUCES: 1

038	++++ Rack-local map tasks: RACK_LOCAL_MAPS: 1

039	++++ Total time spent by all maps in occupied slots (ms): SLOTS_MILLIS_MAPS: 3896

040	++++ Total time spent by all reduces in occupied slots (ms): SLOTS_MILLIS_REDUCES: 9006

041	==========================================================

042	#这个Counter group包含了相当多地job执行细节数据。这里需要有个概念认识是：一般情况下，record就表示一行数据，而相对地byte表示这行数据的大小是 多少，这里的group表示经过reduce merge后像这样的输入形式{"aaa", [5, 8, 2, …]}。

043	* Counter Group: Map-Reduce Framework (org.apache.hadoop.mapreduce.TaskCounter)

044	number of counters in this group: 20

045	#所有map task从HDFS读取的文件总行数

046	++++ Map input records: MAP_INPUT_RECORDS: 3

047	#map task的直接输出record是多少，就是在map方法中调用context.write的次数，也就是未经过Combine时的原生输出条数

048	++++ Map output records: MAP_OUTPUT_RECORDS: 12

049	# Map的输出结果key/value都会被序列化到内存缓冲区中，所以这里的bytes指序列化后的最终字节之和

050	++++ Map output bytes: MAP_OUTPUT_BYTES: 129

051	++++ Map output materialized bytes: MAP_OUTPUT_MATERIALIZED_BYTES: 159

052	# #与map task 的split相关的数据都会保存于HDFS中，而在保存时元数据也相应地存储着数据是以怎样的压缩方式放入的，它的具体类型是什么，这些额外的数据是 MapReduce框架加入的，与job无关，这里记录的大小就是表示额外信息的字节大小

053	++++ Input split bytes: SPLIT_RAW_BYTES: 117

054	#Combiner是为了减少尽量减少需要拉取和移动的数据，所以combine输入条数与map的输出条数是一致的。

055	++++ Combine input records: COMBINE_INPUT_RECORDS: 0

056	# 经过Combiner后，相同key的数据经过压缩，在map端自己解决了很多重复数据，表示最终在map端中间文件中的所有条目数

057	++++ Combine output records: COMBINE_OUTPUT_RECORDS: 0

058	#Reduce总共读取了多少个这样的groups

059	++++ Reduce input groups: REDUCE_INPUT_GROUPS: 4

060	#Reduce端的copy线程总共从map端抓取了多少的中间数据，表示各个map task最终的中间文件总和

061	++++ Reduce shuffle bytes: REDUCE_SHUFFLE_BYTES: 159

062	#如果有Combiner的话，那么这里的数值就等于map端Combiner运算后的最后条数，如果没有，那么就应该等于map的输出条数

063	++++ Reduce input records: REDUCE_INPUT_RECORDS: 12

064	#所有reduce执行后输出的总条目数

065	++++ Reduce output records: REDUCE_OUTPUT_RECORDS: 4

066	#spill过程在map和reduce端都会发生，这里统计在总共从内存往磁盘中spill了多少条数据

067	++++ Spilled Records: SPILLED_RECORDS: 24

068	#每个reduce几乎都得从所有map端拉取数据，每个copy线程拉取成功一个map的数据，那么增1，所以它的总数基本等于 reduce number * map number

069	++++ Shuffled Maps : SHUFFLED_MAPS: 1

070	# copy线程在抓取map端中间数据时，如果因为网络连接异常或是IO异常，所引起的shuffle错误次数

071	++++ Failed Shuffles: FAILED_SHUFFLE: 0

072	#记录着shuffle过程中总共经历了多少次merge动作

073	++++ Merged Map outputs: MERGED_MAP_OUTPUTS: 1

074	#通过JMX获取到执行map与reduce的子JVM总共的GC时间消耗

075	++++ GC time elapsed (ms): GC_TIME_MILLIS: 13

076	++++ CPU time spent (ms): CPU_MILLISECONDS: 3830

077	++++ Physical memory (bytes) snapshot: PHYSICAL_MEMORY_BYTES: 537718784

078	++++ Virtual memory (bytes) snapshot: VIRTUAL_MEMORY_BYTES: 7365263360

079	++++ Total committed heap usage (bytes): COMMITTED_HEAP_BYTES: 2022309888

080	==========================================================

081	#这组内描述Shuffle过程中的各种错误情况发生次数，基本定位于Shuffle阶段copy线程抓取map端中间数据时的各种错误。

082	* Counter Group: Shuffle Errors (Shuffle Errors)

083	number of counters in this group: 6

084	#每个map都有一个ID，如attempt_201109020150_0254_m_000000_0，如果reduce的copy线程抓取过来的元数据中这个ID不是标准格式，那么此Counter增加

085	++++ BAD_ID: BAD_ID: 0

086	#表示copy线程建立到map端的连接有误

087	++++ CONNECTION: CONNECTION: 0

088	#Reduce的copy线程如果在抓取map端数据时出现IOException，那么这个值相应增加

089	++++ IO_ERROR: IO_ERROR: 0

090	#map端的那个中间结果是有压缩好的有格式数据，所有它有两个length信息：源数据大小与压缩后数据大小。如果这两个length信息传输的有误(负值)，那么此Counter增加

091	++++ WRONG_LENGTH: WRONG_LENGTH: 0

092	#每个copy线程当然是有目的:为某个reduce抓取某些map的中间结果，如果当前抓取的map数据不是copy线程之前定义好的map，那么就表示把数据拉错了

093	++++ WRONG_MAP: WRONG_MAP: 0

094	#与上面描述一致，如果抓取的数据表示它不是为此reduce而准备的，那还是拉错数据了。

095	++++ WRONG_REDUCE: WRONG_REDUCE: 0

096	==========================================================

097	#这个group表示map task读取文件内容(总输入数据)的统计

098	* Counter Group: File Input Format Counters (org.apache.hadoop.mapreduce.lib.input.FileInputFormatCounter)

099	number of counters in this group: 1

100	# Map task的所有输入数据(字节)，等于各个map task的map方法传入的所有value值字节之和。

101	++++ Bytes Read: BYTES_READ: 81

102	==========================================================

103	##这个group表示reduce task输出文件内容(总输出数据)的统计

104	* Counter Group: File Output Format Counters (org.apache.hadoop.mapreduce.lib.output.FileOutputFormatCounter)

105	number of counters in this group: 1

106	++++ Bytes Written: BYTES_WRITTEN: 35

107	==========================================================

108	# 自定义计数器的统计

109	* Counter Group: tmp.WordCountWithCounter$WordsNature (tmp.WordCountWithCounter$WordsNature)

110	number of counters in this group: 3

111	++++ ALL: ALL: 4

112	++++ STARTS_WITH_DIGIT: STARTS_WITH_DIGIT: 1

113	++++ STARTS_WITH_LETTER: STARTS_WITH_LETTER: 3