Cloudinsight Agent 在 4.7.0 版本,将 Agent 名称从 oneapm-ci-agent 更换至 cloudinsight-agent。若您在使用过程中,出现无法正常工作的情况,请加入售后群:433349863
X

Tomcat

Tomcat 是由 Apache 软件基金会下属的 Jakarta 项目开发的一个 Servlet 容器,按照 Sun Microsystems 提供的技术规范,实现了对 Servlet 和 JavaServer Page(JSP)的支持,并提供了作为 Web 服务器的一些特有功能,如 Tomcat 管理和控制平台、安全域管理和 Tomcat 阀等。

Cloudinsight 通过 JMX 来收集 Tomcat 数据,可视化传输字节数, servlet 容器请求时间等数据。


性能指标

Cloudinsight 采集 Tomcat 以下性能指标:

指标 单位 具体含义
tomcat.bytes_rcvd bytes/second 每秒接收的字节数
tomcat.bytes_sent bytes/second 每秒发送的字节数
tomcat.cache.access_count gets/second 每秒访问缓存的次数
tomcat.cache.hits_count hits/second 每秒缓冲命中的次数
tomcat.error_count errors/second 发生错误的请求数
tomcat.jsp.count pages/second web 模块中加载的JSP数量
tomcat.jsp.reload_count pages/second web 模块中重新加载的JSP数量
tomcat.max_time milliseconds 最长的请求处理时间 (milliseconds)
tomcat.processing_time 每秒所有请求的处理时间之和
tomcat.request_count requests/second 每秒总请求数
tomcat.servlet.error_count errors/second servlet 接收的错误请求数 /s
tomcat.servlet.processing_time 每秒经过 servlet 的所有请求的处理时间之和
tomcat.servlet.request_count requests/second 每秒经过 servlet 的总请求数
tomcat.threads.busy threads 正在使用的线程数
tomcat.threads.count threads 当前线程池的线程数
tomcat.threads.max threads 线程池最大可以产生的线程数

配置 Tomcat 监控

启动 JMX Remote

Cloudinsight Agent 通过 JMX 获取 Tomcat 中的性能指标,所以确保 JMX Remote 是 enabled状态。

由于每个实体最多可以监控 350 个性能指标,所以您需要按照下方的配置方法,修改配置文件来确定自己需要哪些指标。

有关 JMX 采集方法,请查阅 JMX 远程监控

更多信息,请查阅 Apache Tomcat 官方手册

编辑配置文件

编辑配置文件 conf.d/tomcat.yaml,使 Cloudinsight Agent 可以与 Tomcat 通信。

instances:
  - host: localhost
    port: 7199
    user: username
    password: password
    name: tomcat_instance

# List of metrics to be collected by the integration

init_config:
  conf:
    - include:
        type: ThreadPool
        attribute:
          maxThreads:
            alias: tomcat.threads.max
            metric_type: gauge
          currentThreadCount:
            alias: tomcat.threads.count
            metric_type: gauge
          currentThreadsBusy:
            alias: tomcat.threads.busy
            metric_type: gauge
    - include:
        type: GlobalRequestProcessor
        attribute:
          bytesSent:
            alias: tomcat.bytes_sent
            metric_type: counter
          bytesReceived:
            alias: tomcat.bytes_rcvd
            metric_type: counter
          errorCount:
            alias: tomcat.error_count
            metric_type: counter
          requestCount:
            alias: tomcat.request_count
            metric_type: counter
          maxTime:
            alias: tomcat.max_time
            metric_type: gauge
          processingTime:
            alias: tomcat.processing_time
            metric_type: counter
    - include:
        j2eeType: Servlet
        attribute:
          processingTime:
            alias: tomcat.servlet.processing_time
            metric_type: counter
          errorCount:
            alias: tomcat.servlet.error_count
            metric_type: counter
          requestCount:
            alias: tomcat.servlet.request_count
            metric_type: counter
    - include:
        type: Cache
        accessCount:
          alias: tomcat.cache.access_count
          metric_type: counter
        hitsCounts:
          alias: tomcat.cache.hits_count
          metric_type: counter
    - include:
        type: JspMonitor
        jspCount:
          alias: tomcat.jsp.count
          metric_type: counter
        jspReloadCount:
          alias: tomcat.jsp.reload_count
          metric_type: counter

重启 Agent

重启 Cloudinsight Agent,使配置生效。

您也可以通过查看 Agent Info 信息,来验证配置是否成功。当出现以下信息,则代表安装成功。

Checks
======

[...]

tomcat
------
  - instance #0 [OK]
  - Collected 8 metrics & 0 events

有关 Agent Info 信息的查看,请访问帮助中心,查看 Cloudinsight Agent 常用操作


默认标签

Cloudinsight 采集 Tomcat 以下默认主机标签:

标签种类 标签含义
instance 实例名称(例如 “tomcat_demo")
jmx_domain JMX域(例如 "Catalina")
type 指标类型(ThreadPool, GlobalRequestProcessor, Servlet, Cache, JspMonitor等)

常见问题


如果您对 Cloudinsight 感兴趣,可以选择试用我们的产品,只需要点击下面的按钮免费注册即可。


立即注册 Cloudinsight