Citrix Virtual Apps and Desktops

Visão Geral da Arquitetura

Diagrama da Arquitetura

A arquitetura Always On Tracing (AOT) foi projetada para fornecer coleta contínua e em tempo real de rastreamentos em todo o ambiente Citrix Virtual Apps and Desktops™ (CVAD). Ela permite que administradores de TI e o Suporte Citrix solucionem problemas de usuários e de infraestrutura sem a necessidade de iniciar rastreamentos manualmente ou reproduzir o problema.

O sistema AOT é construído sobre vários componentes integrados que trabalham em sequência para capturar, transferir e armazenar logs de telemetria de múltiplas camadas da infraestrutura Citrix em um repositório centralizado.

Componentes Principais e Fluxo de Trabalho

  1. Geradores de Log AOT (Componentes Principais do Citrix): Componentes Citrix, como o Virtual Delivery Agent (VDA), Delivery Controller™ (DDC), StoreFront e outros, atuam como geradores de log. Esses componentes são equipados com o Telemetry Service, que usa a API AOT para capturar dados de rastreamento, registrar rastreamentos de etapas predefinidas e registrar eventos de erro relevantes para sessões e transações de usuários.

  2. Habilitar Coleta de Logs: Quando um administrador inicia uma solicitação para coletar logs (geralmente por meio de um comando PowerShell), as instruções são enviadas ao broker, que orquestra o processo de coleta de logs em todos os componentes relevantes, incluindo o broker e o VDA; o administrador inicia a solicitação para coletar logs (por meio de um comando PowerShell) do StoreFront™ Server separadamente.

  3. Telemetry Service: Após configurar o endereço e a porta do Log Server no StoreFront e no DDC, o Telemetry Service ativa o novo listener AOT em tempo real, que coleta logs com base em eventos, falhas ou pontos de gatilho predefinidos.

  4. Transferência de Logs para o Servidor de Log Centralizado: Uma vez que os logs são coletados, o Telemetry Service os transfere de forma segura diretamente para um servidor de log centralizado. Em ambientes onde os endpoints estão conectados a partir de redes externas através de um Citrix Gateway, a transferência geralmente ocorre por meio de um túnel SOCKS para garantir uma transferência segura e contínua.

  5. Armazenamento e Organização de Logs: O Servidor de Log Centralizado recebe, analisa e armazena os logs AOT em um formato estruturado e pesquisável usando um backend de banco de dados indexado (OpenSearch por padrão). Os logs são marcados por sessão, componente e carimbo de data/hora, permitindo fácil acesso e solução de problemas eficiente.

Os logs no sistema Citrix AOT são armazenados em um formato estruturado e pesquisável, marcados com vários campos para permitir fácil acesso e solução de problemas eficiente. Essas tags incluem:

  • MachineName: O nome da máquina onde o log se originou.
  • MachineIP: O endereço IP da máquina.
  • Role: A função do componente Citrix (por exemplo, VDA, DDC, StoreFront).
  • TimeStamp: O carimbo de data/hora UTC quando o evento de log ocorreu.
  • Message: O conteúdo real da mensagem de log. Pode ser pesquisado/filtrado por palavras.
  • Level: O nível de severidade do log (por exemplo, info, warning, error).
  • Module: O módulo de software específico que gerou o log.
  • ProcessName: O nome do processo que gerou o log.
  • ProcessId: O ID do processo.
  • Thread: O ID do thread dentro do processo.
  • Cpu: Informações relacionadas ao ID da CPU no momento do log.
  • SessionId: O ID da sessão do usuário associada ao log.
  • Class: A classe ou componente dentro do módulo.

Essas tags detalhadas permitem que os administradores filtrem, pesquisem e analisem logs rapidamente com base em critérios específicos, facilitando a identificação e a resolução de problemas.

Em resumo, o fluxo de trabalho AOT começa com os componentes Citrix gerando logs de diagnóstico. Uma solicitação centralizada é iniciada para coletar esses logs, que o Telemetry Service reúne dos componentes relevantes. Os logs coletados são então transferidos de forma segura para um servidor de log centralizado para indexação, armazenamento e posterior análise.

Como o AOT Funciona

O Citrix Always On Tracing (AOT) captura continuamente dados de diagnóstico de componentes-chave em seu ambiente. Quando acionados, os logs são coletados automaticamente, transferidos de forma segura para um servidor de log centralizado e retidos para análise. Isso elimina a necessidade de rastreamento manual e simplifica a solução de problemas.

Gatilhos de Rastreamento e Coleta de Logs: Componentes Citrix, como VDA, DDC, StoreFront e outros, são equipados com a API AOT para rastrear etapas e erros críticos. Esses componentes servem como geradores de log AOT. Quando um administrador inicia uma solicitação de coleta de logs do Delivery Controller:

O DDC envia a instrução para os componentes Citrix relevantes. Cada componente encaminha a solicitação para seu Telemetry Service local.

O Telemetry Service inicia o programa de escuta AOT em tempo real para coletar logs AOT e os encaminha para o Servidor de Log Centralizado.

Armazenamento e Retenção de Logs: Uma vez que os logs AOT são recebidos, o Servidor de Log Centralizado os formata e indexa em um banco de dados estruturado e pesquisável. Os logs são retidos com base em uma política de retenção definida para otimizar o uso do armazenamento. Por padrão, os logs AOT são retidos por 7 dias, após os quais são automaticamente limpos para economizar espaço.

AOT vs. Log Tradicional

Aspecto AOT Rastreamento CDF Tradicional
Ativação Automática, contínua Manual, requer reprodução do problema
Complexidade Logs legíveis, fáceis de usar Análise em nível de engenharia
Velocidade de Diagnóstico Logs imediatos disponíveis Atrasada pelo esforço de reprodução
Uso de Recursos Baixa sobrecarga com buffers otimizados Moderado a alto se usado incorretamente

As ferramentas de rastreamento tradicionais exigem esforço manual e só funcionam se você identificar o problema enquanto ele está ocorrendo. Com o Always On Tracing (AOT), o registro de logs é executado continuamente em segundo plano, de modo que os problemas são capturados assim que acontecem — mesmo que você não esteja monitorando. Isso economiza tempo e facilita muito a solução de problemas.

Destaques do AOT

  • Sempre Ativo: O rastreamento é executado o tempo todo, sem necessidade de ativá-lo manualmente.
  • Captura Automática: Os logs são sempre coletados quando ocorrem problemas.
  • Servidor de Log Central: Todos os logs são armazenados em um só lugar para fácil acesso.
  • Solução de Problemas Mais Fácil: Ajuda a identificar rapidamente falhas comuns.
  • Sem Necessidade de Reprodução: Não é preciso recriar o problema, ele já foi capturado.
Visão Geral da Arquitetura