Registro de configuração

Last published : Nov 13, 2026
O registro de configuração é um recurso que captura alterações de configuração do site e atividades administrativas para o banco de dados. O recurso é habilitado por padrão. Você pode usar o conteúdo registrado para:
  • Diagnosticar e solucionar problemas após a realização de alterações de configuração. O log fornece um rastro de auditoria.
  • Auxiliar no gerenciamento de mudanças e rastrear configurações.
  • Relatar a atividade de administração.
Você define as preferências de registro de configuração, exibe os logs de configuração e gera relatórios HTML e CSV a partir do Citrix Studio. Você pode filtrar as exibições de log de configuração por intervalos de datas e resultados de pesquisa de texto completo. O registro obrigatório, quando habilitado, impede que alterações de configuração sejam feitas, a menos que possam ser registradas. Com a permissão apropriada, você pode excluir entradas do log de configuração. Você não pode usar o recurso de registro de configuração para editar o conteúdo do log.
O registro de configuração usa um SDK do PowerShell e o Serviço de Registro de Configuração. O Serviço de Registro de Configuração é executado em cada Controller no site. Se um Controller falhar, o serviço em outro Controller lida automaticamente com as solicitações de registro.
Por padrão, o recurso de registro de configuração é habilitado e usa o banco de dados que é criado quando você cria o site (o banco de dados de configuração do site). Você pode especificar um local diferente para o banco de dados. O banco de dados de registro de configuração suporta os mesmos recursos de alta disponibilidade que o banco de dados de configuração do site.
O acesso ao registro de configuração é controlado por meio de administração delegada, com as permissões Editar Preferências de Registro e Visualizar Logs de Configuração.
Os logs de configuração são localizados quando são criados. Por exemplo, um log criado em inglês é lido em inglês, independentemente da localidade do leitor.
Related information
Monitor

O que é registrado

Alterações de configuração e atividades administrativas iniciadas a partir do Studio, Director e scripts do PowerShell são registradas. Exemplos de alterações de configuração registradas incluem trabalhar com (criar, editar, excluir, atribuir):
  • Catálogos de máquinas
  • Grupos de entrega (incluindo a alteração das configurações de gerenciamento de energia)
  • Funções e escopos de administrador
  • Recursos e conexões de host
  • Políticas Citrix através do Studio
Exemplos de alterações administrativas registradas incluem:
  • Gerenciamento de energia de uma máquina virtual ou de um desktop de usuário
  • Studio ou Director enviando uma mensagem a um usuário
As seguintes operações não são registradas:
  • Operações autônomas, como o gerenciamento de pool de inicialização de máquinas virtuais.
  • Ações de política implementadas por meio do Console de Gerenciamento de Política de Grupo (GPMC); use ferramentas da Microsoft para visualizar logs dessas ações.
  • Alterações feitas por meio do registro, acesso direto ao banco de dados ou de fontes diferentes de Studio, Director ou PowerShell.
  • Quando a implantação é inicializada, o registro de configuração fica disponível quando a primeira instância do Serviço de Registro de Configuração se registra no Serviço de Configuração. Portanto, os estágios iniciais da configuração não são registrados (por exemplo, quando o esquema do banco de dados é obtido e aplicado, quando um hipervisor é inicializado).

Gerenciar o registro de configuração

Por padrão, o registro de configuração usa o banco de dados que é criado quando você cria um site (também conhecido como banco de dados de configuração do site). A Citrix recomenda que você use um local separado para o banco de dados de registro de configuração (e o banco de dados de monitoramento) pelos seguintes motivos:
  • A estratégia de backup para o banco de dados de registro de configuração provavelmente difere da estratégia de backup para o banco de dados de configuração do site.
  • O volume de dados coletados para o registro de configuração (e o Serviço de Monitoramento) pode afetar adversamente o espaço disponível para o banco de dados de configuração do site.
  • Ele divide o ponto único de falha para os três bancos de dados.
As edições do produto que não suportam o registro de configuração não possuem um nó de Registro no Studio.

Habilitar e desabilitar o registro de configuração e o registro obrigatório

