Métricas do WorkSpaces Dimensões para métricas do WorkSpaces Exemplo de monitoramento

Monitorar WorkSpaces usando as métricas do CloudWatch

O WorkSpaces e o Amazon CloudWatch são integrados, então é possível reunir e analisar métricas de performance. Você pode monitorar essas métricas usando o console do CloudWatch, a interface de linha de comando do CloudWatch ou de forma programática usando a API do CloudWatch. O CloudWatch também permite que você defina alarmes quando alcança um limite especificado para uma métrica.

Para obter mais informações sobre o uso do CloudWatch e dos alarmes, consulte o Guia do usuário do Amazon CloudWatch.

Pré-requisitos

Para obter as métricas do CloudWatch, habilite o acesso na porta 443 da sub-rede AMAZON na região us-east-1 . Para obter mais informações, consulte Requisitos de endereço IP e porta para WorkSpaces Personal.

Métricas do WorkSpaces

O namespace AWS/WorkSpaces inclui as métricas a seguir.

Métrica	Descrição	Dimensões	Statistics	Unidades
`Available`¹	O número de WorkSpaces que retornaram um status 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 de WorkSpaces que retornaram um status não saudável.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Média, soma, máximo, mínimo, amostragens de dados	Contagem
`ConnectionAttempt`²	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`²	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`²	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`^2, ⁶	O tempo necessário para iniciar uma sessão de WorkSpaces.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Média, soma, máximo, mínimo, amostragens de dados	Segundos (tempo)
`InSessionLatency`^2, ⁶	O tempo de ida e volta entre o cliente do WorkSpaces e o WorkSpace.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Média, soma, máximo, mínimo, amostragens de dados	Milissegundos (tempo)
`SessionDisconnect`^2, ⁶	O número de conexões que foram fechadas, incluindo conexões com falha e iniciadas pelo usuário.	`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 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
`Stopped`	O número de Espaços de trabalho que estão parados.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Média, soma, máximo, mínimo, amostragens de dados	Contagem
`Maintenance`⁴	O número de Espaços de trabalho que estão em manutenção.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Média, soma, máximo, mínimo, amostragens de dados	Contagem
`TrustedDeviceValidationAttempt`^5, ⁶	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`^5, ⁶	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`^5, ⁶	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
`UDPPacketLossRate`⁷	A porcentagem de pacotes descartados entre o cliente e o gateway.	`DirectoryId` `WorkspaceId` `RunningMode` `Protocol` `ComputeType` `BundleId` `UserName` `ComputerName`	Média, Máxima, Mínima, Amostras de dados	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

¹ O WorkSpaces envia periodicamente solicitações de status para um WorkSpace. Um WorkSpace é marcado com Available quando responde a essas solicitações e com Unhealthy quando falha em responder a essas solicitações. Essas métricas estão disponíveis em nível de granularidade por WorkSpace e também são agrupadas para todos os WorkSpaces em uma organização.

² O WorkSpaces registra métricas em conexões feitas com cada WorkSpace. Essas métricas são emitidas depois que um usuário é autenticado com êxito por meio do cliente do WorkSpaces e o cliente inicia a sessão. As métricas estão disponíveis em nível de granularidade por WorkSpace e também são agrupadas para todos os WorkSpaces em um diretório.

³ O WorkSpaces envia periodicamente solicitações de status de conexão para um WorkSpace. Os usuários são reportados como conectados quando estão utilizando ativamente suas sessões. Essa métrica está disponível em nível de granularidade por WorkSpace e também são agrupadas para todos os WorkSpaces em uma organização.

⁴ Esta métrica se aplica a WorkSpaces configurados com modo em execução AutoStop. Se você tem a manutenção habilitada para o WorkSpaces, esta métrica captura o número de WorkSpaces que estão atualmente em manutenção. Esta métrica está disponível em nível de granularidade por WorkSpace, que descreve quando um WorkSpace entrou em manutenção e quando foi removido.

⁵ Se o atributo de dispositivos confiáveis estiver habilitado para o diretório, o Amazon WorkSpaces usa autenticação baseada em certificado para determinar se um dispositivo é confiável. Quando os usuários tentam acessar seus WorkSpaces, essas métricas são emitidas para indicar êxito ou falha na autenticação do dispositivo confiável. Essas métricas estão disponíveis em um nível de granularidade por diretório e somente para as aplicações cliente Windows e macOS do Amazon WorkSpaces.

⁶ Não disponível no Acesso via Web do WorkSpaces.

⁷ Essa métrica mede a perda média de pacotes.

No PCoIP: mede a perda média de pacotes UDP do cliente para o gateway.

nota
Isso é medido no gateway.
No DCV: mede a perda de pacotes UDP do gateway para o cliente.

nota
Isso é medido no gateway.

Dimensões para métricas do WorkSpaces

Para filtrar os dados das métricas, use as dimensões a seguir.

Dimensão	Descrição
`DirectoryId`	Filtra os dados de métrica para o WorkSpaces no diretório especificado. O formato do ID do diretório é `d-XXXXXXXXXX`.
`WorkspaceId`	Filtra os dados de métrica para o WorkSpace especificado. O formato do ID do WorkSpace é `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 de métricas para os WorkSpaces por modo de execução. A forma do modo de execução é AutoStop ou AlwaysOn.
`BundleId`	Filtra os dados de métricas para os WorkSpaces por protocolo. A forma do pacote é `wsb-XXXXXXXXXX`.
`ComputeType`	Filtra os dados de métricas para os WorkSpaces pelo tipo de computação.
`Protocol`	Filtra os dados de métricas para os WorkSpaces pelo tipo de protocolo.
`UserName`	Filtra os dados de métricas para os WorkSpaces pelo nome do usuário. nota O `UserName` não pode conter caracteres não ASCII, como os seguintes: Letras acentuadas: é, à, ö, ñ etc. Alfabetos não latinos Símbolos: ©, ®, €, £, µ, ⟩ etc.
`ComputerName`	Filtra os dados de métrica para o WorkSpace especificado. Veja vários formatos para o nome do computador do WorkSpaces.

Exemplo de monitoramento

O exemplo a seguir demonstra como você pode usar a AWS CLI para responder a um alarme do CloudWatch e determinar quais WorkSpaces em um diretório passaram por falhas de conexão.

Como responder a um alarme do CloudWatch

Determine o diretório ao qual o alarme se aplica usando o comando describe-alarms.


aws cloudwatch describe-alarms --state-value "ALARM"

{
  "MetricAlarms": [
    {
      ...
      "Dimensions": [
        {
          "Name": "DirectoryId",
          "Value": "directory_id"
        }
      ],
      ...
    }
  ]
}

Obtenha a lista de WorkSpaces no diretório especificado usando o comando describe-workspaces.


aws workspaces describe-workspaces --directory-id directory_id

{
  "Workspaces": [
    {
      ...
      "WorkspaceId": "workspace1_id",
      ...
    },
    {
      ...
      "WorkspaceId": "workspace2_id",
      ...
    },
    {
      ...
      "WorkspaceId": "workspace3_id",
      ...
    }
  ]
}

Obtenha as métricas do CloudWatch para cada WorkSpace no diretório usando o comando get-metric-statistics.


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"
}

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Monitorar com o painel automático do CloudWatch

Monitorar usando o Amazon EventBridge

Monitorar WorkSpaces usando as métricas do CloudWatch

Pré-requisitos

Conteúdo

Métricas do WorkSpaces

nota

nota

Dimensões para métricas do WorkSpaces

nota

Exemplo de monitoramento

Como responder a um alarme do CloudWatch