AppDynamics Extension for Adeptia ESB Monitoring

This extension works only with the standalone machine agent.

 

Use Case

Adeptia ESB Suite is an enterprise-class software product that is designed to integrate ANY APPLICATION with ANY DATA at ANY LOCATION. It combines process centric and services (SOA) based approach with application and partner integration. ESB Suite easily and quickly automates data flows and connects applications using industry-specific standards. This extension monitors Adeptia ESB instance and collects useful statistics and reports to AppDynamics Controller.

 

Prerequisities

  • Before the extension is installed, the prerequisites mentioned here need to be met. Please do not proceed with the extension installation if the specified prerequisites are not met.
  •  

    Installation

    1. Unzip AdeptiaESBMonitor.zip and copy the 'AdeptiaESBMonitor' directory 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 | Adeptia 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. Edit the file config.yml located at <MachineAgent_Dir>/monitors/ The metricPrefix of the extension has to be configured as specified here. Please make sure that the right metricPrefix is chosen based on your machine agent deployment, otherwise this could lead to metrics not being visible in the controller.
    2. Specify the Adeptia ESB instance host, port, username and password in the config.yml. For eg.

          # Adeptia ESB instance particulars
          host: "localhost"
          port: 8080
          usessl: false
          username: "admin"
          password: "indigo1"
          #Start optional parameters
          #   proxyHost:""
          #   proxyPort:
          #   proxyUsername:""
          #   proxyPassword:""
          #End optional parameters
      
          #prefix used to show up metrics in AppDynamics
          metricPrefix:  "Custom Metrics|Adeptia|"
      
      
    3. Configure the path to the config.yml file by editing the in the monitor.xml file in the <MACHINE_AGENT_HOME>/monitors/AdeptiaESBMonitor/ directory. Below is the sample

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

     

    Metrics

     

    Kernel and Webrunner metrics

    Database Matrix

    • {Host}|Database Matrix|{log/repository}|Active Connection Count
    • {Host}|Database Matrix|{log/repository}|Idle Connection Count
    • {Host}|Database Matrix|{log/repository}|Status

    JVM GC Matrix

    • {Host}|JVM GC Matrix|{GC Name}|Garbage Collections
    • {Host}|JVM GC Matrix|{GC Name}|Total Time Spent(In millis)

    JVM Memory Matrix

    • {Host}|JVM Memory Matrix|Heap/Non Heap Memory|Committed Memory
    • {Host}|JVM Memory Matrix|Heap/Non Heap Memory|Init Memory
    • {Host}|JVM Memory Matrix|Heap/Non Heap Memory|Max Memory
    • {Host}|JVM Memory Matrix|Heap/Non Heap Memory|Used Memory

    Jvm Thread Matrix

    • {Host}|Jvm Thread Matrix|Live Thread Count
    • {Host}|Jvm Thread Matrix|Peak Thread Count
    • {Host}|Jvm Thread Matrix|Thread Deadlock Count

    Processflow

    • {Host}|Processflow|Queued
    • {Host}|Processflow|Running
    • {Host}|Processflow|Waiting

    Cluster metrics

    • {Host}|{Post}|Network Link
    • {Host}|{Post}|Status

    For more information on metrics, please visit MONITORING ADEPTIA SUITE PERFORMANCE section of http://www.adeptia.com/products/download/Admin_Guide.pdf

     

    Custom Dashboard

     

    Troubleshooting

    Please look at the troubleshooting document and make sure that everything is followed correctly.

    Contributing

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

     

    Support

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

     

    Version:

    1.0.1

    Compatibility:

    3.7

    Adeptia ESB Version:

    6.2

    Last Update:

    02/19/2018