Resin Monitoring Extension

This extension works only with the standalone machine agent.

 

Use Case

Resin is a high-performance, scalable Java application server. This eXtension monitors Resin instance and collects useful statistics exposed through MBeans and reports to AppDynamics Controller.

 

Prerequisites

To use this extension please configure JMX in your instance. For information on enabling JMX, please refer to http://caucho.com/resin-4.0/admin/resin-admin-console.xtp#JMXConsole.

Example Configuration

    <server-multi id-prefix="app-" address-list="${app_servers}" port="6800">
      <jvm-arg>-Dcom.sun.management.jmxremote.port=9999</jvm-arg>
      <jvm-arg>-Dcom.sun.management.jmxremote.ssl=false</jvm-arg>
      <jvm-arg>-Dcom.sun.management.jmxremote.password.file=/home/AppDynamics/Resin/jmxremote.password</jvm-arg>
    </server-multi>

Installation

  1. Download and Unzip ResinMonitor.zip to <MACHINE_AGENT_HOME>/monitors/
  2. Configure the extension by referring to the below section.
  3. Restart the Machine Agent.

In the AppDynamics Metric Browser, look for: Application Infrastructure Performance | <Tier> | Custom Metrics | Resin in case of default metric path

 

Configuration

Note : Please make sure not to use tab (\t) while editing yaml files. You can validate the yaml file using a yaml validator

  1. Configure the Resin Extension by editing the config.yml file in <MACHINE_AGENT_HOME>/monitors/ResinMonitor/.
  2. Specify the Resin instance host, JMX port, username and password in the config.yml. Configure the MBeans for this extension to report the metrics to Controller. By default, "resin" is the domain name. Specify the keyproperty 'type' of MBeans you are interested. Resin MBean ObjectName is of the form 'resin:name=name,type=type,Host=name,WebApp=name'. Please refer here for detailed Resin MBean Names. You can also add excludePatterns (regex) to exclude any metric tree from showing up in the AppDynamics controller.

    For eg.

        # Resin instance
        server:
            host: "localhost"
            port: 9999
            username: "monitorRole"
            password: "admin"
    
        # Resin MBeans
          mbeans:
              domainName: "resin"
              types: [CacheStore,ClusterServer,ConnectionPool,Memory,Server,ThreadPool,TransactionManager,WebApp]
              # Uses regular expressions to match the pattern
              excludePatterns: [.*ClusterIndex$]
    
          #prefix used to show up metrics in AppDynamics
          metricPrefix:  "Custom Metrics|Resin|"
    
    

    In the above config file, metrics are being pulled from the specified MBeans. Note that the patterns mentioned in the "excludePatterns" will be excluded from showing up in the AppDynamics Metric Browser.

  3. Configure the path to the config.yml file by editing the in the monitor.xml file in the <MACHINE_AGENT_HOME>/monitors/ResinMonitor/ directory. Below is the sample

     <task-arguments>
         <!-- config file-->
         <argument name="config-file" is-required="true" default-value="monitors/ResinMonitor/config.yml" />
          ....
     </task-arguments>
    

 

Metrics

  • CacheStore: DataCount, LoadCountTotal, LoadFailCountTotal, MnodeCount, ObjectCount, SaveCountTotal, SaveFailCountTotal
  • ClusterServer: MessageQueueSize, ServerCpuLoadAvg, ConnectionKeepaliveCountTotal, ConnectionBusyCountTotal, IdleTime, Weight, ClusterIdleTime, SocketTimeout, ConnectionFailCountTotal, ConnectTimeout, ClusterIndex, Port, RecoverTime, LatencyFactor, ConnectionNewCountTotal, WarmupTime, ConnectionActiveCount, ConnectionMin, ConnectionIdleCount, MessageQueueLargeSize
  • ConnectionPool: MinIdleCount, MaxOverflowConnections, MaxConnections, MaxPoolTime, ConnectionFailCountTotal, MaxCreateConnections, MaxActiveTime, ConnectionCreateCount, MaxIdleTime, ConnectionActiveCount, ConnectionWaitTime, ConnectionIdleCount, MaxIdleCount, ConnectionCreateCountTotal, ConnectionCount, ConnectionCountTotal
  • Memory: EdenFree, TenuredFree, TenuredMax, TenuredUsed, TenuredCommitted, PermGenMax, SurvivorCommitted, GarbageCollectionTime, EdenMax, PermGenCommitted, GarbageCollectionCount, EdenUsed, CodeCacheFree, CodeCacheMax, SurvivorFree, PermGenFree, CodeCacheCommitted, EdenCommitted, SurvivorMax, SurvivorUsed, CodeCacheUsed, PermGenUsed
  • Server: KeepaliveCountTotal, MemoryFreeMin, CpuLoadAvg, RequestCountTotal, RuntimeMemoryFree, ThreadKeepaliveCount, RequestWriteBytesTotal, Uptime, ThreadActiveCount, RuntimeMemory, HeaderSizeMax, UrlLengthMax, SelectKeepaliveCount, InvocationCacheMissCount, HeaderCountMax, nvocationCacheHitCount, PermGenFreeMin, ServerIndex, SendfileCountTotal, RequestTimeTotal, RequestReadBytesTotal, ClientDisconnectCountTotal, ShutdownWaitMax
  • ThreadPool: ThreadIdleMin, ThreadIdleMax, ThreadPriorityMin, ThreadCount, ThreadPriorityQueueSize, ThreadIdleCount, ThreadMax, ThreadCreateCountTotal, ThreadOverflowCountTotal, ThreadTaskQueueSize, ThreadWaitCount, ThreadExecutorMax, ThreadActiveCount, ThreadStartingCount
  • TransactionManager: RollbackCountTotal, CommitCountTotal, CommitResourceFailCountTotal, TransactionCount
  • WebApp: RequestCount, RequestCountTotal, ClientDisconnectCountTotal, RequestReadBytesTotal, RedeployCheckInterval, RequestTimeTotal, RequestWriteBytesTotal, Status500CountTotal

 

Custom Dashboard

 

Contributing

 

Always feel free to fork and contribute any changes directly via GitHub.

 

Support

 

For any support questions, please contact ace@appdynamics.com.

 

Version:

1.0.0

Compatibility:

3.7

Resin Version:

4.0.40

Last Update:

2/26/2014