

# WorkSpaces Applications Metrics and Dimensions
<a name="monitoring-with-cloudwatch"></a>

Amazon WorkSpaces Applications sends the following metrics and dimension information to Amazon CloudWatch.

All of the following metrics except `InsufficientConcurrencyLimitError` apply to Always-On and On-Demand fleets. The only metrics that apply to Elastic fleets are `InUseCapacity` and `InsufficientCapacityError`.

WorkSpaces Applications sends metrics to CloudWatch one time every minute. The `AWS/AppStream` namespace includes the following metrics.

**Topics**
+ [

# Fleet Usage Metrics for Single-session Fleets
](appstream-dimensions.md)
+ [

# Fleet Usage Metrics for Multi-session Fleets
](usage-metrics-multi-session.md)
+ [

# Instance and Session Performance Metrics for Single-session and Multi-session Fleets
](instance-session-metrics-single-session-multi-session.md)
+ [

# Dimensions for Amazon WorkSpaces Applications Metrics
](dimensions-metrics.md)

# Fleet Usage Metrics for Single-session Fleets
<a name="appstream-dimensions"></a>

The following are fleet usage metrics for single-session fleets.


| Metric | Description | Dimensions | Statistics | Units | 
| --- | --- | --- | --- | --- | 
| ActualCapacity |  The total number of instances that are available for streaming or are currently streaming. <pre>ActualCapacity = AvailableCapacity + InUseCapacity</pre>  | [Fleet] | Average, Minimum, Maximum | Count | 
|  AvailableCapacity  |  The number of idle instances currently available for user sessions. <pre>AvailableCapacity = ActualCapacity - InUseCapacity</pre>  | [Fleet] | Average, Minimum, Maximum | Count | 
| CapacityUtilization |  The percentage of instances in a fleet that are being used, using the following formula. <pre>CapacityUtilization = (InUseCapacity/ActualCapacity) * 100</pre> Monitoring this metric helps with decisions about increasing or decreasing the value of a fleet's desired capacity.  | [Fleet] | Average, Minimum, Maximum | Percent | 
|  DesiredCapacity  |  The total number of instances that are either running or pending. This represents the total number of concurrent streaming sessions your fleet can support in a steady state. <pre>DesiredCapacity = ActualCapacity + PendingCapacity</pre>  | [Fleet] | Average, Minimum, Maximum | Count | 
|  InUseCapacity  |  The number of instances currently being used for streaming sessions. One `InUseCapacity` count represents one streaming session.  | [Fleet] | Average, Minimum, Maximum | Count | 
|  PendingCapacity  |  The number of instances being provisioned by WorkSpaces Applications. Represents the additional number of streaming sessions the fleet can support after provisioning is complete. When provisioning starts, it usually takes 10-20 minutes for an instance to become available for streaming.  | [Fleet] | Average, Minimum, Maximum | Count | 
| RunningCapacity |  The total number of instances currently running. Represents the number of concurrent streaming sessions that can be supported by the fleet in its current state. This metric is provided for Always-On fleets only, and has the same value as the `ActualCapacity` metric.  | [Fleet] | Average, Minimum, Maximum | Count | 
|  InsufficientCapacityError  |  The number of session requests rejected due to lack of capacity. You can set alarms to use this metric to be notified of users waiting for streaming sessions.  | [Fleet] | Average, Minimum, Maximum, Sum | Count | 
|  InsufficientConcurrencyLimitError  |  The number of Elastic fleet session requests rejected due to reaching max concurrent streaming capacity. You can set alarms to use this metric to be notified of users waiting for streaming sessions.  | [Fleet] | Average, Minimum, Maximum, Sum | Count | 

# Fleet Usage Metrics for Multi-session Fleets
<a name="usage-metrics-multi-session"></a>

The following are fleet usage metrics for multi-session fleets.


| Metric | Description | Dimensions | Statistics | Units | 
| --- | --- | --- | --- | --- | 
| CapacityUtilization |  The percentage of sessions in a fleet that are being used, using the following formula. <pre>CapacityUtilization = (ActiveUserSessionCapacity / ActualUserSessionCapacity) * 100</pre> Monitoring this metric helps with decisions about increasing or decreasing the value of a fleet's desired capacity.  | [Fleet] | Average, Minimum, Maximum | Percent | 
| ActualUserSessionCapacity |  The total number of session slots that are available for streaming or are currently streaming. <pre>ActualUserSessionCapacity = AvailableUserSessionCapacity + ActiveUserSessionCapacity</pre>  | [Fleet] | Average, Minimum, Maximum | Count | 
|  AvailableUserSessionCapacity  |  The number of idle session slots currently available for user sessions. <pre>AvailableUserSessionCapacity = ActualUserSessionCapacity - ActiveUserSessions</pre>  | [Fleet] | Average, Minimum, Maximum | Count | 
|  DesiredUserSessionCapacity  |  The total number of session slots that are either running or pending. This represents the total number of concurrent streaming sessions your fleet can support in a steady state. <pre>DesiredUserSessionCapacity = ActualUserSessionCapacity + PendingUserSessionCapacity</pre>  | [Fleet] | Average, Minimum, Maximum | Count | 
| ActiveUserSessionCapacity |  The number of user sessions currently being used for streaming sessions.   | [Fleet] | Average, Minimum, Maximum | Count | 
|  PendingUserSessionCapacity  |  The number of session slots being provisioned by WorkSpaces Applications. Represents the additional number of streaming sessions the fleet can support after provisioning is complete. When provisioning starts, it usually takes 10-20 minutes for an instance to become available for streaming.  | [Fleet] | Average, Minimum, Maximum | Count | 
| RunningUserSessionCapacity |  The total number of session slots currently that are available for streaming or are currently streaming. Represents the number of concurrent streaming sessions that can be supported by the fleet in its current state. This metric is provided for Always-On fleets only, and has the same value as the `ActualUserSessionCapacity` metric.  | [Fleet] | Average, Minimum, Maximum | Count | 
| DrainingCapacity |  The number of instances in Drain Mode.  | [Fleet] | Average, Minimum, Maximum | Count | 
| DrainModeActiveUserSessionCapacity |  The number of active user sessions on instances in Drain Mode.  | [Fleet] | Average, Minimum, Maximum | Count | 
| DrainModeUnusedUserSessionCapacity |  The number of unused session slots on instances in Drain Mode which cannot be used for user session provisioning.  | [Fleet] | Average, Minimum, Maximum | Count | 

