Amazon WorkSpaces

Overview

Amazon WorkSpaces is a fully managed, secure desktop computing service which runs on the AWS cloud.

Enable this integration to see in Datadog all your Amazon WorkSpaces metrics.

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first. There are no other installation steps that need to be performed.

Metric collection

  1. In the AWS integration page, ensure that WorkSpaces is enabled under the Metric Collection tab.
  2. Install the Datadog - Amazon WorkSpaces integration.

Log collection

Enable logging

Configure Amazon WorkSpaces to send logs either to a S3 bucket or to CloudWatch.

Note: If you log to a S3 bucket, make sure that amazon_workspace is set as Target prefix.

Send logs to Datadog

  1. If you haven’t already, set up the Datadog Forwarder Lambda function.

  2. Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your Amazon WorkSpaces logs in the AWS console:

Data Collected

Metrics

aws.workspaces.available
(gauge)
The number of WorkSpaces that returned a healthy status.
aws.workspaces.connection_attempt
(count)
The number of connection attempts.
aws.workspaces.connection_failure
(count)
The number of failed connections.
aws.workspaces.connection_success
(count)
The number of successful connections.
aws.workspaces.in_session_latency
(gauge)
The round trip time between the WorkSpaces client and the WorkSpace.
Shown as millisecond
aws.workspaces.maintenance
(gauge)
The number of WorkSpaces that are under maintenance.
aws.workspaces.session_disconnect
(count)
The number of connections that were closed, including user-initiated and failed connections.
aws.workspaces.session_launch_time
(gauge)
The amount of time it takes to initiate a WorkSpaces session.
Shown as second
aws.workspaces.stopped
(gauge)
The number of WorkSpaces that are stopped.
aws.workspaces.unhealthy
(gauge)
The number of WorkSpaces that returned an unhealthy status.
aws.workspaces.user_connected
(gauge)
The number of WorkSpaces that have a user connected.

Each of the metrics retrieved from AWS are assigned the same tags that appear in the AWS console, including but not limited to host name, security-groups, and more.

Events

The Amazon WorkSpaces integration does not include any events.

Service Checks

The Amazon WorkSpaces integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.