AppDynamics .Net Agent Extension Manager

Introduction

The .NET Agent Extension Manager works with the .Net Agent to capture and report metrics not gathered out of the box. It can be used to capture metrics such as: Windows Event Log data, current Windows Service states, Windows reboot times, or kick off custom scripts to gather metrics from any source.

Contents

●Folders

○/Extensions - contains configuration data for each extension.

○/Logs - contains logs for each extension

●Files

○AppDynamics.Extension.Manager.exe - The Extension Manager. Use this to enable and configure extensions and to install/remove the AppDynamics.Agent.Extension Windows service.

○ExtensionService.exe - The AppDynamics.Agent.Extension Windows service executable; a lightweight Windows service which continuously collects metric data for all .NET extensions and stores this data in Windows Performance Counters. These Performance Counters are polled continuously and their values are sent to the Controller by the AppDynamics.Agent.Coordinator service.

○AppDynamics.Extension.CCT.exe - Configures which Windows Performance Counter metrics will be sent to the AppDynamics Controller via the AppDynamics.Agent.Coordinator Windows service.

Prerequisites

●The AppDynamics .NET Agent

●.NET 4.0 or later

Installation

Download and unzip the archive to any fixed location, such as %ProgramData%\Appdynamics or just C:\

Once unzipped, you should see the following folder structure.

Overview of Extension Types

Presently, the .NET agent extension service supports the following extensions types:

●Event extensions - Event extensions are used to send custom Events to the controller. More details can be found on following link,

●Metric extensions - Metric extensions are used to extend the capability of agent to collect any metric from the machine or any other running application. These metrics can then be seen in the controller Metric Browser under Application Infrastructure Performance - [Any Tier] - Custom Metrics. Additionally health rules can be created for these metrics to trigger Alerts when necessary.

Some commonly used extensions have been bundled along with the Extension Manager.

  1. Windows Event log Watcher (Event extension)
  2. Windows Reboot Watcher (Event extension)
  3. Windows Service Status Monitor (Metric extension)
  4. Script Monitor (Metric extension)

By default, all provided extensions are disabled. You can enable them by editing their corresponding XML configuration file. See the Getting Started section for more detail.

Getting Started

  1. Open AppDynamics.Extension.Manager.exe

○Click the Install button to install the AppDynamics.Agent.Extension Windows service, then click Start to start it.

○Click the "Manage" button next to any extension to edit the XML configuration file located in /extensions/[Extension Name].xml. Alternatively the XML editor of your choice can be used to edit and save these files.

  1. EVENT and METRIC extensions collect and send data to the controller differently.

○EVENT extensions make use of the AppDynamics Controller REST API and require controller user credentials to be added to their configuration file.

○METRIC extensions create Windows Performance Counters to store metric data until it's sent to the Controller via the AppDynamics.Agent.Coordinator service. In step #4 below, we'll add these Performance Counters to the AppDynamics.Agent.Coordinator configuration file (config.xml).

  1. Once you've updated the configuration for these extensions, you'll want to recycle the AppDynamics.Agent.Extension Windows Service for these changes to take effect. Note: it could take up to a minute for the service to stop. This time is necessary to terminate and clean all the resources effectively.
  2. If any METRIC extensions have been enabled, use AppDynamics.Extension.CCT.exe to edit/remove the appropriate Performance Counters to the AppDynamics.Agent.Coordinator configuration file (config.xml). For example, the WindowsServiceStatusMonitor extension included out of the box will create a Performance Counter category with the same name of "WindowsServiceStatusMonitor".

○Restart the AppDynamics.Agent.Coordinator service for the changes made in config.xml to take effect.

  1. In a few minutes, you should start to see custom EVENT or METRIC data reported to the AppDynamics Controller.

○For EVENT extensions, you should see new custom events sent to the controller.

○For METRIC extensions, you can find the new metrics in the Metric Browser under Application Infrastructure Performance - [Any Tier] - Custom Metrics.

Troubleshooting

If you're not seeing metrics reported to the controller, check to make sure the custom Windows Performance Counters created by the Extension Service have been added to the AppDynamics.Agent.Coordinator configuration file (config.xml). If the Performance Counters have been added, try restarting the Coordinator to ensure the configuration has been picked up. If this doesn't help, check the Logs folder for any errors.

Upgrade

  1. Download and extract latest version of extension manager
  2. Stop extension service and uninstall
  3. Copy Extensions directory from old install location
  4. Launch Appdynamics.Extension.Manager.exe from new installation and install extension service.
  5. Start Extension Service to use latest version.