Skip to content

Tomcat Integration

Infrastructure Integration

Instructions

Follow the installation guide below for your given collector environment.

During installation, use the configuration section below as reference.

After installation, the infrastructure datasources in the table below will be available in the AOC.

Installation Guide

Installing this integration consists of creating a yaml file in the filesystem of your collectors. Click below for instructions on how to do so for your given collectors environment.

Docker

Kubernetes

Mesos-Marathon

Debian

Ubuntu

RHEL/CentOS

Configuration

Edit tomcat.yaml to configure the agent. Please refer tomcat.yaml for all available configuration options.

    instances:
      - host: localhost
        port: 9012

    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

Infrastructure Datasources

Datasource Available Aggregations Unit Description
tomcat.threads.max avg max min sum thread The maximum number of allowed worker threads.
tomcat.threads.count avg max min sum thread The number of threads managed by the thread pool.
tomcat.threads.busy avg max min sum thread The number of threads that are in use.
tomcat.bytes_sent avg max min sum byte/second Bytes per second sent by all the request processors.
tomcat.bytes_rcvd avg max min sum byte/second Bytes per second received by all request processors.
tomcat.error_count avg max min sum error/second The number of errors per second on all request processors.
tomcat.request_count avg max min sum request/second The number of requests per second across all request processors.
tomcat.max_time avg max min sum millisecond The longest request processing time (in milliseconds).
tomcat.processing_time avg max min sum The sum of request processing times across all requests handled by the request processors (in milliseconds) per second.
tomcat.servlet.processing_time avg max min sum The sum of request processing times across all requests to the servlet (in milliseconds) per second.
tomcat.servlet.error_count avg max min sum error/second The number of erroneous requests received by the servlet per second.
tomcat.servlet.request_count avg max min sum request/second The number of requests received by the servlet per second.
tomcat.cache.access_count avg max min sum get/second The number of accesses to the cache per second.
tomcat.cache.hits_count avg max min sum hit/second The number of cache hits per second.
tomcat.jsp.count avg max min sum page/second The number of JSPs per second that have been loaded in the web module.
tomcat.jsp.reload_count avg max min sum page/second The number of JSPs per second that have been reloaded in the web module.