# Instance and Session Performance Metrics for Single-session and Multi-session Fleets
<a name="instance-session-metrics-single-session-multi-session"></a>

The following are instance and session performance metrics for single-session and multi-session fleets.


| Metric | Description | Dimensions | Statistics | Units | 
| --- | --- | --- | --- | --- | 
| CpuUtilizationInstance |  The percentage of allocated compute units that are currently in use on the instance.  |  [Fleet] [UserId] [FleetName, InstanceId] [FleetName, InstanceId, SessionId, UserId]  | Average, Minimum, Maximum | Percent | 
| MemoryUtilizationInstance |  The percentage of allocated physical memory units that are currently in use on the instance.  |  [Fleet] [UserId] [FleetName, InstanceId] [FleetName, InstanceId, SessionId, UserId]  | Average, Minimum, Maximum | Percent | 
|  PagingFileUtilizationInstance  |  The percentage of the paging file that is currently in use to extend the Memory (RAM) capacity.  |  [Fleet] [UserId] [FleetName, InstanceId] [FleetName, InstanceId, SessionId, UserId]  | Average, Minimum, Maximum | Percent | 
|  DiskUtilizationInstance  |  The percentage of disk units that are currently in use to run programs and carry out tasks on the instance.  |  [Fleet] [UserId] [FleetName, InstanceId] [FleetName, InstanceId, SessionId, UserId]  | Average, Minimum, Maximum | Percent | 
| CpuUtilizationSession |  The percentage of allocated compute units that are currently in use by the session.  |  [Fleet] [UserId] [FleetName, InstanceId, SessionId] [FleetName, InstanceId, SessionId, UserId]  | Average, Minimum, Maximum | Percent | 
|  MemoryUtilizationSession  |  The percentage of allocated physical memory units that are currently in use by the session.  |  [Fleet] [UserId] [FleetName, InstanceId, SessionId] [FleetName, InstanceId, SessionId, UserId]  | Average, Minimum, Maximum | Percent | 
| DiskReadOperations |  Amount of disk reads per instance  |  [Fleet] [UserId] [FleetName, InstanceId] [FleetName, InstanceId, SessionId, UserId]  | Average, Minimum, Maximum | Count | 
| DiskWriteOperations |  Amount of disk write per instance  |  [Fleet] [UserId] [FleetName, InstanceId] [FleetName, InstanceId, SessionId, UserId]  | Average, Minimum, Maximum | Count | 
| InSessionLatency |  Round trip time between WorkSpaces Application server and client measured at p90  |  [Fleet] [UserId] [FleetName, InstanceId, SessionId] [FleetName, InstanceId, SessionId, UserId]  | Average, Minimum, Maximum | Milliseconds | 
| FramesPerSecond |  Frames per second for the specific session  |  [Fleet] [UserId] [FleetName, InstanceId, SessionId] [FleetName, InstanceId, SessionId, UserId]  | Average, Minimum, Maximum | Count | 
| Bandwidth |  Amount of data transferred between WorkSpaces Applications service and Client during the session.  |  [Fleet] [UserId] [FleetName, InstanceId, SessionId] [FleetName, InstanceId, SessionId, UserId]  | Average, Minimum, Maximum | Kilobits/Second | 

# Dimensions for Amazon WorkSpaces Applications Metrics
<a name="dimensions-metrics"></a>

The `AWS/AppStream` namespace includes the following dimensions and dimension groups.


| Dimension | Description | 
| --- | --- | 
| Fleet | Filters the metric data by name of the Fleet. | 
| FleetName | Filters the metric data by name of the Fleet. | 
| SessionId | Filters the metric data by session identifier. | 
| InstanceId | Filters the metric data by instance identifier. | 
| UserId | Filters the metric data by user identifier. | 


| Dimension | Where Available in Amazon CloudWatch Metrics | 
| --- | --- | 
| [Fleet] | Fleet Metrics | 
| [FleetName, InstanceId] | Fleet Instance Metrics | 
| [FleetName, InstanceId, SessionId] | Fleet Session Metrics | 
| [UserId] | UserId | 
| [FleetName, InstanceId, SessionId, UserId] | FleetName, InstanceId, SessionId, UserId | 