White Elephant 是一个Hadoop日志收集器和展示器,它提供了用户角度的Hadoop集群可视化。White Elephant 是全球最大的职业社交网站Linkedin开发的一套分析Hadoop作业日志的系统,完全开源。代码在GitHub上的链接https://github.com/linkedin/white-elephant。
不过White Elephant当前只支持hadoop1.0系列的jobhistory解析,暂时不支持hadoop2.0系列的版本。
你可以在GitHub上的 White Elephant项目check out代码,或者下载最新的snapshot版本。
可以使用一些测试数据尝试这个服务:
cd server
ant
./startup.sh
然后访问 http://localhost:3000。它可能需要几分钟的时间加载测试数据。
服务端是一个JRuby的web应用,在生产环境中它可以部署到tomcat中,然后可以直接从Hadoop中读取收集到的数据。数据存储在 HyperSQL提供的 in-memory 类型的数据库中,图表由 Rickshaw提供。
开始使用这个服务之前,首先需要设置环境:
cd server
ant
默认会做以下的事情:
这时候你可以通过下面的命令启动服务:
./startup.sh
你可以访问 http://localhost:3000,它可能需要几分钟的时间加载测试数据。
这里使用trinidad在开发环境中运行JRuby 网页应用。由于这是在开发模式,应用假设本地数据(在config.yml中指定的路径)可以使用。
服务端的配置在config.yml中指定,你可以在sample_config.yml中查看示例。
当通过./startup.sh 运行在开发模式中时,sample_config.yml会被使用,并且它和 local目录下的配置一起生效。这里唯一的可配置参数是file_pattern,它指定了从本地加载数据的目录。
当打包成WAR并运行在生产模式下,使用hadoop下指定的配置,假设收集到的数据可用,下述配置必须指定:
file_pattern: 从Hadoop加载使用文件的全局的文件模式。
libs: 包含Hadoop JAR文件的目录 (加到classpath)。
conf_dir: 包含Hadoop配置的目录(加到 classpath)。
principal: 用户名用于访问安全的Hadop。
keytab: keytab 文件的路径,用于访问安全的Hadoop 。
White Elephant并不基于某个特定版本的Hadoop,所以JARs并不会打包到WAR包中。因此配置中必须指定到Hadoop JARs的路径。
编译一个可以部署到tomcat的WAR文件:
ant war -Dconfig.path=<path-to-config>
你指定的配置文件config.yml将一起打包到WAR文件中。
hadoop/scripts/statsupload.pl脚本可以用于上传Hadoop日志文件到HDFS,主要就可以被处理了。
一共两个Hadoop作业,都被一个作业执行器管理,并追踪需要的工作。
第一个作业是Hadoop日志解析器,它从存储在Hadoop中的文件读日志,解析出相应的信息,并以Avro的格式写出去。
第二个作业读取Avro格式的日志数据,并以小时为单位聚合,数据以Avro格式写出去,它本质上建立一共数据立方体,可以很容易的被wen应用加载到DB和查询。
示例配置存储在 hadoop/config/jobs:
base.properties: 包括大多配置。
white-elephant-full-usage.job: 处理所有日志时被使用的作业文件。
white-elephant-incremental-usage.job: 处理增量日志时需要的作业文件。
base.properties文件包括White Elephant指定的配置,也包括Hadoop配置。所有Hadoop配置参数以hadoop-conf开头。两个job的配置项相同,当然其值需要根据作业配置。
在base.properties中存在一个参数log.root。这是解析程序查找Hadoop日志的根目录。解析作业假设日志存储在Hadoop每天的目录下,目录格式如下:
<logs.root>/<cluster-name>/daily/<yyyy>/<MMdd>
例如,2013年1月23日的目录格式为:
/data/hadoop/logs/prod/daily/2013/0123
创建一个包含所有文件的zip包可以通过下述命令生成:
ant zip -Djob.config.dir=<path-to-job-config-dir>
job.config.dir应该包含.properties和.job文件。
如果你使用 Azkaban作为你的作业调度器,则zip文件可以工作到base.propreties中指定的配置的时间。
解压zip文件后可以运行run.sh脚本,这需要配置两个环境变量:
运行全量job:
./run.sh white-elephant-full-usage.job
运行增量job:
./run.sh white-elephant-incremental-usage.job
增量作业只处理增量数据,全量作业处理所有数据。