Comments have been closed on this page. Please use AppMon & UEM Open Q & A forum for questions about this plugin.


The license count plugin queries the agent overview to get the licenses being currently utilized by technology.


The plugin supports both HTTP and HTTPS.

The plugin uses dynaTrace REST Interface to query the following metrics:

  • Total licenses used
  • Total agents not licensed

  • Java agents

  • .Net agents

  • .Net Hosts

  • Node.JS agents
  • Web Server agents
  • Message Broker agents
  • Native agents

  • PHP agents

  • CICS agents

  • Database agents

The plugin can filter or dynamically split on the following items:

  • System Profile
  • Collector
  • System Profile/Agent Group
  • Host
  • Agent Version

Plugin Details

Plug-In Files

For Dynatrace 6.5+



For Dynatrace 6.3 and lower



System Health - License Count.dashboard.xml


  • com.dynatrace.license.count_2.0.1.jar
  • System Health - License Count.dashboard.xml


Shaun Gautz (

Michael Beemer (

dynaTrace Versions

>= 5.5


dynaTrace BSD


Not Supported

Known Problems


Release History

2017-09-01 Added Web Server count compatibility for AppMon 7.0.

2016-12-02 Rebuilt the entire plugin for version 6.5

2016-06-16 Added measures for Node.JS agents

2016-06-07 Added the new Database agents from version 6.3

2016-06-03 Fixed an issue with CICS agent counts. Added web server measures.

2015-08-24 Created one plugin for versions <6.1 and 6.2. Added logic for "license exhausted" agents

2014-04-21 Added support for multiple filters, dynamic splits for System Profile/Agent Group,

         and enhanced 'finer' level of logging

2014-01-28 Added support for HTTPS

2014-01-10 Dynamic splits and added agent types

2013-03-28 Split by System Profile and bug fixes
2013-02-13 Initial Release


This plugin is now based off of the '/rest/management/agents' REST API call. It no longer requires the Agents Overview dashboard. The new version of the plugin may work for previous versions.

Directions for 6.3 and older - This plugin requires that you first save the Agent Overview as a dashboard on the dynaTrace server. Make sure the maximum number of lines per table is larger than the number of agents, or the xml will be cutoff. Once the dashboard is saved, use a web browser to navigate to the http://server_name:8020, by default, or https://server_name:8021, if you are using HTTPS. Once at the home page, navigate to View Dashboard & Reports -> Agent Overview Dashboard (or whatever you named it) -> Details -> Report Type is XML -> Create Report. Use this URL on the Monitor tab. Starting in version 1.6, the Monitor screen has the URL split out. One box is for protocol, one is for port, and another is for the rest of the URL (/rest/...).


Directions for 6.5 - Once you have the plugin installed and created, then you can create a new monitor, as shown in the following screenshots.

The plugin now uses the host you selected for the monitor. It uses the Address block of that host. You may need to change this, if it doesn't work by default.

Use the following Monitor names to work with the dashboard:

You may add a filter, if you only want to see one System Profile or Collector. Starting in version 1.7, you can use multiple filters separated by a semicolon, such as "easyTravel;Second Profile;ThirdProfile".


The following screenshot shows a dashboard displaying some of the measures queried by the monitor:

Things to consider

  1. Since it's a measure, it polls on a schedule instead of when the agent count changes
  2. The filtering does not use regex and is case sensitive
  3. The count for .Net hosts is based off the number of servers not CLRs. There is a separate value for Net Agents
  4. Requires a username and password with at least read access to the REST interface
  5. Not all of the agent types are included here. If you have an agent you would like added, add a comment below
  6. If you have many hosts, splitting by host may take several minutes to get all the data


The new 2.0.4 update is adds functionality for Web Server count with version 7.0.

The new 2.0.1 update is completely rewritten to work with version 6.5. It no longer requires the Agents Overview dashlet.

The new 1.7.8 update adds a measure for Node.JS agents

The new 1.7.7 update adds a measure for the new Database agents from version 6.3.

The new 1.7.6 update fixes an issue with identifying CICS agent counts. It also adds additional measures for IIS/Apache web server agents.

The new 1.7.5 update includes support for version 6.2. It also adds "License exhausted" agents to the measure for Unlicensed agents.

The new 1.7.0 update adds support for multiple filters, separated by a semicolon. It adds splitting by System Profile/Agent Group and adds enhanced 'finer' level of logging.

The new 1.6.0 update adds support for a dT server running over HTTPS.

The new 1.5.0 update adds the option to split dynamically on system profile, collector name, agent version, and host name. You can still filter for one item, or you can leave the filter blank and the monitor will pull all of the items that have a license count. Several agents were also added to the available metrics.



The new 1.1.0 update adds an option to split by a system profile name. If you are going to use this feature, it might be a good idea to name the license count measure based on the system profile to avoid confusion. Also, keep in mind that the system profile name must match exactly or the count will be zero. Special thanks to Rajesh for the feedback on this.


Feel free to contribute any changes on Github

#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))


  1. Thank you Michael.  This plugin has been helpful in tracking our license counts. 

    1. Thanks for the feedback Razib! I'm in the process of testing out an update that should resolve a few issues that have come up. I'll update this post when I'm done.

  2. Can you split it by Profile Name.

    The use case I have come across many times with my customers is they would like to see which profile (which are organized by App Owners) are consuming the licenses.

    This looks good.


    1. Great idea Rajesh! I just finished writing and testing the code. Look for an update to the post later today.

      1. I look forward to the update!



  3. We are getting incorrect counts back from this plug-in: it is showing 87 Java licenses, but we actually have 294 Java licenses being consumed. Calculated manually by taking the Agents XML and putting it into Excel and filtering on Java and whether the capture flag is true or false.

  4. Found one issue - dashlet report was limiting results to only 100 records. Increased the filter to 10000 and re-generated the report definition. I would be great to get a more accurate count for .NET; we do a lot with IIS and we have significant license consumption on a single server.

    1. Hi Jim,

      I would be happy to look at my code to see what needs to be fixed.  I have logic in there to account for .NET applications on the same server but I wasn't able to test it with a large number of agents.  Perhaps you could send the XML you're generating to

      Also, good catch on the dashlet reporting only 100 records by default.  I need to update the documentation for this plugin to remind everyone of that.



  5. Great plugin! 


    Thanks for the HTTPS support!

  6. One error occured on one of our servers: the plugin stops executing with the following message: Type information for plugin key missing: com.dynatrace.licence.count. We used the Version 1.1.0

    Are there any solutions?

    1. Can you look in the log and see if there are any messages there? Also, have you considered upgrading to the most recent version of the plugin?

      1. Hi Raphael,

        Did you notice this after an a major change or upgrade on the dynaTrace server?  It might be worth upgrading like Shaun suggested. He did a great job extending the plugin to add some really useful functionality and additional metrics.


  7. The log has 0 KB and the log level was set to Finer.

    As you commended i updated the plugin to the most recent version and the error is gone.

  8. Do i interpret it correctly that the plungin runs on the chosen collector and opens a http/s connection from there to the DT Server ?

    1. Yes, that is correct. The plugin runs on the collector.

  9. I configured with new plugin com.dynatrace.license.count_1.6.0.jar on dynaTrace server. I did all the configurations as exactly mentioned in the description.

    I used one of the system profile to configure monitor “Configure Licenses Count” but not sure I am not getting any result in chart.

    Monitor also shows error related to plugin. Could you please look into this if you get a chance. The error I am getting as "error during execution of plug in occured.


    Santosh Lamkhade

    1. Please email me at ( with screenshots of all your configuration screens.

      1. The resolution on this was to properly configure the URL, host, and filter sections.

  10. I just installed/configured this plugin but I'm getting incorrect numbers for one system profile. I changed the max number of records allowed but still no luck. We have 7 different profiles for the server I installed the plugin on and 6 of them are correct. The incorrect profile is showing me 141 licensed agents and 33 unlicensed agents. The total is the correct number of agents but when I look at the Agents Overview chart I saved, I see 174 agents mapped to the profile and they all show "license ok."


    Any ideas?

    1. If you could save the agent overview dashboard as XML and email it to myself and Shaun, I'm sure we can help you out.

      1. The resolution to this is that the Agent Group was set to not Capture Events. The agents were still pulling a license though. With the 1.7 update, I fixed the issue with those agents not being counted.

  11. I have a feeling I'm on my own here, but it'd be great to also have the option to split licenses by Agent Group within a given System Profile. Any chance of this happening?

    1. I can look into the possibility of doing this. Please email me an xml of your agent overview. (

      1. I added this functionality in the 1.7 update.

  12. Does it requires a server/collector restart ? Thanks

    1. No, it does not. You will be able to create the monitor without any restarts.

    2. There is no restart required.

  13.  We have few system profiles where we set to not Capture Events and we know the agents were still pulling a license though. 

    Do we have such feature with 1.7 where we get licenses count only for capture events on and how we should get those results ?



    Santosh Lamkhade

    1. Even though an agent group is set to have Capture Events disabled, it will still consume a license. Starting with version 1.7, I have started counting those agents. A license count for only agents with Capture Events on would not be accurate, since they are still consuming a license.

  14. Does this version of the plugin support UEM license count?

    1. UEM license count is not supported. It is not easily accessible, like the regular agents are.

    2. Hi David,

      There is no need for the plugin to track that information because dT handles that OOTB.  Take a look under the "dynaTrace Self-Monitoring" system profile and you should be able to find a number of UEM related measures.  You can even create a dashboard that has a single dashlet that points to this system profile.  That way, you can keep all the license related information together.  Please let me know if that isn't what you're looking for and we can try and come up with a way to get it for you.



  15. Will have a look

    I am looking at a way to report on the amount of license we have and the amount used for uem for my management without going into the tool under dynaTrace serve license

    1. Yeah, what you're looking for is definitely possible.  Try add one of the following measures to a dashboard and see if that works for you.

  16. I don't think this is currently possible with the existing agent overview, but we would love to be able to split Java for Mainframe (not CICS) agents apart from Distrubted Java agents.  Currently all Java agents are listed the same.

    1. Can you email me the xml of your Agent Overview? I'll see what I can do.

  17. We configured with this licenses count plug-in and it is helped us to keep track of licenses for our environment. The question is now does it calculated how many concurrently active agents do we have ? How this is this possible using this plug-in 

    1. The plugin tracks the current number of agents connected. It does not track the number of licenses available. The plugin tracks the connected agents by searching through an xml copy of the agent overview dashlet. That dashlet lists all the agents currently connected.

  18. So, we need to generate XML Report after each change in the agents to pick up data by monitor?

    1. If I'm understanding your question correctly, I believe you are mistaken. The XML report is only generated one time so you can get the URL for the plugin/monitor (But the dashboard must always be there!). The Agents Overview dashboard that you save off is no different from opening the Agents Overview dashlet. This dashlet automatically updates as agents get connected, disconnected, updated, restarted, etc. So every time the monitor runs it will grab the correct/most up to date information without any manual effort from your end. 

      1. Tom is right here. You only need to run the XML report once to get the URL. As long as you don't change/delete the dashboard you are collecting from, then it will always grab the most recent connected agents.


  19. It doesn't work like this. We've updated our license and the monitor collected incorrect data until I've created xml report again or saved dashboard (not sure what did work). 

    Also I've compared count of agents in "Settings->dynaTrace Server->Collectors->Connected agents" and count in Monitor - they don't match. Should they match?



    1. My guess is it's your data aggregation. When you create a chart it will likely be charting average by default. Change this to "last" aggregation and it will always show the results from the last collection.

      The reason why it would work if you created a new dashboard would be because it was creating a new measure. The average from the one execution would be the correct number. Then when you ran it again, with a different number of agents connected, the average would show you "incorrect" results (but really just an average).

      Let me know if this helps!

      1. The number of Connected Agents may not match up to the number you are seeing in the plugin. You could have agents that are connected, but not licensed. Also follow Tom's advice here. If you want the most recent value, then you should use Last aggregation. You can reach out to me directly at if you have any more questions or need help understanding the plugin.


  20. It was hard to not notice that average doesn't work at all! Cause there were a lot of fractional numbers on dashboard. I've used "Last" and "Maximum" aggregation. I'm comparing with data that monitor gathered: system profile->monitors->details.

  21. Just wanted to say thank you guys for your work on the plugin.  We've been able to use it to track (by hour) how many agents were checked into an individual server for tracking and billing consumption with one of my customer's customers across many Dynatrace servers.  The AgentUsage log appears to work for this only up to the total checked into the server, but this gets us the level of granularity their financial/billing department needs.  Thank you!

    1. That is great to hear Andy. I'm glad your customer is using it. Let me know if you have any suggestions/changes to make to the plugin to improve it.

  22. Hello Shaun,

    Previously I added comments related to get the licenses count when agent group is set to Capture Events disabled. We have few system profiles where agent group set not to Capture Events. I agreethat the agents were still pulling a license though. 

    Do we have such feature with 1.7 where we get licenses count only for capture events on and how we should get those results ?


    Your comment is as given below on that :--

    Even though an agent group is set to have Capture Events disabled, it will still consume a license. Starting with version 1.7, I have started counting those agents. A license count for only agents with Capture Events on would not be accurate, since they are still consuming a license.

    Could you please let us know what is the feasibility of adding that feature again to provide count for only agents with Capture Events on.

    Santosh Lamkhade


    1. There is not a feature currently in the plugin that will separate the Capture Events enabled/disabled for the agent count. This would not be an easy change. I can look at creating one measure, which would be the number of licensed agents that has Capture Events turned on. Let me look into how difficult this will be, and I will get back to you. I also want to avoid creating too many one-off measures. I don't want to make the plugin any more complicated than it needs to be.

  23. Hi Shaun, 

    This is great.I wish I had used this previously for my license presentation.

    I would like to measure the number of agents that are connected(as in the app is instrumented), but are not consuming a license; there are none left to consume(i.e. too many 'Java' agents connected;license exhausted) This would be useful to guage  for the Testing Profiles when distributing licenses on-demand, while keeping apps instrumented.

    Is this possible?



    1. There is a measure called 'Unlicensed Agents'. This will give you what you need. Keep in mind that you could be unlicensed for reasons other than license exhausted, such as not matching a system profile.

      1. Hi Shaun,

        I am looking for something like this as well to count too many 'Java' agents connected;license exhausted.  I have found that the Unlicensed Agents measure is not giving me this value as 'Capture' is set to TRUE on these agents.  I am running DT AM 6.0.

        Update: Version 1.7.5 Counts these agents as 'Unlicensed Agents'

        1. Please email me an xml of your agent overview and I will take a look at it.

  24. Thanks for making this! This is invaluable to the project managers looking over the Dynatrace implementation at one of my accounts. 

  25. I am seeing in the notes that it says this can be split by system profile/Agent groups. I am not seeing the option to actually split my results by agent group. I would like to be able to show how many licenses a given agent group is using. similar to your default board that shows count per collector but I can't seem to get this split for agent groups.

    EDIT: Actually It appears as though I can split by Agent Group in my production environment but have no option to split in dev. Could this be that the dashboard xml for the agents is configured incorrectly?

    1. Assuming you are on version 1.7, then you would need to select the split by System Profile. You will then see a checkbox for if you also want to split by Agent Group. That will give you a split value that looks something like this, System Profile/Agent Group.

      1. Sorry just updated my previous post:

        Actually It appears as though I can split by Agent Group in my production environment but have no option to split in dev. Could this be that the dashboard xml for the agents is configured incorrectly?

        EDIT: I am on 1.7

        1. You are sure the dev environment is on 1.7?

  26. Yes, I installed them both from the same plugin. I know the username info isn't filled in on this screenshot but even when filled in correctly I do not get the agent portion for splitting.

    see below:

    1. Select System Profile in the dropdown. It will then give you a checkbox for Agent Group.

      1. Im sorry, I set them up at different times and completely glazed over that portion on our dev side. sorry to waste your time, I was looking for it to be named differently.

        1. That's ok. I'm glad you have it working now. Let me know if you have any more questions about the plugin or have any requests to improve it.

  27. Weird issue I am having, and this may be something we need to change on our end. Recently my license monitor has not been running. I noticed that if I change the username that it logs into the rest services it works once then not again. I can change it back and forth between the same two usernames but each only works once, after that they just go to "?".

    1. Do you see anything out of the ordinary in the logs?  I can't think of any obvious reason why this would be happening to you.  Are you able to successfully perform that REST call multiple times from your browser?

      1. yes, I can perform it without any issue any number of times from my browser. I did not see anything that specifically stood out from our logs either. I may just try to recreate the monitors since it was only a few of them.

      2. I recreated the monitor and that one has no issue running multiple times so i must have broken it somehow.

  28. Shaun/Mike,

    I installed the plugin, and it works fine without errors, but I am only getting the Licensed Agents count and all other (java, dotnet, webserver, unlicensed) return 0.

    Also, the splitting by collector does not return any value. 

    1. Reach out to me directly and I'll look at your setup.

  29. Hi there,

    I am getting results from the plugin that do not make sense. My Dynatrace server self-monitoring reports 756 licensed agents, about half of which are Java and half of which are web server agents. However, the plugin reports 63 licensed agents total. I know that self-monitoring is double counting the web server agents, but I believe I am collecting data from way more than 63 agents total. I am on DT 6.0 and using the latest version of the plugin (1.7.5). Any suggestions?


    Thanks in advance

    1. Hey Jacob,

      Does the dashboard you are calling with the plugin have the 'maximum number of lines per table' set high enough?  Dashboard Properties > Reporting > Details.


      1. It sounds like Markie is right. By default, it only shows the top 100 rows in a dashboard. Check that setting and see if that fixes it. If not, feel free to send me the xml of your dashboard and screenshots of the plugin configuration.

      2. Ahhhh, you are quite right, that was my problem (smile) Thank you for the quick help Markie and Shaun.

  30. Can someone summarize the steps needed to create this Dashboard? I tried following the steps but seems I'm missing something. I'm able to reach the step to create XML file but from there I'm not able to connect the dots.



    1. Hi. I've not used this plugin myself - but - once you have installed the plugin and configured it as a monitor in one of your System Profiles you should be able to create a new Dashboard in your Dynatrace Client. Add a chart to the dashboard and then pick the measures that this monitor plugin creates. There is no need to create any XML. Just create a regular dynatrace dashboard, add your charts and on each chart you simply put the measures that this plugin provides. If you want to learn more about dashboards and measures you might want to check out some of my youtube tutorials on dashboards - - or check out our online educational material on


    2. Hi Uzair,

      When you reach the step to create the XML report from the Dynatrace (REST) Web interface be sure you copy the URL from the web browser used to create the report, this is the piece you need to continue, not the actual XML.

      Return to Edit System Profile in the Dynartace Client and go to the Monitors section.  Here create a new monitor of type License Count and you will see a section to fill in your Dynatrace Server Name (hosts section), protocol, port number and the remainder of the URL you copied from your web browser.

      Once you fill in this data and set up the schedule for the monitor to run on (second tab in the monitor configurations) you will start to see measurement data available that you can place into charts in your custom dashboards.

      Hope this helps

  31. Thanks Markie StrubleAndreas Grabner for the suggestions.

    After adding the XML generated url I still don't see any metrics generated for License count? I added the following Monitors

    CICS Agents

    dotNet Agents

    dotNet Hosts

    Java Agents

    Licensed Agents

    Message Broker Agents

    Native Agents

    PHP Agents

    Unlicensed Agents

    Web server Agents

    License Visit Count



    1. Hi Uzair,

      Please check the status of the Monitor you set up in your System Profile.  If there were any issues running the monitor they will be listed here.  If the monitor is successful it will display the most recent values captured by the monitor.  Also note that you do not need to create a Monitor for each Agent Type you can capture them all (and get better performance) by simply checking the checkboxes for all measures in the Measures section of a single Monitor.

  32. Hi Markie, Last Run Status is failed with no details on reasons.


    1. Hi Uzair,

      A couple things to check:

      • Make sure that the protocol and port numbers are correct and match.  i.e. Dynatrace HTTP defaults to 8020 and HTTPS defaults to 8021.  
      • Make sure the user ID you entered into the monitor has access to 'Web Service Interface' and 'Generate Dashboard Reports via Web Service' permissions.
      • Ensure the firewall is open from the Collector you selected on the Schedule tab to your Dynatrace Serveron the Web Interface port you selected (8020 or 8021).

      Following that check the log file 'com.dynatrace.license.count.monitor.0.0.log' located on your Dynatrace Collector.  You can find this log file via the System Information Dashlet in your Dynatrace Client.


  33. Hello, do you think it will be possible to add IIS hosts and Apache agents measures? Our Webserver licencing is the sum of those 2 which is tottaly different fromt the number of web server agents.

    1. Since this is a one-off scenario, I'll have to look into it before I know whether or not it can be done. Can you send me the xml output from your Agents Overview? I'll have to see if it's possible.

      1. Hi Chaun,


        Do you have an update on this?



        1. I will try to have an update for you by the end of the week. Which version of the product are you on?

          1. Soon on 6.3.3

            Now on 6.2.

            so I think best is to do this for 6.3.3?



  34. Yes, 6.3.3 is fine but is the agent overview xml output the same in 6.3 than in 6.2? I guess yes but ...

  35. I upgraded the plugin from version 1.7.5 to 1.7.7 and now the "Total Agent Count (last 24 hrs)" and "Total Agent Count Per Collector (last 24 hrs)" dashlets are not showing historical data.

    I don't see any errors in the plugin log.  Is this a known issue?


    1. I have not seen that behavior before. I will have to investigate it further. Are you collecting current data? If you go back to 1.7.5, do you see historical data?

      1. I just reverted this morning and so far I still see data since I reverted to 1.7.5.  I will keep watching to make sure it continues to work.

  36. Thanks for the update Shaun