Skip to content

Latest commit

 

History

History
 
 

exchange_server

Microsoft Exchange Server Integration

Overview

Get metrics from Microsoft Exchange Server

  • Visualize and monitor Exchange server performance

Setup

Installation

The Exchange check is included in the Datadog Agent package, so you don't need to install anything else on your servers.

Configuration

  1. Edit the exchange_server.d/conf.yaml file, in the conf.d/ folder at the root of your Agent's configuration directory to start collecting your Exchange Server performance data.

  2. Restart the Agent.

Note: Versions 1.11.0 or later of this check use a new implementation for metric collection, which requires Python 3. For hosts that are unable to use Python 3, or if you would like to use a legacy version of this check, refer to the following config.

Log collection

  1. Collecting logs is disabled by default in the Datadog Agent, you need to enable it in datadog.yaml:

    logs_enabled: true
  2. Add this configuration block to your exchange_server.d/conf.yaml file to start collecting your Exchange Server Logs:

    logs:
      - type: file
        path: "C:\\Program Files\\Microsoft\\Exchange Server\\V15\\TransportRoles\\Logs\\CommonDiagnosticsLog\\*"
        source: exchange-server
      - type: file
        path: "C:\\Program Files\\Microsoft\\Exchange Server\\V15\\TransportRoles\\Logs\\ThrottlingService\\*"
        source: exchange-server
      - type: file
        path: "C:\\Program Files\\Microsoft\\Exchange Server\\V15\\TransportRoles\\Logs\\Hub\\Connectivity\\*"
        source: exchange-server

    Note: The only logs supported are CommonDiagnosticsLog, ThrottlingService, and Connectivity logs due to Exchange Server outputting many different types of logs. Contact Datadog support to request other logs formats.

    Change the path parameter value and configure it for your environment. See the sample exchange_server.d/conf.yaml for all available configuration options.

  3. Restart the Agent.

Validation

Run the Agent's status subcommand and look for exchange_server under the Checks section.

Data Collected

Metrics

See metadata.csv for a list of metrics provided by this integration.

Events

The Exchange server check does not include any events.

Service Checks

The Exchange server check does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.