As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Monitore suas CloudWatch métricas WorkSpaces de uso
WorkSpaces e a Amazon CloudWatch estão integradas, para que você possa reunir e analisar métricas de desempenho. Você pode monitorar essas métricas usando o CloudWatch console, a interface da linha de CloudWatch comando ou programaticamente usando a CloudWatch API. CloudWatch também permite que você defina alarmes quando você atinge um limite especificado para uma métrica.
Para obter mais informações sobre o uso CloudWatch de alarmes, consulte o Guia [ do CloudWatch usuário ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/) da Amazon.
**Pré-requisitos**
Para obter CloudWatch métricas, habilite o acesso na porta 443 no `AMAZON` subconjunto na `us-east-1` região. Para obter mais informações, consulte [Requisitos de endereço IP e porta para WorkSpaces Pessoal](workspaces-port-requirements.md).
**Topics**
+ [WorkSpaces métricas](#wsp-metrics)
+ [Dimensões para WorkSpaces métricas](#wsp-metric-dimensions)
+ [Exemplo de monitoramento](#monitoring_example)
## WorkSpaces métricas
O namespace `AWS/WorkSpaces` inclui as métricas a seguir.
| Métrica | Description | Dimensões | Statistics | Unidades |
| --- | --- | --- | --- | --- |
| `Available` | O número WorkSpaces deles é saudável. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, soma, máximo, mínimo, amostragens de dados | Contagem |
| `Unhealthy` | O número deles WorkSpaces não é saudável. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, soma, máximo, mínimo, amostragens de dados | Contagem |
| `Stopped` | O número deles WorkSpaces está parado. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, soma, máximo, mínimo, amostragens de dados | Contagem |
| `Maintenance` | O número deles WorkSpaces está em manutenção. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, soma, máximo, mínimo, amostragens de dados | Contagem |
| `ConnectionAttempt`1 | O número de tentativas de conexão. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, soma, máximo, mínimo, amostragens de dados | Contagem |
| `ConnectionSuccess`1 | O número de conexões bem-sucedidas. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, soma, máximo, mínimo, amostragens de dados | Contagem |
| `ConnectionFailure`1 | O número de conexões com falha. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, soma, máximo, mínimo, amostragens de dados | Contagem |
| `SessionLaunchTime`1 | A quantidade de tempo necessária para iniciar uma WorkSpaces sessão. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima, Amostras de dados | Segundos |
| `SessionDisconnect` | O número de sessões que foram desconectadas. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, soma, máximo, mínimo, amostragens de dados | Contagem |
| `UserConnected` | O número de WorkSpaces pessoas que têm um usuário conectado. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, soma, máximo, mínimo, amostragens de dados | Contagem |
| `TrustedDeviceValidationAttempt`2 | O número de tentativas de validação da assinatura de autenticação do dispositivo. | `DirectoryId` | Média, soma, máximo, mínimo, amostragens de dados | Contagem |
| `TrustedDeviceValidationSuccess`2 | O número de validações da assinatura de autenticação do dispositivo bem-sucedidas. | `DirectoryId` | Média, soma, máximo, mínimo, amostragens de dados | Contagem |
| `TrustedDeviceValidationFailure`2 | O número de validações da assinatura de autenticação do dispositivo com falha. | `DirectoryId` | Média, soma, máximo, mínimo, amostragens de dados | Contagem |
| `TrustedDeviceCertificateDaysBeforeExpiration` | Dias restantes até que o certificado raiz associado ao diretório expire. | `CertificateId` | Média, soma, máximo, mínimo, amostragens de dados | Contagem |
| `CPUUsage` | A porcentagem do recurso de CPU usado. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima | Porcentagem |
| `MemoryUsage` | A porcentagem da memória da máquina usada. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima | Porcentagem |
| `RootVolumeDiskUsage` | A porcentagem de volume do disco raiz usado. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima | Porcentagem |
| `UserVolumeDiskUsage` | A porcentagem de volume do disco do usuário usado. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima | Porcentagem |
| `GPUUsage` | A porcentagem do recurso de GPU usado no WorkSpace. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima | Porcentagem |
| `CPUQueueLength` | O número de threads aguardando o tempo de CPU no WorkSpace. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima | Contagem |
| `RootVolumeDiskIOQueueLength` | O número de I/O solicitações pendentes aguardando para serem processadas pelo disco de volume raiz no WorkSpace. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima | Contagem |
| `UserVolumeDiskIOQueueLength` | O número de I/O solicitações pendentes aguardando para serem processadas pelo disco de volume do usuário no WorkSpace. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima | Contagem |
| `MemoryPageHardFaults` | A taxa de falhas de página rígida no WorkSpace. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima | Count/Second |
| `PagingFileUsage` | A porcentagem do arquivo de paginação que está atualmente em uso no WorkSpace. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima | Porcentagem |
| `UpTime` | O tempo desde a última reinicialização de um WorkSpace. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima, Amostras de dados | Segundos |
| `InSessionLatency` | O tempo de ida e volta entre o WorkSpaces cliente e WorkSpace o. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima, Amostras de dados | Milissegundos |
| `UDPPacketLossRate`3 | A porcentagem de pacotes UDP perdidos no tráfego entre o gateway e o cliente. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima, Amostras de dados | Porcentagem |
| `TCPRetransmissionRate`4 | A porcentagem de segmentos TCP que foram retransmitidos do gateway para o cliente. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima, Amostras de dados | Porcentagem |
| `Bandwidth`4 | A taxa de transferência de dados do gateway para o cliente (saída). | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima, Amostras de dados | Kilobits/Second |
| `BandwidthInbound`4 | A taxa de transferência de dados do cliente para o gateway (entrada). | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima, Amostras de dados | Kilobits/Second |
| `CongestionWindow`4 | O tamanho da janela de congestionamento no gateway para o tráfego que flui para o cliente. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima, Amostras de dados | Bytes |
| `ConnectionDuration`4 | A duração da conexão de streaming. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima, Amostras de dados | Segundos |
| `FramesPerSecond`4 | O número de quadros enviados por segundo do WorkSpace para o cliente. | `DirectoryId`
`WorkspaceId`
`RunningMode`
`Protocol`
`ComputeType`
`BundleId`
`UserName`
`ComputerName` | Média, Máxima, Mínima | Count/Second |
1 WorkSpaces registra métricas sobre as conexões feitas com cada um WorkSpace. Essas métricas são emitidas depois que um usuário é autenticado com sucesso por meio do WorkSpaces cliente e, em seguida, o cliente inicia uma conexão de sessão.
2 Se o recurso de dispositivos confiáveis estiver habilitado para o diretório, a Amazon WorkSpaces usará a autenticação baseada em certificados para determinar se um dispositivo é confiável. Quando os usuários tentam acessar seus WorkSpaces, essas métricas são emitidas para indicar uma autenticação bem-sucedida ou falhada de dispositivos confiáveis. Essas métricas são aplicáveis somente aos aplicativos cliente Windows e macOS.
3 A direção da medição depende do protocolo subjacente.
+ **No PCoIP**: mede a perda do cliente para o gateway.
+ **No DCV**: mede a perda do gateway para o cliente.
4 Disponível somente em DCV.
## Dimensões para WorkSpaces métricas
Para filtrar os dados das métricas, use as dimensões a seguir.
| Dimensão | Description |
| --- | --- |
| `DirectoryId` | Filtra os dados métricos para o WorkSpaces no diretório especificado. O formato do ID do diretório é `d-XXXXXXXXXX`. |
| `WorkspaceId` | Filtra os dados métricos de acordo com o especificado WorkSpace. A forma do WorkSpace ID é`ws-XXXXXXXXXX`. |
| `CertificateId` | Filtra os dados de métricas para o certificado raiz especificado associado ao diretório. O formato do ID do certificado é `wsc-XXXXXXXXX`. |
| `RunningMode` | Filtra os dados métricos de acordo WorkSpaces com o modo de execução. A forma do modo de execução é AutoStop ou AlwaysOn. |
| `BundleId` | Filtra os dados métricos de WorkSpaces acordo com o protocolo. A forma do pacote é `wsb-XXXXXXXXXX`. |
| `ComputeType` | Filtra os dados métricos até o WorkSpaces pelo tipo de computação. |
| `Protocol` | Filtra os dados métricos para o WorkSpaces pelo tipo de protocolo. |
| `UserName` | Filtra os dados métricos até o WorkSpaces pelo nome do usuário. O `UserName` não pode conter caracteres não ASCII, como os seguintes: Letras acentuadas: é, à, ö, ñ etc. Non-Latin alfabetos Símbolos: ©, ®, €, £, µ, ⟩ etc. |
| `ComputerName` | Filtra os dados métricos de acordo com o especificado WorkSpace. Veja vários formatos para Nome do [ WorkSpaces computador]( https://docs.aws.amazon.com/workspaces/latest/adminguide/wsp-directory-identify-computer.html). |
## Exemplo de monitoramento
O exemplo a seguir demonstra como você pode usar o AWS CLI para responder a um CloudWatch alarme e determinar quais WorkSpaces em um diretório tiveram falhas de conexão.
**Para responder a um CloudWatch alarme**
1. Determine o diretório ao qual o alarme se aplica usando o comando [describe-alarms](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/describe-alarms.html).
```
aws cloudwatch describe-alarms --state-value "ALARM"
{
"MetricAlarms": [
{
...
"Dimensions": [
{
"Name": "DirectoryId",
"Value": "{{directory_id}}"
}
],
...
}
]
}
```
1. Obtenha a lista de WorkSpaces no diretório especificado usando o comando [https://docs.aws.amazon.com/cli/latest/reference/workspaces/describe-workspaces.html](https://docs.aws.amazon.com/cli/latest/reference/workspaces/describe-workspaces.html) describe-workspaces.
```
aws workspaces describe-workspaces --directory-id {{directory_id}}
{
"Workspaces": [
{
...
"WorkspaceId": "{{workspace1_id}}",
...
},
{
...
"WorkspaceId": "{{workspace2_id}}",
...
},
{
...
"WorkspaceId": "{{workspace3_id}}",
...
}
]
}
```
1. Obtenha as CloudWatch métricas de cada um WorkSpace no diretório usando o comando [ get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html).
```
aws cloudwatch get-metric-statistics \
--namespace AWS/WorkSpaces \
--metric-name ConnectionFailure \
--start-time 2015-04-27T00:00:00Z \
--end-time 2015-04-28T00:00:00Z \
--period 3600 \
--statistics Sum \
--dimensions "Name=WorkspaceId,Value={{workspace_id}}"
{
"Datapoints" : [
{
"Timestamp": "2015-04-27T00:18:00Z",
"Sum": 1.0,
"Unit": "Count"
},
{
"Timestamp": "2014-04-27T01:18:00Z",
"Sum": 0.0,
"Unit": "Count"
}
],
"Label" : "ConnectionFailure"
}
```