【概述】
一个成熟的项目通常都会自带提供metric,反映运行时内部的各个信息,以方便进行监控运维。hadoop也不例外,通过jmx可以查看内部各个metrics信息,本文就来聊聊hdfs的metrics。
【Metrics指标查询】
hdfs的metrics通过jmx获取,具体可以通过http的方式获取,也可以通过命令行的方式来获取。
通过http的方式获取,可以全量获取所有jmx的指标项,也可以精确获取指定组件服务的指定模块的指定指标项。
- 对于全量获取,其请求的URL格式为:
http://$IP:$PORT/jmx
其中IP、PORT为对应组件服务http的监听ip、端口。以nn为例,端口默认为50070。
- 而对于精准获取,其请求的URL格式为:
http://$IP:$PORT/jmx?get=MXBeanName::AttributeName
其中MXBeanName的格式为:"Hadoop:service=$ServiceName,name=$Name"
ServiceName为组件服务的名称,对于hdfs而言就是NameNode、DataNode、JournalNode;对于yarn而言就是ResourceManager、NodeManager
Name是服务内部不同模块的名称,详见后面的指标详解。
AttributeName则是模块中的具体属性(指标项)。
精准获取的返回结果以JSON格式描述,具体如下代码所示:
{
"beans": [ {
"name" : "MXBeanName",
"AttriuteName" : xxx,
...
} ]
}
如果参数格式不正确,或者找不到对应的MXBean、Attribute,则返回空或者返回包含错误信息的JSON字符串,例如:
// 参数格式不正确
{
"result" : "ERROR",
"message" : "query format is not as expected."
}
// 找不到bean
{
"beans" : []
}
// 找不到Attribute
{
"beans" : [ {
"name" : "Hadoop:service=NameNode,name=RpcActivityForPort9000",
"modulerType" : "RpcActivityForPort9000",
"result" : "ERROR",
"message" : "No attribute with name GetBlockLocationsNumOps was found."
} ]
}
通过命令行获取,其命令为:
hdfs jmxget -server $IP -port $PORT -service NameNode
ip仍旧是组件服务的IP,port则是指定jmi监听端口。
这里就不举例贴代码了,有兴趣的可以实际测试验证。
【概述】
知道了怎么查询(获取)jmx指标后,接下来自然是了解每个指标项的具体含义。这里主要针对namenode组件服务,罗列内部不同模块的主要指标项。
- RpcDetailedActivityForPortXXX
模块名称后面的XXX为具体的rpc监听端口,例如默认的9000。因此如果有多个rpc监听端口,也就会有多个这样的模块,每个端口一个。
该模块下的指标主要为客户端和datanode不同rpc请求的统计信息,包括请求次数以及平均响应时长。
指标项 | 说明 |
RegisterDatanodeNumOps | 接收到的DN的注册次数 |
RegisterDatanodeAvgTime | dn注册请求的平均处理耗时 |
SendHeartbeatNumOps | 接收到的dn心跳次数 |
SendHeartbeatAvgTime | 心跳请求的平均处理耗时 |
TransitionToActiveNumOps | HA切换的次数 |
TransitionToActiveAvgTime | HA切换的平均耗时 |
BlockReportNumOps | 全量块汇报的次数 |
BlockReportAvgTime | 全量块汇报的平均处理耗时 |
BlockReceivedAndDeletedAvgTime | 增量块汇报的次数 |
BlockReceivedAndDeletedNumOps | 增量块汇报的平均处理耗时 |
AddBlockNumOps | 申请新block请求的次数 |
AddBlockAvgTime | 申请新block请求的平均处理耗时 |
这里只罗列了部分请求,但从上面罗列的指标项可以看出来,针对每类RPC请求,都有两个指标,一个是次数(NumOps),一个是该类请求的平均处理耗时(AvgTime)。
- RpcActivityForPortXXX
XXX同样表示具体的rpc监听端口,但与上面提到的rpc模块不同,该模块描述更通用的指标项,也就是rpc服务自身的一些信息,例如监听端口的首发字节数、累计rpc请求数、rpc请求的认证、鉴权情况、rpc队列的情况、以及监听端口的连接情况等信息。
指标项 | 说明 |
ReceivedBytes | 该端口累计接收数据的大小(单位:字节) |
SentBytes | 该端口累计发送数据的大小(单位:字节) |
RpcQueueTimeNumOps | rpc累计请求数 |
RpcQueueTimeAvgTime | rpc请求在队列中的平均时长(从接收到被处理过程中在队列中的时长) |
RpcProcessingTimeNumOps | rpc累计请求数 |
RpcPorcessingTimeAvgTime | rpc请求的平均处理耗时 |
RpcAuthenticationFailures | 认证失败的rpc请求个数 |
RpcAuthenticationSuccess | 认证成功的rpc请求个数 |
RpcAuthorizationFailures | 鉴权失败的rpc请求个数 |
RpcAuthorizationSuccesses | 鉴权成功的rpc请求个数 |
RpcClientBackOff | rpc队列满导致的请求回退个数 在rpc的默认调度下,都是采用队列满,就死等的方式 而使用org.apache.hadoop.ipc.DecayRpcScheduler,就会出现回退的情况 |
RpcSlowCalls | 慢请求的个数 所谓慢请求指的是:采样率大于1024,并且本次请求的处理时长带平均值+加权平均值 |
NumOpenConnections | 当前的连接数 |
CallQueueLength | 当前请求队列的长度,即队列中的rpc请求个数 |
NumDroppedConnections | 累计丢弃的连接数 |
- StartupProgress
记录nn启动的各个阶段的信息、包括各阶段的耗时、完成度、以及各个阶段自身的一些数据,例如从fsimage中加载的inode数,从editlog中加载的事务数等,详细说明如下:
指标项 | 说明 |
ElapsedTime | 启动阶段的总耗时 |
PercentComplete | 启动的总完成度,1.0表示100% |
LoadingFsImageCount | 从Fsimage中加载的inode的个数 |
LoadingFsImageElapsedTime | fsimage加载阶段的总耗时(单位:毫秒) |
LoadingFsImageTotal | 从fsimage中加载的inode的总数 |
LoadingFsImagePercentComplete | 加载fsimage的完成度 |
LoadingEditsCount | 加载editlog文件的个数,同样1.0表示100% |
LoadingEditsElapsedTime | editlog加载阶段的总耗时(单位:毫秒) |
LoadingEditsTotal | 从editlog中加载的事务总数 |
LoadingEditsPercentComplete | 加载editlog的完成度 |
SavingCheckpointCount | checkpoing的保存个数 |
SavingCheckpointElapsedTime | 保存checkpoint的总耗时 |
SavingCheckpointTotal | checkpoint的保存个数 |
SavingCheckpointPercentComplete | 保存checkpoint的完成度 |
SafeModeCount | 块汇报的块个数 |
SafeModeElapsedTime | 安全模式的总耗时 |
SafeModeTotal | 块汇报的块个数 |
SafeModePercentComplete | 安全模式的完成度 |
- FSNamesystem
主要记录文件系统相关的信息、包括文件数、块的数目、以及对块进行分类后的信息、锁等待的信息(对文件系统的操作都会涉及一个全局锁),其他还包括dn节点的信息等
指标项 | 说明 |
MissingBlocks | 丢失的块的个数 |
MissingReplOneBlocks | 副本数为1并且块丢失的块个数 |
ExpiredHeartbeats | dn累计心跳超时的次数 |
LastCheckpointTime | 上一次执行checkpoint的时间 |
TotalLoad | 当前总的连接数 |
LockQueueLength | 当前等锁(FSNameSystemLock)的线程个数 |
BlocksTotal | 当前已分配的block数 |
NumFilesUnderConstruction | 当前处于underConstruction的文件数 |
NumActiveClients | 当前持有租约的活跃用户数 |
PendingReplicationBlocks | 当前等待复制的块的个数 |
UnderReplicatedBlocks | 实际副本数小于副本配置数的块的个数 |
PendingDeletionBlocks | 当前等待删除的块的个数 |
这里只罗列了部分指标,但是可以看出来,大部分是文章《5000字12张图讲解nn内存中的元数据信息》中介绍过的内存中保存元数据信息。
- FSNamesystemState
文件系统的状态、包括总的容量、可用容量、剩余容量,以及dn节点信息、块信息等,和上面介绍的FSNamesystem会有大量重复的指标项。
指标项 | 说明 |
CapacityTotal | HDFS总的总量大小,由dn上报汇总得出 |
CapacityUsed | hdfs当前已使用容量大小 |
CapacityRemaining | hdfs当前剩余容量大小 |
NumLiveDataNodes | 活跃的(心跳正常)dn节点个数 |
NumDeadDataNodes | 心跳异常离线的dn节点个数 |
PendingReplicationBlocks | 当前等待复制的块的个数 |
- NamenodeActivity
nn的活跃信息,主要还是从客户端的角度进行统计,因此会和RpcDetailedActivityForPortXXX有不少相同的指标项。
指标项 | 说明 |
FilesCreated | 文件创建个数 |
FilesAppended | 文件追加写次数 |
BlockReceivedAndDeleteOps | 增量块汇报次数 |
StorageBlockReportOps | 块汇报次数 |
BlockOpsQueued | 全量块汇报请求等待处理的个数(对于全量块汇报,在nn内部是串行处理的,因此其他的增量块汇报请求会先进入到一个队列中等待) |
- NamenodeStatus
主要记录nn节点自身的一些状态信息,例如ip,端口、角色,状态等
指标项 | 说明 |
NNRole | nn的角色(Active或Standby |
HostAndPort | 主要是rpc的监听ip端口 |
LastHATransitionTime | 上一次进行HA切换的时间 |
- NameNodeInfo
指标项 | 说明 |
ClusterId | 集群的uuid信息 |
BlockPoolId | 块池的id |
NameDirStatus | nn配置的用于持久化元数据的卷(目录)的信息 |
除了这些之外,还有一些和其他重复的指标项。
【总结】
来小结一下,本文主要介绍了hdfs的jmx的相关信息,包括两种获取方式,以及一些详细指标项的说明,还可以进行扩展的内容例如,如何对接prometheus、重点应该关注监控的指标项等。