Por padrão, o registro de configuração está habilitado e o registro obrigatório está desabilitado.
  1. Selecione Registro no painel de navegação do Studio.
  2. Selecione Preferências no painel Ações. A caixa de diálogo de registro de configuração contém informações do banco de dados e indica se o registro de configuração e o registro obrigatório estão habilitados ou desabilitados.
  3. Selecione a ação desejada:
    Para habilitar o registro de configuração, selecione Habilitar. Esta é a configuração padrão. Se não for possível gravar no banco de dados, as informações de registro serão descartadas, mas a operação continuará.
    Para desabilitar o registro de configuração, selecione Desabilitar. Se o registro estava habilitado anteriormente, os logs existentes permanecem legíveis com o SDK do PowerShell.
    Para habilitar o registro obrigatório, selecione Impedir alterações na configuração do site quando o banco de dados não estiver disponível. Nenhuma alteração de configuração ou atividade administrativa que normalmente é registrada é permitida, a menos que possa ser gravada no banco de dados de registro de configuração. Você pode habilitar o registro obrigatório somente quando o registro de configuração estiver habilitado (quando Habilitar estiver selecionado). Se o Serviço de Registro de Configuração falhar e a alta disponibilidade não estiver em uso, o registro obrigatório será assumido. Nesses casos, as operações que normalmente seriam registradas não são executadas.
    Para desabilitar o registro obrigatório, selecione Permitir alterações na configuração do site quando o banco de dados não estiver disponível. As alterações de configuração e as atividades administrativas são permitidas, mesmo que o banco de dados de registro de configuração não possa ser acessado. Esta é a configuração padrão.

Alterar o local do banco de dados de registro de configuração

Não é possível alterar o local do banco de dados quando o registro obrigatório está habilitado, porque a alteração de local inclui um breve intervalo de desconexão que não pode ser registrado.
  1. Crie um servidor de banco de dados, usando uma versão compatível do SQL Server.
  2. Selecione Registro no painel de navegação do Studio.
  3. Selecione Preferências no painel Ações.
  4. Na caixa de diálogo Preferências de Registro, selecione Alterar banco de dados de registro.
  5. Na caixa de diálogo Alterar Banco de Dados de Registro, especifique o local do servidor que contém o novo servidor de banco de dados. Consulte Formatos de endereço de banco de dados para formatos válidos.
  6. Para permitir que o Studio crie a base de dados, clique em OK. Quando solicitado, clique em OK, e o banco de dados será criado automaticamente. O Studio tenta acessar a base de dados usando as credenciais do usuário atual do Studio. Se isso falhar, você será solicitado a fornecer as credenciais do usuário do banco de dados. O Studio então carrega o esquema da base de dados para ela. (As credenciais são retidas apenas durante a criação do banco de dados.)
  7. Para criar o banco de dados manualmente, clique em Gerar script de banco de dados. O script gerado inclui instruções para criar o banco de dados manualmente. Certifique-se de que o banco de dados esteja vazio e que pelo menos um usuário tenha permissão para acessar e alterar o banco de dados antes de carregar o esquema.
Os dados de log de configuração no banco de dados anterior não são importados para o novo banco de dados. Os logs não podem ser agregados de ambos os bancos de dados ao recuperar logs. A primeira entrada de log no novo banco de dados de log de configuração indica que uma alteração no banco de dados ocorreu, mas não identifica o banco de dados anterior.

Exibir conteúdo do log de configuração

Ao iniciar alterações de configuração e atividades administrativas, as operações de alto nível criadas pelo Studio e Director são listadas no painel superior central do Studio. Uma operação de alto nível resulta em uma ou mais chamadas de serviço e SDK, que são operações de baixo nível. Ao selecionar uma operação de alto nível no painel superior, o painel inferior exibe as operações de baixo nível.
Se uma operação falhar antes da conclusão, a operação de log pode não ser concluída no banco de dados. Por exemplo, um registro de início não terá um registro de parada correspondente. Nesses casos, o log indica que há informações ausentes. Ao exibir logs com base em intervalos de tempo, logs incompletos são mostrados se os dados nos logs corresponderem aos critérios. Por exemplo, se todos os logs dos últimos cinco dias forem solicitados e um log existir com um horário de início nos últimos cinco dias, mas não tiver um horário de término, ele será incluído.
Ao usar um script que chama cmdlets do PowerShell, se você criar uma operação de baixo nível sem especificar uma operação de alto nível pai, o log de configuração criará uma operação de alto nível substituta.
Para exibir o conteúdo do log de configuração, selecione Registro no painel de navegação do Studio. Por padrão, o painel central lista o conteúdo do log cronologicamente (entradas mais recentes primeiro), separado por data. Você pode:
  • Classificar a exibição pelo cabeçalho da coluna.
  • Filtrar a exibição especificando um intervalo de dias ou inserindo texto na caixa Pesquisar. Para retornar à exibição padrão após usar a pesquisa, limpe o texto na caixa Pesquisar.

