Depuração e monitoramento gerais - Estúdio de Pesquisa e Engenharia

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á.

Depuração e monitoramento gerais

Esta seção contém informações sobre onde as informações podem ser encontradas no RES.

Fontes úteis de informações sobre registros e eventos

Há várias fontes de informações retidas que podem ser referenciadas para fins de solução de problemas e monitoramento.

Onde encontrar variáveis de ambiente

Por padrão, você pode encontrar variáveis de ambiente, como o nome de usuário do proprietário da sessão, nos seguintes locais:

  • Linux: /etc/environment

  • Windows: C:\Users\Administrator\RES\Bootstrap\virtual-desktop-host-windows\environment_variables.json

Arquivos de log no ambiente ( EC2 instâncias da Amazon)

Existem arquivos de log nas EC2 instâncias da Amazon em uso pelo RES. O SSM Session Manager pode ser usado para abrir uma sessão na instância para examinar esses arquivos.

Em instâncias de infraestrutura, como o gerenciador de cluster e o controlador vdc, os registros de aplicativos e outros podem ser encontrados nos seguintes locais.

  • /opt/idea/app/logs/application.log

  • /root/bootstrap/logs/

  • /var/log/

  • /var/log/sssd/

  • /var/log/messages

  • /var/log/user-data.log

  • /var/log/cloud-init.log

  • /var/log/cloud-init-output.log

Em um desktop virtual Linux, o seguinte contém arquivos de log úteis

  • /var/log/dcv/

  • /root/bootstrap/logs/userdata.log

  • /var/log/messages

No Windows, os registros de instâncias de desktop virtual podem ser encontrados em

  • PS C:\ ProgramData\nice\ dcv\ log

  • PS C:\ ProgramData\nice\ DCVSessionManagerAgent\ log

No Windows, o registro de alguns aplicativos pode ser encontrado em:

  • PS C:\Program Files\ NICE\ DCV\ Servidor\ bin

No Windows, os arquivos de certificado NICE DCV podem ser encontrados em:

  • C:\Windows\System32\config\systemprofile\AppData\ Local\ NICE\ dcv\

Grupos de CloudWatch log da Amazon

A Amazon EC2 e os recursos AWS Lambda computacionais registram informações nos Amazon CloudWatch Log Groups. As entradas de registro dentro delas podem fornecer informações úteis para solucionar possíveis problemas ou para obter informações gerais.

Esses grupos são nomeados da seguinte forma:

  • /aws/lambda/<envname>-/ - lambda related

  • /<envname>/

    • cluster-manager/ - main infrastructure host

    • vdc/ - virtual desktop related

      • dcv-broker/ - desktop related

      • dcv-connection-gateway/ - desktop related

      • controller/ - main desktop controller host

      • dcv-session/ - desktop session related

Ao examinar grupos de registros, pode ser útil filtrar usando cadeias de caracteres maiúsculas e minúsculas, como as seguintes. Isso produzirá somente as mensagens que contêm as sequências de caracteres anotadas.

?"ERROR" ?"error"

Outro método de monitoramento de problemas é criar CloudWatch painéis da Amazon que contêm widgets que exibem os dados de interesse.

Um exemplo é criar um widget que conte a ocorrência das strings error e ERROR e represente-as graficamente como linhas. Esse método facilita a detecção da ocorrência de possíveis problemas ou tendências que indicam que ocorreu uma mudança no padrão.

Veja a seguir um exemplo disso para os hosts de infraestrutura. Para usar isso, concatene as linhas de consulta e substitua os <region> atributos <envname> e pelos valores apropriados.

{ "widgets": [ { "type": "log", "x": 0, "y": 0, "width": 24, "height": 6, "properties": { "query": "SOURCE '/<envname>/vdc/controller' | SOURCE '/<envname>/cluster-manager' | SOURCE '/<envname>/vdc/dcv-broker' | SOURCE '/<envname>/vdc/dcv-connection-gateway' | fields @timestamp, @message, @logStream, @log\n| filter @message like /(?i)(error|ERROR)/\n| sort @timestamp desc| stats count() by bin(30s)", "region": "<region>", "title": "infrastructure hosts", "view": "timeSeries", "stacked": false } } ] }

Um exemplo do Painel pode aparecer da seguinte forma:

exemplo de painel do cloudwatch mostrando erros

CloudFormation Pilhas

As CloudFormation pilhas criadas durante a criação do ambiente contêm recursos, eventos e informações de saída associadas à configuração do ambiente.

Para cada uma das pilhas, a guia Eventos, Recursos e Saídas pode ser consultada para obter informações sobre as pilhas.

Pilhas RES:

  • <envname>-bootstrap

  • <envname>-cluster

  • <envname>-métricas

  • <envname>- serviço de diretório

  • <envname>-provedor de identidade

  • <envname>-armazenamento compartilhado

  • <envname>-gerenciador de clusters

  • <envname>-vdc

  • <envname>-anfitrião-bastião

