Microsoft Azure Monitoring Extension

Microsoft Azure Monitoring Extension

 

This extension works only with the standalone machine agent.

 

Use Case

 

Microsoft Azure is an Internet-scale computing and services platform hosted in Microsoft data centers. It includes a number of features with corresponding developer services which can be used individually or together.

 

Prerequisite

 

  • 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.
  • Create and export management certificate to azure For steps to create a certificate and export to Azure visit http://gauravmantri.com/2013/08/25/consuming-windows-azure-service-management-api-in-java/

     

    Installation

     

    1. Download and unzip the file 'target/AzureMonitor.zip' to <machineagent install dir>/monitors
    2. Open monitor.xml and configure the Azure arguments
    <argument name="subscriptionId" is-required="true" default-value="<Azure Subscription id>"/>
    <argument name="keyStorePath" is-required="true" default-value="<Azure keystore path>" />
    <argument name="keyStorePassword" is-required="true" default-value="<Azure key store password>" />
    <!-- Azure REST API version, More info at http://msdn.microsoft.com/en-us/library/windowsazure/dn166981.aspx -->
    <argument name="x-ms-version" is-required="true" default-value="2013-11-01" />
    <!-- The configuration file which lists out the metrics to be included from monitoring on controller-->
    <argument name="include-metrics-path" is-required="true" default-value="monitors/AzureMonitor/metrics.properties" />

    <!--Proxy server details-->
    <argument name="proxyHost" is-required="false" default-value="" />
    <argument name="proxyPort" is-required="false" default-value="" />
    <argument name="proxyUsername" is-required="false" default-value="" />
    <argument name="proxyPassword" is-required="false" default-value="" />

    SubscriptionId : Azure subscription id
    keyStorePath : Path of keystore which is created and uploaded to azure
    keyStorePassword : Password for the keystore
    x-ms-version : Azure REST API version (For more info refer http://msdn.microsoft.com/en-us/library/windowsazure/dn166981.aspx)
    include-metrics-path : Path to metrics.properties

    proxyHost : Proxy server host if any
    proxyPort : Proxy server port if any
    proxyUsername : Proxy server user name if any
    proxyPassword : Proxy server password if any

     

    Open metrics.properties and configure storage account names
    STORAGE_ACCOUNT_NAMES_FOR_TABLE: Storage account name for which table level metrics to be fetched
    STORAGE_ACCOUNT_NAMES_FOR_BLOB: Storage account name for which blob level metrics to be fetched

     

    Metrics

     

    The following metrics are reported.

     

    Subscription

    Metric PathDescription
    Azure/Subscription/{SubscriptionID}/MaxCoreCountMaxCoreCount
    Azure/Subscription/{SubscriptionID}/MaxStorageAccountsMaxStorageAccounts
    Azure/Subscription/{SubscriptionID}/MaxHostedServicesMaxHostedServices
    Azure/Subscription/{SubscriptionID}/CurrentCoreCountCurrentCoreCount
    Azure/Subscription/{SubscriptionID}/CurrentHostedServicesCurrentHostedServices
    Azure/Subscription/{SubscriptionID}/CurrentStorageAccountsCurrentStorageAccounts
    Azure/Subscription/{SubscriptionID}/MaxVirtualNetworkSitesMaxVirtualNetworkSites
    Azure/Subscription/{SubscriptionID}/MaxLocalNetworkSitesMaxLocalNetworkSites
    Azure/Subscription/{SubscriptionID}/MaxDnsServersMaxDnsServers

     

    Disks

    Metric PathDescription
    Azure/Disk/{Disk Name}/Disk SizeDisk Size

     

    OS Image

    Metric PathDescription
    Azure/OS Image/{Name}/LogicalSizeInGBLogical OS Disk Size

     

    Website Management

    Metric PathDescription
    Azure/Web Space/{Web Space Name}/CurrentNumberOfWorkers 
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Enabled 
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/CPU Time/{Unit}/CurrentValueCPU Time currentvalue
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/CPU Time/{Unit}/LimitCPU Time limit
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Data In/{Unit}/CurrentValueData in current value
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Data In/{Unit}/LimitData in limit
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Data Out/{Unit}/CurrentValueData out current value
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Data Out/{Unit}/LimitData out limit
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Local bytes read/{Unit}/CurrentValueLocal bytes read current value
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Local bytes read/{Unit}/LimitLocal bytes read limit
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Local bytes written/{Unit}/CurrentValueLocal bytes written current value
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Local bytes written/{Unit}/LimitLocal bytes written limit
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Network bytes read/{Unit}/CurrentValueNetwork bytes read current value
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Network bytes read/{Unit}/LimitNetwork bytes read limit
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Network bytes written/{Unit}/CurrentValueNetwork bytes written current value
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Network bytes written/{Unit}/LimitNetwork bytes written limit
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/WP stop requests/{Unit}/CurrentValueWP stop requests current value
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/WP stop requests/{Unit}/LimitWP stop requests limit
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Memory Usage/{Unit}/CurrentValueMemory usage current value
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/Memory Usage/{Unit}/LimitMemory usage limit
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/CPU Time - Minute Limit/{Unit}/CurrentValueCPU time in minutes current value
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/CPU Time - Minute Limit/{Unit}/LimitCPU time in minutes limit
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/File System Storage/{Unit}/CurrentValueFile system storage current value
    Azure/Web Space/{Web Space Name}/{Web Site Name}/Usage Metrics/File System Storage/{Unit}/LimitFile system storage limit

     

    Database Server

    Metric PathDescription
    Azure/DATABASE SERVER/{DB Server Name}/DATABASE/{DB Name}/MaxSizeBytesMax DB size in bytes
    Azure/DATABASE SERVER/{DB Server Name}/DATABASE/{DB Name}/SizeBytesDB Size in bytes

     

    Storage

     

    Table

    Metric PathDescription
    Azure/Storage/Table/{Storage Account Name}/No Of TablesNumber of tables in storage account

     

    Blob

    Metric PathDescription
    Azure/Storage/Blob/{Storage Account Name}/Container/{Container Name}/Blobs/{Blob Name}/SizeBlob size

     

    Custom Dashboard

     

     

    Contributing

     

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

     

    Troubleshooting

     

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

     

    Support

     

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

     

    Version:

    1.1.1

    Compatibility:

    3.7

    Last Update:

    2/27/2015

     

     Changes in versions:
    1.1.1: Updated Licenses
    1.1.0: Added proxy support for the extension