---
title: Amazon WorkSpaces
description: >-
  Amazon WorkSpaces is a fully managed, secure desktop computing service which
  runs on the AWS cloud.
breadcrumbs: Docs > Integrations > Amazon WorkSpaces
---

# Amazon WorkSpaces
Integration version1.0.0
## Overview{% #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{% #setup %}

### Installation{% #installation %}

If you haven't already, set up the [Amazon Web Services integration](https://docs.datadoghq.com/integrations/amazon_web_services/) first. There are no other installation steps that need to be performed.

### Metric collection{% #metric-collection %}

1. In the [AWS integration page](https://app.datadoghq.com/integrations/amazon-web-services), ensure that `WorkSpaces` is enabled under the `Metric Collection` tab.
1. Install the [Datadog - Amazon WorkSpaces integration](https://app.datadoghq.com/integrations/amazon-workspaces).

### Log collection{% #log-collection %}

#### Enable logging{% #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{% #send-logs-to-datadog %}

1. If you haven't already, set up the [Datadog Forwarder Lambda function](https://docs.datadoghq.com/logs/guide/forwarder/).

1. 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:

   - [Add a manual trigger on the S3 bucket](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function/#collecting-logs-from-s3-buckets)
   - [Add a manual trigger on the CloudWatch Log Group](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function/#collecting-logs-from-cloudwatch-log-group)

## Data Collected{% #data-collected %}

### Metrics{% #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{% #events %}

The Amazon WorkSpaces integration does not include any events.

### Service Checks{% #service-checks %}

The Amazon WorkSpaces integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).