Demo Environment Stack (se você estiver implantando um ambiente de demonstração e não tiver esses recursos externos disponíveis, poderá usar receitas de computação de AWS alto desempenho para gerar recursos para um ambiente de demonstração.)

  • <envname>

  • <envname>-Rede

  • <envname>- DirectoryService

  • <envname>-Armazenamento

  • <envname>- WindowsManagementHost

Falhas do sistema devido a um problema e refletidas pela atividade de grupo do Amazon EC2 Auto Scaling

Se o RES UIs indicar erros no servidor, a causa pode ser um software aplicativo ou outro problema.

Cada um dos grupos de escalonamento automático de EC2 instâncias da Amazon (ASGs) de infraestrutura contém uma guia Atividade que pode ser útil para detectar a atividade de escalabilidade das instâncias. Se as páginas da interface do usuário apresentarem algum erro ou não estiverem acessíveis, verifique se há várias instâncias encerradas no EC2 console da Amazon e verifique a guia Auto Scaling Group Activity do ASG relacionado para determinar se as instâncias da EC2 Amazon estão circulando.

Nesse caso, use o grupo de CloudWatch log relacionado da Amazon para a instância para determinar se erros estão sendo registrados que possam indicar a causa do problema. Também pode ser possível usar o console SSM Session para abrir uma sessão em uma instância em execução desse tipo e examinar os arquivos de log na instância para determinar uma causa antes que a instância seja marcada como não íntegra e encerrada pelo ASG.

O console ASG pode mostrar uma atividade semelhante à seguinte se esse problema estiver ocorrendo.

exemplo de painel de balanceadores de carga ec2 mostrando detalhes sobre a integridade da instância e metas registradas

Aparência típica EC2 do console Amazon

Esta seção contém capturas de tela do sistema operando em vários estados.

Hosts de infraestrutura

O EC2 console da Amazon, quando nenhum desktop está em execução, geralmente é semelhante ao seguinte. As instâncias mostradas são a infraestrutura RES que a Amazon EC2 hospeda. O prefixo no nome de uma instância é o nome do ambiente RES.

painel mostrando instâncias ec2 para res-stage2 com estado em execução

Hosts de infraestrutura e desktops virtuais

No EC2 console da Amazon, quando os desktops virtuais estão em execução, eles parecem semelhantes aos seguintes. Nesse caso, os desktops virtuais são indicados em vermelho. O sufixo do nome da instância é o usuário que criou a área de trabalho. O nome no centro é o Nome da sessão definido no momento da inicialização e pode ser o padrão MyDesktop "" ou o nome definido pelo usuário.

EC2 dashboard showing 7 running instances, with two virtual desktops highlighted.

Hosts em um estado encerrado

Quando o EC2 console da Amazon mostra instâncias encerradas, elas geralmente são hosts de desktop que foram encerradas. Se o console incluir hosts de infraestrutura em estado encerrado, especialmente se houver vários do mesmo tipo, isso pode indicar um problema no sistema em andamento.

A imagem a seguir mostra instâncias de desktop que foram encerradas.

EC2 instances dashboard showing 10 instances, with 3 terminated and 7 running.

Comandos úteis relacionados ao Active Directory (AD) para referência

Veja a seguir exemplos de comandos relacionados ao ldap que podem ser inseridos em hosts de infraestrutura para visualizar informações relacionadas à configuração do AD. O domínio e outros parâmetros usados devem refletir aqueles inseridos no momento da criação do ambiente.

ldapsearch "(cn=AWS Delegated Add Workstations To Domain Users)" -x -h corp.res.com -b "DC=corp,DC=res,DC=com" -D "CN=Admin,OU=Users,OU=CORP,DC=corp,DC=res,DC=com" -w <password> ldapsearch "(&(objectClass=group))" -x -h corp.res.com -b "DC=corp,DC=res,DC=com" -D "CN=Admin,OU=Users,OU=CORP,DC=corp,DC=res,DC=com" -w <password>

Depuração DCV do Windows

Em uma área de trabalho do Windows, você pode listar a sessão associada a ela usando o seguinte:

PS C:\Windows\System32\config\systemprofile\AppData\Local\NICE\dcv> & 'C:\Program Files\NICE\DCV\Server\bin\dcv.exe'list-sessions Session: 'a7953489-9dbf-492b-8135-7709dccc4cab' (owner:admin2 type:console name:windows1)

Encontre informações sobre a versão do Amazon DCV

O Amazon DCV é utilizado para sessões de desktop virtual. AWS Amazon DCV. Os exemplos a seguir mostram como determinar a versão do software DCV instalado.

Linux

[root@ip-10-3-157-194 ~]# /usr/bin/dcv version Amazon DCV 2023.0 (r14852) Copyright (C) 2010-2023 NICE s.r.l. All rights reserved. This product is protected by copyright and licenses restricting use, copying, distribution, and decompilation.

Windows

PS C:\Windows\System32\config\systemprofile\AppData\Local\NICE\dcv> & 'C:\Program Files\NICE\DCV\Server\bin\dcv.exe' version Amazon DCV 2023.0 (r15065) Copyright (C) 2010-2023 NICE s.r.l. All rights reserved. This product is protected by copyright and licenses restricting use, copying, distribution, and decompilation.