Url Monitoring Extension

An AppDynamics Machine Agent extension to visit a set of URLs and report whether they are up or down.

This extension requires the Java Machine Agent.

Metrics Provided

- Average Response time (ms)
- Response Bytes
- Response Code
- Status : FAILED(2), ERROR(3), SUCCESS(4)

Response Code (HTTP Status code)Status
other than 2003
any exceptions2


1. Download UrlMonitor-<version>.zip and unzip UrlMonitor-<version>.zip into $MACHINE_AGENT_HOME/monitors. This will create a new directory called UrlMonitor.
2. In $MACHINE_AGENT_HOME/monitors, edit the file monitor.xml and config.yml to configure the plugin referring to the below section.
3. Restart the machine agent.

In the AppDynamics Metric Browser, look for: Application Infrastructure Performance | <Tier> | Individual Nodes | <Node> | Custom Metrics | URL Monitor


Every AppDynamics extension has amonitor.xmlfile that configures the extension. In this case, themonitor.xmlfor this extension just has a single option: the path where the extension can find the mainconfig.yamlfile. Note that the path is relative to$AGENT_HOME.

      <argument name="config-file" is-required="true" default-value="monitors/UrlMonitor/config.yaml" />


    maxConnTotal:             1000
    maxConnPerRoute:          1000
    ignoreSslErrors:          true
    userAgent:                Mozilla/5.0 AppDynamics-UrlMonitor/1.0.6

    method:                   HEAD
    socketTimeout:            30000
    connectTimeout:           30000
    numAttempts:              3
    treatAuthFailedAsError:   true


- name:       Google
  groupName: MySites
  url:        http://www.google.com
  authType: BASIC
       - name: LuckyButton
         type: caseInsensitiveSubstring
         pattern: Google

- name:       AppDynamics
  groupName: MySites
  url:        https://www.appdynamics.com
  authType: BASIC

- name:       My Slow Site
  url:        http://www.wordpress.com
  connectTimeout: 60000

- name:     My Controller
     url:      http://localhost:8090/controller
     username: user@DOMAIN
     password: password
     authType: NTLM
     connectTimeout: 60000

- name:       My Controller
  url:        https://mycontroller.saas.appdynamics.com/controller/rest/applications
  username:   demouser@customer1
  password:   welcome
  encryptedPassword: "IGVtC9eudmgG8RDjmRjGPQ=="
  authType: BASIC

  - name:         LocalHost 
    url:          https://localhost:8443
    password:    password
    authType:     SSL
    keyStoreType: SUNX509
    keyStorePath: pathToKeyStore
    keyStorePassword: password
    trustStorePath: pathToTrustStore
    trustStorePassword: password

  - name:     My POST site
   url:      http://localhost:8293/api/v1/metrics
   connectTimeout: 60000
   method:   POST
   Content-Type: application/json
   requestPayloadFile: src/test/resources/conf/postrequestPayloadFile
      - name:       Error
        type:       substring
        pattern:    Error 400

Configuration Reference

Client Section

The clientConfig section sets options for the HTTP client library, including:

Option NameDefault ValueOption Description
maxConnTotal1000Maximum number of simultaneous HTTP connections
maxConnPerRoute1000Maximum number of simultaneous HTTP connections to a single host
threadCount10Maximum number of Threads spawned to cater HTTP request
ignoreSSlErrorsfalseWhether to ignore errors in SSL certificate validation or host validation
userAgentMozilla/5.0 (compatible; AppDynamics UrlMonitor;http://www.appdynamics.com/)Custom User-Agent header to send with requests (can be used to mimic desktop or mobile browsers)
followRedirectstrueWhether the client should follow Redirect responses
maxRedirects10Maximum redirects
Default Site Section

The defaultParams section sets the default options for all sites. These options can then be overriden at the individual site level.

Option NameDefault ValueOption Description
methodGETHTTP method to use (e.g. GET, POST, HEAD, OPTIONS, etc.). The default is "HEAD", which avoids the overhead of retrieving the entire body of the response, but which prevents the agent from doing pattern matching or reporting the response size. Make sure you set the method to GET if you want these features.
socketTimeout30000Maximum time to wait for a socket connection to open, in milliseconds
connectTimeout30000Maximum time to wait for the HTTP handshake, in milliseconds
numAttempts1Number of times the site will be retrieved. The metrics then reported will be an average over all attempts.
treatAuthFailedAsErrortrueIf false, the extension will report the site status as "SUCCESS" even if authentication fails.
proxyConfignullProvide host and port.
ProxyConfig section
Option NameDefault ValueOption Description
hostnoneproxy host
portnoneproxy port
usernamenoneproxy username
passwordnoneproxy password
Site Section
Option NameDefault ValueOption Description
namenoneName of the url with which metric folder that will be created in Metric Browser
urlnoneThe url to monitor
groupNamenoneUsed to group multiple sites
usernamenoneusername if url has Basic Authentication
passwordnonepassword if url has Authentication
encryptedPasswordnoneencrypted password
authTypenonecurrently extension supports Basic, NTLM and Client Side Cert
matchPatternsnonematch patterns to search for in the response
Match Pattern Section
Option NameDefault ValueOption Description
namenoneName of the metric folder that will be created in Metric Browser
patternnoneThe string to search for
typesubstringCan be one of: substring, caseInsensitiveSubstring, regex, or word (see below)


The options for the pattern type are:

substringExact match on the given string
caseInsensitiveSubstringCase-insensitive match on the given string
regexRegular expression match
wordCase-insensitive, but the target string must be surrounded by non-word characters

Custom Dashboard



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


Find out more in the Community


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





3.7 or later

Last Update:

11 October 2017


 1.0.2 - Fixed Memory leak

 1.0.3 - Fixed thread pool shutdown issue

 1.0.4 -  Using ning async library.adding more flexibility, features and metrics.

 1.1.0 - Added Regex Matching Patterns

 1.1.1 - Fixing the typo in the pom for config.yml file

 1.1.2 - Fixing bug in response status and adding proxy support

 1.2.0 - Making sure the Machine agent is provided and is not bundled in the jar

 1.2.1 - Support for POST and change in timerollup_type to average for some metrics

 1.2.2 - ignoreSSLErrors functionality

 1.2.3 - Fixed metric drop issue in case of large number of URLs

 1.2.4 - Adding groupName to group multiple sites

 1.2.5 - Added support for NTLM auth and ignoring SSL Cert errors

 1.2.6 - Added support for Client Side Cert auth and password encryption

 1.2.7 - Enhancement: followRedirect added at Site level;Fixed config.yml path related bug