Microsoft Exchange Integration

Learn about the Microsoft Exchange Integration.

The Microsoft Exchange integration installs and configures Telegraf to send Microsoft Exchange performance metrics to Wavefront. Telegraf is a light-weight server process that can collect, process, aggregate and send metrics to a Wavefront proxy.

In addition to setting up the metrics flow, this integration also installs a dashboard. Here’s the overview section of a dashboard displaying Microsoft Exchange metrics.

images/ms_exchange_dashboard.png

Microsoft Exchange Setup

Step 1: Set up the Wavefront Proxy

If you do not have a Wavefront proxy installed on your network, install a proxy.

Step 2: Install the Telegraf Agent

Download wavefront-telegraf-64-setup.exe. Only 64-bit Windows is supported.
Double click the wavefront-telegraf-64-setup.exe file and follow the instructions in the setup dialog to install Telegraf.

Note: Steps 3-5 are only required if the Wavefront proxy is installed on a different host.
Edit the telegraf.conf file located in Program Files\Telegraf.

Warning: Do not use notepad to modify the file. Use an editor that supports Unix style line endings, such as Notepad++ or EditPlus.
Configure the outputs section to communicate with your Wavefront proxy:
```
[[outputs.wavefront]]
   host = "WAVEFRONT_PROXY_HOSTNAME"
   port = 2878
```
Note: In the default telegraf.conf, the host property is set to localhost.
Restart the Telegraf service using the Windows Services Management Console or from the command prompt:
```
net stop telegraf
net start telegraf
```
Check Program Files\Telegraf\telegraf.log to verify the installation.

Step 3. Configure Telegraf

Edit the telegraf.conf file located in Program Files\Telegraf and enter the following snippet:

[[inputs.win_services]]
  service_names = [
      "MSExchangeTransport",
      "MSExchangeTransportLogSearch",
      "MSExchangeUM",
      "MSExchangeUMCR", 
      "MSExchangeThrottling",
      "MSExchangeServiceHost",
      "MSExchangeFastSearch",
      "MSExchangeRepl",
      "MSExchangeRPC",
      "MSExchangePop3",
      "MSExchangeMonitoring", 
      "MSExchangeSubmission", 
      "MSExchangeDelivery",
      "MSExchangeMailboxReplication",
      "MSExchangeMailboxAssistants",
      "MSExchangeIS", 
      "MSExchangeImap4",
      "MSExchangeHM",
      "MSExchangeFrontendTransport",
      "MSExchangeEdgeSync",
      "MSExchangeDiagnostics",
      "MSExchangeAntispamUpdate",
      "MSExchangeADTopology"
  ]
  

[[inputs.win_perf_counters]]
  [[inputs.win_perf_counters.object]]
    ObjectName = "Process"
    Counters = ["% Processor Time","Handle Count","Private Bytes","Thread Count","Virtual Bytes","Working Set"]
	Instances = [
	  "MSExchangeTransport",
	  "MSExchangeTransportLogSearch",
	  "umservice",
	  "Microsoft.Exchange.UM.CallRouter", 
	  "MSExchangeThrottling",
	  "Microsoft.Exchange.ServiceHost",
	  "Microsoft.Exchange.Search.Service",
	  "msexchangerepl",
	  "Microsoft.Exchange.RpcClientAccess.Service",
	  "Microsoft.Exchange.Pop3Service",
	  "Microsoft.Exchange.Monitoring", 
	  "MSExchangeSubmission", 
	  "MSExchangeDelivery",
	  "MSExchangeMailboxReplication",
	  "MSExchangeMailboxAssistants",
	  "Microsoft.Exchange.Store.Service", 
	  "Microsoft.Exchange.Imap4Service",
	  "MSExchangeHMHost",
	  "MSExchangeFrontendTransport",
	  "Microsoft.Exchange.EdgeSyncSvc",
	  "Microsoft.Exchange.Diagnostics.Service",
	  "Microsoft.Exchange.AntispamUpdateSvc",
	  "Microsoft.Exchange.Directory.TopologyService"
	]
    Measurement = "msexchange.process"
     
   [[inputs.win_perf_counters.object]]
     ObjectName = "Database"
     Counters = ["I/O Log Writes Average Latency","Log Threads Waiting","Log Record Stalls/sec",
	         "Database Cache % Hit","Database Page Fault Stalls/sec",
                 "I/O Database Writes Average Latency","I/O Database Reads Average Latency"]
     Instances = ["*"]
     Measurement = "msexchange"
    
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchange ADAccess Domain Controllers"
     Counters = ["LDAP Read Time","LDAP Search Time","LDAP Searches Timed Out per Minute","Long Running LDAP Operations/min"]
     Instances = ["*"]
     Measurement = "msexchange"
    
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchangeUMAvailability"
     Counters = ["Directory Access Failures","Total Inbound Calls Rejected by the UM Service",
	         "Total Inbound Calls Rejected by the UM Worker Process"]
     Instances = ["*"]
     Measurement = "msexchange"
    
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchange Availability Service"
     Counters = ["Average Time to Process a Free Busy Request"]
     Instances = ["*"]
     Measurement = "msexchange"
    
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchange OWA"
     Counters = ["Current Unique Users", "Requests/sec", "Average Search Time"]
     Instances = ["*"]
     Measurement = "msexchange.owa"
	
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchangeFrontEndTransport SmtpSend"
     Counters = ["Bytes Sent Total", "Messages Sent Total"]
     Instances = ["*"]
     Measurement = "msexchange"
    
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchangeIS Store"
     Counters = ["RPC Average Latency", "RPC Requests","RPC Operations/sec", ]
     Instances = ["*"]
     Measurement = "msexchange"
	   
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchangeIS Client Type"
     Counters = ["RPC Average Latency", "RPC Operations/sec" ]
     Instances = ["*"]
     Measurement = "msexchange.is.client"
	
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchange ADAccess Processes"
     Counters = ["LDAP Read Time", "LDAP Search Time"]
     Instances = ["*"]
     Measurement = "msexchange"
		
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchange ActiveSync"
     Counters = ["Mailbox Search Total", "Requests/sec", "Ping Commands Pending", "Current Requests", 
                 "Average Request Time", "Sync Commands/sec"]
     Instances = ["*"]
     Measurement = "msexchange.active.sync"
		
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchange Active Manager Server"
     Counters = ["Server-Side Calls/sec", "Active Manager Database State writes to Persistent storage/sec", 
                 "GetServerForDatabase Server-Side Calls", "Total Number of Databases", "Active Manager Role"]
     Instances = ["*"]
     Measurement = "msexchange"
    	
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchangeAutodiscover"
     Counters = ["Requests/sec"]
     Instances = ["*"]
     Measurement = "msexchange.auto.disc"
    	
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchangeWS"
     Counters = ["Requests/sec"]
     Instances = ["*"]
     Measurement = "msexchange.ws"
    	
   [[inputs.win_perf_counters.object]]
     ObjectName = "Web Service"
     Counters = ["Current Connections","Connection Attempts/sec","Other Request Methods/sec"]
     Instances = ["_Total"]
     Measurement = "msexchange.ws"
	
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchange WorkloadManagement Workloads"
     Counters = ["ActiveTasks","CompletedTasks","QueuedTasks"]
     Instances = ["*"]
     Measurement = "msexchange.workload"
	
   [[inputs.win_perf_counters.object]]
     ObjectName = "ASP.NET"
     Counters = ["Application Restarts","Worker Process Restarts","Request Wait Time"]
     Instances = ["*"]
     Measurement = "msexchange.asp.net"
	
   [[inputs.win_perf_counters.object]]
     ObjectName = "MSExchange RpcClientAccess"
     Counters = ["RPC Averaged Latency", "RPC Requests", "Active User Count", "Connection Count", 
                 "RPC Operations/sec", "User Count"]
     Instances = ["*"]
     Measurement = "msexchange.rpc.client"

