Conceitos Essenciais

A arquitetura Always on Tracing (AOT) foi projetada para fornecer coleta contínua e em tempo real de logs em ambientes Citrix Virtual Apps and Desktops (CVAD) e DaaS. Ela permite que administradores de TI e o Suporte Citrix solucionem problemas de usuários 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 múltiplas camadas da infraestrutura Citrix em um repositório centralizado.

Principais Componentes 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ários.

2. Habilitar Coleta de Logs: 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 para o broker, que orquestra o processo de coleta de logs entre 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 Logs 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 Logs para o Servidor de Logs 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 logs 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 Logs 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.
• Nível: O nível de severidade do log (por exemplo, info, aviso, erro).
• Módulo: O módulo de software específico que gerou o log.
• Nome do Processo: O nome do processo que gerou o log.
• ID do Processo: O ID do processo.
• Thread: O ID da thread dentro do processo.
• CPU: Informações relacionadas ao ID da CPU no momento do log.
• ID da Sessão: O ID da sessão do usuário associada ao log.
• Classe: 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

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