Citrix Virtual Apps and Desktops

Conceitos Essenciais

Diagrama de Arquitetura

A arquitetura do Rastreamento Sempre Ativo (AOT) é projetada para fornecer coleta contínua e em tempo real de logs em todos os ambientes Citrix Virtual Apps and Desktops (CVAD) e DaaS. Ela permite que administradores de TI e o Suporte Citrix solucionem problemas de usuário e infraestrutura sem a necessidade de iniciar logs 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 várias camadas da infraestrutura Citrix em um repositório centralizado.

Componentes Chave e Fluxo de Trabalho

  1. Geradores de Log AOT (Componentes Principais da 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 Serviço de Telemetria ou um serviço similar, que usa a API AOT para capturar dados de rastreamento, registrar rastreamentos de etapas predefinidos e registrar eventos de erro relevantes para sessões e transações de usuário.

  2. Habilitar Coleta de Log: Quando um administrador inicia uma solicitação para coletar logs (geralmente através das configurações do web studio, as instruções são salvas no banco de dados do site e enviadas ao broker, que orquestra o processo de coleta de logs em todos os componentes relevantes, incluindo broker, storefront e VDA. O administrador inicia a solicitação para coletar logs através de um comando PowerShell de outros componentes separadamente, como Session Recording, PVS, FAS etc…

  3. Serviço de Telemetria: Após configurar o endereço do Servidor de Log no Citrix Web Studio, e quando as configurações são propagadas, o Serviço de Telemetria em cada componente ativa então o novo ouvinte AOT em tempo real, que coleta logs com base em eventos predefinidos, falhas ou pontos de gatilho.

  4. Transferência de Log para Servidor de Log Centralizado: Uma vez que os logs são coletados, o Serviço de Telemetria ou um serviço independente 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 através de um túnel SOCKS para garantir uma transferência segura e sem interrupções.

  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.
  • Mensagem: O conteúdo real da mensagem de log. Pode ser pesquisado/filtrado por palavras.
  • Nível: O nível de severidade do log (por exemplo, info, warning, error).
  • Módulo: 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 da 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. Uma solicitação centralizada é iniciada para coletar esses logs, que o Serviço de Telemetria reúne dos componentes relevantes. Os logs coletados são então transferidos com segurança para um servidor de log centralizado para indexação, armazenamento e análise posterior.

Como o AOT Funciona

O Citrix Always on Tracing (AOT) captura continuamente dados de log de componentes-chave em seu ambiente. Quando acionados, os logs são coletados automaticamente, transferidos com segurança 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 componentes são equipados com a API AOT para rastrear etapas críticas e erros. Esses componentes servem como geradores de log AOT. Quando um administrador inicia uma solicitação de coleta de log do Delivery Controller:

  • O DDC envia instruções aos componentes Citrix relevantes. Cada componente encaminha a solicitação para seu Serviço de Telemetria local.
  • O Serviço de Telemetria inicia o programa de escuta AOT em tempo real para coletar logs AOT e encaminha os logs 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. Registro Tradicional

Aspecto AOT Rastreamento CDF Tradicional
Ativação Automático, contínuo Manual, reprodução do problema necessária
Complexidade Logs amigáveis ao usuário, legíveis Análise em nível de engenharia
Velocidade de Diagnóstico Logs imediatos disponíveis Atrasado pelo esforço de reprodução
Uso de Recursos Baixa sobrecarga com buffers otimizados Moderado a alto se usado incorretamente

Ferramentas de rastreamento tradicionais exigem esforço manual e só funcionam se você identificar o problema enquanto ele está acontecendo. Com o AOT, o registro é executado continuamente em segundo plano, então os problemas são capturados assim que ocorrem — mesmo que você não esteja observando. Isso economiza tempo e torna a solução de problemas muito mais fácil.

Destaques do AOT

  • Sempre Ativo: O rastreamento é executado o tempo todo, sem necessidade de ativá-lo manualmente.
  • Captura Automática: Os logs são coletados sempre que 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á está capturado.
Conceitos Essenciais