Add one of the following snippets to enable the Transport Queues performance counters:

For MSExchange Server 2010

 [[inputs.win_perf_counters.object]]
   ObjectName = "MSExchangeTransport Queues(_total)"
   Counters = ["Aggregate Delivery Queue Length", "Active Remote Delivery Queue Length",
               "Active Mailbox Delivery Queue Length", "Submission Queue Length",
               "Active Non-Smtp Delivery Queue Length", "Retry Mailbox Delivery Queue Length",
               "Retry Non-Smtp Delivery Queue Length", "Retry Remote Delivery Queue Length",
               "Unreachable Queue Length", "Largest Delivery Queue Length", "Poison Queue Length"]
   Instances = ["*"]
   Measurement = "msexchange.transport"

For MSExchange Servers 2013, 2016 and 2019:

 [[inputs.win_perf_counters.object]]
   ObjectName = "MSExchangeTransport Queues"
   Counters = ["Active Mailbox Delivery Queue Length", "Active Non-Smtp Delivery Queue Length",
               "Aggregate Shadow Queue Length", "Categorizer Job Availability",
               "Delay Queue Length", "External Active Remote Delivery Queue Length",
               "External Aggregate Delivery Queue Length (All External Total)",
               "External Largest Delivery Queue Length", "External Largest Unlocked Delivery Queue Length",
               "External Retry Remote Delivery Queue Length", "Internal Active Remote Delivery Queue Length",
               "Internal Aggregate Delivery Queue Length (All External Total)",
               "Internal Largest Delivery Queue Length", "Internal Largest Unlocked Delivery Queue Length",
               "Internal Retry Remote Delivery Queue Length", "Items Completed Delivery Per Second",
               "Items Completed Delivery Total", "Items Deleted By Admin Total",
               "Items Queued For Delivery Expired Total", "Items Queued for Delivery Per Second",
               "Items Queued For Delivery Total", "Items Resubmitted Total", "Locks Expired In Delivery Total",
               "Messages Completed Delivery Per Second", "Messages Completed Delivery Total",
               "Messages Completed Categorization", "Messages Deferred during Categorization",
               "Messages Delayed Per Second", "Messages Delayed Total", "Messages Queued for Delivery",
               "Messages Queued for Delivery Per Second",  "Messages Queued For Delivery Total",
               "Messages Resubmitted during Categorization", "Messages Submitted Per Second",
               "Messages Submitted Recently", "Messages Submitted Total", "Poison Queue Length",
               "Retry Mailbox Delivery Queue Length", "Retry Non-Smtp Delivery Queue Length",
               "Shadow Queue Auto Discards Total", "Submission Queue Items Expired Total",
               "Submission Queue Length", "Submission Queue Locks Expired Total",
               "Throttled Fork Agent Queued Messages", "Throttled Fork Agent Queued Recipients",
               "Total Extra Connections for Idle Queues", "Unreachable Queue Length"]
   Instances = ["_total"]
   Measurement = "msexchange.transport"

Note: Make sure all [[inputs.win_perf_counters.object]] configuration snippets are inside the [[inputs.win_perf_counters]] configuration section. If there are any [[inputs.win_perf_counters.object]] configuration snippets added prior to enabling Microsoft Exchange, move those snippets into the [[inputs.win_perf_counters]].

Step 4. Restart Telegraf

After any changes restart your Telegraf agent service.