# ifcmonitor

**Repository Path**: brucekankan/ifcmonitor

## Basic Information

- **Project Name**: ifcmonitor
- **Description**: 可以监控系统相关信息、JVM相关信息及WEB相关信息


- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 32
- **Forks**: 10
- **Created**: 2016-09-10
- **Last Updated**: 2024-03-17

## Categories & Tags

**Categories**: nms

**Tags**: None

## README

# infcn监控组件

	监控组件依赖的jar包有： fastjson-1.2.16.jar、log4j-1.2.17.jar，是一个集前端UI、后台服务框架于一身的轻量级组件，当前版本V1.0.0。

# maven 编译：
	`clean compile assembly:assembly package`

# maven配置
```xml

	<dependency>
	  <groupId>cn.com.infcn</groupId>
	  <artifactId>ifcmonitor</artifactId>
	  <version>1.0.0</version>
	  <classifier>all</classifier>
	</dependency>
```

# web.xml中配置信息如下：

```xml

	<listener>
		<listener-class>cn.com.infcn.monitor.listener.IFCSessionListener</listener-class>
	</listener>
	
	<filter>
		<filter-name>monitorFilter</filter-name>
		<filter-class>cn.com.infcn.monitor.filter.MonitoringFilter</filter-class>
		<init-param>
			<param-name>filter-regex</param-name>
			<param-value>*infcn*</param-value>
		</init-param>
		<init-param>
			<param-name>filter-suffix</param-name>
			<param-value>jpg,gif,png,ico,jpeg,css,js</param-value>
		</init-param>
		
		<init-param>
			<param-name>dataPath</param-name>
			<param-value>d:/data/</param-value>
		</init-param>
		<init-param>
			<param-name>excludeType</param-name>
			<param-value>httpsession</param-value>
		</init-param>
		<init-param>
			<param-name>includeType</param-name>
			<param-value>os,user,jvmmemmgr,jvmrt,jvmthd</param-value>
		</init-param>
		<init-param>
			<param-name>monitorInterval</param-name>
			<param-value>60</param-value>
		</init-param>
		<init-param>
			<param-name>isOpenHttpRequest</param-name>
			<param-value>true</param-value>
		</init-param>
	</filter>
	<filter-mapping>
		<filter-name>monitorFilter</filter-name>
		<url-pattern>*</url-pattern>
	</filter-mapping>
```

# listener说明：
	如果需要监控httprequest，则配置listener，如果不需要监控，则不需要配置linstener。
	
# 监控sql说明：
	如果需要监控系统sql执行情况，则需要使用alibaba的druid的dataSource数据源	

# filter中初始化参数说明：	
	filter可以配置的参数总共6个，都可以缺省
	1.filter-regex
		httprequest类型监控,过滤不监控的url正则格式
		例如：httprequest不监控url中保护“infcn”字符串的url
		<init-param>
			<param-name>filter-regex</param-name>
			<param-value>*infcn*</param-value>
		</init-param>
	2.filter-suffix
		httprequest类型监控,过滤指定后缀的资源类型
		如果不配置此参数，则默认过滤的类型为：jpg,gif,png,ico,jpeg,css,js
		如果配置则按照配置的后缀类型进行过滤。
		<init-param>
			<param-name>filter-suffix</param-name>
			<param-value>jpg,gif,png,ico,jpeg,css,js</param-value>
		</init-param>
	3.dataPath
		监控历史数据存储路径。
		默认路径：项目根路径/monitorlog/(建议修改此路径，防止每次重新部署把此文件覆盖或删除)
		配置实例如下：
		<init-param>
			<param-name>dataPath</param-name>
			<param-value>d:/data/</param-value>
		</init-param>
	4.excludeType
		不进行监控数据存储文件的类型
		这几种【jvmmem,jvmos,httpsession,cpu,sys,fs,directory,jvmgc,jvmclassloading,jvmcompilation,jvmmempool,net】监控是默认开启的，如果不想归档存储到文件则进行如下配置：
		<init-param>
			<param-name>excludeType</param-name>
			<param-value>httpsession</param-value>
		</init-param>
	5.includeType
		需要进行监控存储的文件类型
		这几种【os,user,jvmmemmgr,jvmrt,jvmthd】监控默认不开启归档存储，如果想归档存储到文件则进行如下配置：
		<init-param>
			<param-name>includeType</param-name>
			<param-value>os,user,jvmmemmgr,jvmrt,jvmthd</param-value>
		</init-param>
	6.monitorInterval
		监控信息存储间隔时间
		每间隔60秒存档一下监控信息，配置如下：
		<init-param>
			<param-name>monitorInterval</param-name>
			<param-value>60</param-value>
		</init-param>
	7.monitorInterval
		是否开启httprequest监控
		默认是开启状态
		<init-param>
			<param-name>isOpenHttpRequest</param-name>
			<param-value>false</param-value>
		</init-param>
		
		
# 监控访问地址：
	http://127.0.0.1:port/xxxx/ifcmonitor/index.html
	如果要内嵌到项目页面里面，则可加上topnav=0参数：
	http://127.0.0.1:port/xxxx/ifcmonitor/index.html&topnav=0
	如果要监控多台服务器，配置如下：
	http://127.0.0.1:port/xxxx/ifcmonitor/index.html?servers=localhost+http://127.0.0.1:port/ifcmonitor/,192.168.10.106+http://192.168.10.106:8080/ifcmonitor/