Gerar relatórios

Você pode gerar relatórios CSV e HTML contendo dados de log de configuração.
  • O relatório CSV contém todos os dados de log de um intervalo de tempo especificado. Os dados hierárquicos no banco de dados são nivelados em uma única tabela CSV. Nenhum aspecto dos dados tem precedência no arquivo. Nenhuma formatação é usada e nenhuma legibilidade humana é assumida. O arquivo (nomeado MyReport) contém os dados em um formato universalmente consumível. Arquivos CSV são frequentemente usados para arquivar dados ou como fonte de dados para uma ferramenta de relatório ou manipulação de dados, como o Microsoft Excel.
  • O relatório HTML fornece uma forma legível por humanos dos dados de log para um intervalo de tempo especificado. Ele oferece uma visualização estruturada e navegável para revisar as alterações. Um relatório HTML é composto por dois arquivos, chamados Resumo e Detalhes. O Resumo lista as operações de alto nível: quando cada operação ocorreu, por quem e o resultado. Clicar em um link Detalhes ao lado de cada operação leva você às operações de baixo nível no arquivo Detalhes, que fornece informações adicionais.
Para gerar um relatório de log de configuração, selecione Registro no painel de navegação do Studio e, em seguida, selecione Criar relatório personalizado no painel Ações.
  • Selecione o intervalo de datas para o relatório.
  • Selecione o formato do relatório: CSV, HTML ou ambos.
  • Navegue até o local onde deseja salvar o relatório.

Excluir conteúdo do log de configuração

Para excluir o log de configuração, você deve ter certas permissões de administração delegada e de banco de dados do SQL Server.
  • Administração delegada: Você deve ter uma função de administração delegada que permita a leitura da configuração da implantação. A função de administrador completo tem essa permissão. Uma função personalizada deve ter Somente leitura ou Gerenciar selecionado na categoria Outras permissões.
    Para criar um backup dos dados de log de configuração antes de excluí-los, a função personalizada também deve ter Somente leitura ou Gerenciar selecionado na categoria Permissões de log.
  • Banco de dados SQL Server: Você deve ter um login de servidor SQL com permissão para excluir registros do banco de dados. Existem duas maneiras de fazer isso:
    • Use um login de banco de dados do SQL Server com uma função de servidor sysadmin, que permite realizar qualquer atividade no servidor de banco de dados. Alternativamente, as funções de servidor serveradmin ou setupadmin permitem realizar operações de exclusão.
    • Se sua implantação exigir mais segurança, use um login de banco de dados não-sysadmin mapeado para um usuário de banco de dados que tenha permissão para excluir registros do banco de dados.
      1. No SQL Server Management Studio, crie um login do SQL Server com uma função de servidor diferente de 'sysadmin'.
      2. Mapeie o login para um usuário no banco de dados. O SQL Server cria automaticamente um usuário no banco de dados com o mesmo nome do login.
      3. Na associação de função de banco de dados, especifique pelo menos um dos membros da função para o usuário do banco de dados: ConfigurationLoggingSchema_ROLE ou dbowner.
      Para obter mais informações, consulte a documentação do SQL Server Management Studio.
Para excluir os logs de configuração:
  1. Selecione Registro no painel de navegação do Studio.
  2. Selecione Excluir logs no painel Ações.
  3. Será perguntado se você deseja criar um backup dos logs antes que sejam excluídos. Se você optar por criar um backup, navegue até o local onde o arquivo de backup será salvo. O backup é criado como um arquivo CSV.
Depois que os logs de configuração são limpos, a exclusão do log é a primeira atividade registrada no log vazio. Essa entrada fornece detalhes sobre quem excluiu os logs e quando.