GE Auditor de Ambiente

Voltar

Utilidades/Diversos > Acesso rápido > Auditor de Ambiente

O Auditor de Ambiente oferece ao usuário uma ferramenta robusta para realizar auditorias de conformidade no ambiente. Ele verifica elementos essenciais ao correto funcionamento do sistema, como:

• Estrutura de objetos do banco de dados.
• Outros itens necessários para a operação do sistema.

Acesso ao Auditor de Ambientes: Para acessar o Auditor de Ambiente, utilize o recurso de Acesso Rápido por meio das seguintes opções:

• Atalho: F11.
• Ícone: Raio no menu principal.

auditor1

Etapas do processo

O processo do Auditor de Ambiente é dividido nas seguintes etapas:

1. O que deseja auditar?

2. Verificação

3. Preparado para iniciar

4. Executando

5. Resultados

Etapa “O que deseja auditar?”

Nesta etapa, o usuário define quais verificações deseja executar.

Opções disponíveis

• ❑ Selecionar verificações individualmente.

Permite personalizar a seleção das verificações desejadas, de acordo com áreas, módulos e tipos de objetos.

• ❑ Tabelas (existência, estrutura e índices):

Compara a estrutura das tabelas da versão em execução com a estrutura no banco de dados (BD) do ambiente selecionado. A análise considera os seguintes aspectos para as tabelas:

• Existência das tabelas.
• Estrutura das tabelas.
• Índices associados às tabelas.

• ❑ Índices (análise de fragmentação):

Realiza a análise da fragmentação dos índices das tabelas do banco de dados, identificando possíveis necessidades de manutenção.

• ❑ Compilação de objetos de banco de dados:

Realiza auditoria nos objetos do banco de dados, verificando:

• Se pertencem ao produto ou são customizados.
• A ausência de objetos essenciais.
• A necessidade de recompilar objetos descompilados.

• ❑ Arquivos da instalação:

Verifica os arquivos da instalação, comparando-os com os arquivos do pacote oficial da versão para identificar possíveis divergências.

Observação:

Ao selecionar a opção “Selecionar verificações individualmente”, caso alguma outra opção tenha sido marcada, será desmarcada automaticamente.

Etapa “Verificação”

Essa etapa é ativada apenas quando a opção “Selecionar verificações individualmente” está marcada.

• Selecione as verificações desejadas:

O sistema permite a seleção personalizada das verificações a serem realizadas. A seleção é organizada em dois níveis:

• Primeiro nível: Representa as áreas.
• Segundo nível: Corresponde aos módulos dentro dessas áreas.

• Tipos de objetos a serem verificados:

• Quando a seleção é feita na primeira tela do Auditor, todos os tipos de objetos são automaticamente incluídos na verificação.
• Caso a seleção ocorra na tela de seleção individual, o usuário pode escolher manualmente os tipos de objetos que deseja verificar.

Voltar ao início

Etapa “Preparado para iniciar”

Nesta etapa, o sistema aguarda a confirmação do usuário para prosseguir com a operação. Ao clicar no botão "Avançar", a execução da rotina será iniciada conforme as configurações selecionadas.

Etapa “Executando”

Nesta etapa, ocorre a execução da auditoria conforme a opção selecionada anteriormente. As verificações realizadas incluem:

• Tabelas da versão x Tabelas no BD:

Verifica se as tabelas definidas na versão estão presentes no banco de dados.

• Campos das tabelas x Campos no BD:

Compara os campos das tabelas da versão com os campos das tabelas no banco de dados, avaliando a conformidade.

• Índices das tabelas x Índices no BD:

Analisa os índices relacionados às tabelas, considerando:

• Quantidade total de índices;
• Nomes dos índices;
• Elementos que compõem cada índice.

• Índices customizados:

Identifica índices existentes no banco de dados que não fazem parte da estrutura oficial da tabela, ou seja, que foram criados como customizações.

• Fragmentação de índices:

O sistema avalia a taxa de fragmentação de cada índice das tabelas do produto.

Classificação da fragmentação:

• OK (Normal): 0% a 5%
• Atenção: acima de 5% até 30%
• Crítica: acima de 30% até 100%

• Objetos cadastrados via XML:

Compara os objetos definidos em arquivos XML com os existentes no ambiente atual, avaliando eventuais discrepâncias.

• Objetos descompilados:

Identifica e avalia objetos descompilados na versão, destacando aqueles que precisam de atenção para correção ou atualização.

• Arquivos da instalação:

Compara os arquivos presentes na instalação, com os arquivos oficiais do pacote da versão, avaliando eventuais divergências.

Voltar ao início

Etapa "Resultados"

Nessa tela, são exibidas as tabelas e objetos de banco de dados avaliados conforme a seleção realizada pelo usuário nas etapas anteriores do Auditor de Ambiente, apresentando as seguintes informações:

✔ Tabelas (existência, estrutura e índices)

Nesta seção, são apresentadas as tabelas avaliadas pelo Auditor de Ambiente.

Para cada tabela avaliada, são apresentadas as informações abaixo:

• Ordenação: Todas as colunas exibidas na tela de resultados podem ser utilizadas para ordenação dos registros apresentados.
• Tabela: Nome "Magic" da tabela (exemplo: Tipo Pagamento).
• Nome lógico: Nome lógico da tabela (exemplo: %GFTIPOPAGTO%).
• Nome BD: Nome físico da tabela no banco de dados (exemplo: GFTIPOPA).
• Situação: Status conforme a avaliação realizada pela rotina, com as seguintes possibilidades:
  • Ok: Tudo está em conformidade.
  • Aviso: Há divergências menores.
  • Erro: Divergências significativas encontradas.

Quando a situação for "Aviso" ou "Erro", o botão Detalhar ficará disponível para exibição das informações detalhadas sobre as inconformidades identificadas.

Detalhamento das tabelas

Ao acessar a tela de detalhes por meio do botão Detalhar de uma tabela que apresente inconformidade, será exibido, ao lado do nome da tabela, o total de registros existentes no banco de dados para a respectiva tabela.

Essa informação tem caráter informativo e auxilia na análise do impacto das correções a serem executadas.

Funcionalidades adicionais para tabelas

🔹 Botão "Exportar para CSV": Gera um arquivo delimitado com os dados na ordem apresentada na tela.

🔹 Botão "Corrigir erros":

Permite corrigir todas as inconformidades encontradas nas tabelas avaliadas pelo Auditor de Ambiente.

Ao ser acionado, executa automaticamente:

• A criação de tabelas inexistentes no ambiente;
• A criação de campos de tabelas não encontrados;
• A correção das inconformidades identificadas nos índices de tabelas.
• Disponível apenas para usuários do tipo Supervisor ou membros do grupo SUPERVISOR.
• A correção considera somente as tabelas pertencentes aos módulos selecionados nas etapas iniciais do Auditor.

Importante:

Recomenda-se que esta opção seja executada somente quando o usuário logado for o único usuário utilizando o CIGAM, a fim de evitar conflitos de acesso ao banco de dados.

🔹 Botão ▼:

• Botão "Campos e tabelas":

Permite criar automaticamente:

• Tabelas inexistentes no ambiente;
• Campos de tabelas não encontrados no banco de dados, conforme as inconformidades identificadas pelo Auditor de Ambiente.
• Disponível apenas para usuários do tipo Supervisor ou membros do grupo SUPERVISOR.
• A correção considera somente as tabelas pertencentes aos módulos selecionados nas etapas iniciais do Auditor.

• Botão "Ajustar índices":

Permite ajustar os índices que não estejam criados corretamente no banco de dados, de acordo com as inconformidades identificadas pelo Auditor.

• Disponível apenas para usuários do tipo Supervisor ou membros do grupo SUPERVISOR. e .
• Executa exclusivamente a correção de índices das tabelas avaliadas.

Importante:

Recomenda-se que esta opção seja executada somente quando o usuário logado for o único usuário utilizando o CIGAM, a fim de evitar conflitos de acesso ao banco de dados.

🔹 Botão "Gerar Script":

Gera um arquivo com extensão .txt contendo:

• Scripts para ajuste de índices;
• Scripts para criação das tabelas inexistentes;
• Scripts para criação dos campos de tabelas identificados como faltantes pelo Auditor de Ambiente.

Voltar ao início

✔ Índices (análise de fragmentação)

Esta seção apresenta o resultado da análise de fragmentação dos índices das tabelas do banco de dados, permitindo identificar possíveis pontos de degradação de performance.

A opção está disponível no combo de resultados ao final da execução do Auditor de Ambiente.

Importante

• A análise considera apenas tabelas com mais de 10.000 registros.
• Tabelas menores são desconsideradas automaticamente por apresentarem impacto irrelevante na maioria dos cenários.
• Tabelas que não pertencem ao produto terão o campo Nome Lógico preenchido com: “Customizado / Não Produto”

Observação sobre a análise de fragmentação
A verificação de fragmentação considera somente índices não únicos.

Isso ocorre porque índices únicos, em geral, não apresentam níveis relevantes de fragmentação, tendo baixo impacto na performance do banco de dados.

Dessa forma, a análise é direcionada aos índices que realmente podem impactar o desempenho, tornando o resultado mais objetivo e eficiente.

Importante:
Índices únicos não serão exibidos na listagem de fragmentação.

Colunas exibidas
Para cada tabela avaliada, são apresentadas as seguintes informações:

• Tabela: Nome da tabela no padrão do sistema
• Nome Lógico: Identificação lógica da tabela
• Nome BD: Nome físico da tabela no banco de dados
• Situação: Classificação da fragmentação dos índices da tabela

Ordenação dos resultados
A listagem é apresentada por padrão conforme a prioridade de criticidade:

1. Crítica
2. Atenção
3. Normal

Essa ordenação facilita a identificação rápida das tabelas que exigem ação imediata.

Voltar ao início

✔ Compilação de objetos de banco de dados

Nesta seção, são apresentados os objetos de banco de dados avaliados pelo Auditor de Ambiente quanto à sua existência e situação de compilação.

Para cada objeto analisado, são exibidas as seguintes informações:

• Nome do objeto: Nome do objeto (exemplo: CG_VW_COLABORADORES).
• Tipo de objeto:
  • Triggers (*.trg)
  • Types especifications (*.tps)
  • Functions (*.fnc)
  • Sequence scripts (*.sqc)
  • Types (*.typ)
  • Views (*.vew)
  • Packages (*.pck)
  • Procedures (*.prc)
• Situação: Status conforme avaliação realizada pela rotina, com as seguintes possibilidades:
  • Ok: Objeto em conformidade.
  • Não encontrado: Objeto ausente no banco de dados.
  • Descompilado: Objeto não sincronizado ou com erros de compilação.
  • Customizado / Não produto: Objeto alterado pelo cliente ou fora do padrão do produto.

Funcionalidades adicionais para tabelas

• Botão "Exportar para CSV": Gera um arquivo delimitado com os dados na ordem apresentada na tela.
• Botão "Compilar objetos": Permite compilar os objetos que não foram sincronizados corretamente durante o processo de atualização do ambiente.

✔ Arquivos da instalação

Nesta seção, são apresentados os arquivos da instalação avaliados pelo Auditor de Ambiente, considerando a existência e a conformidade dos arquivos em relação ao pacote da versão instalada.

Para cada arquivo analisado, são exibidas as seguintes informações:

• Arquivo: Nome do arquivo presente na instalação que está sendo auditada.
• Caminho: Local onde o arquivo se encontra.
• Situação: Status conforme avaliação realizada pela rotina, com as seguintes possibilidades:
  • Ok: O arquivo do pacote da versão está presente na instalação e em conformidade.
  • Aviso: O arquivo não foi encontrado na instalação. Situação exclusiva para arquivos localizados na pasta Scripts.
  • Divergência: O arquivo não foi encontrado na instalação ou está presente, porém difere do arquivo correspondente ao pacote da versão.

Quando a situação for "Aviso" ou "Divergência", o botão Detalhar exibirá informações detalhadas sobre a divergência.

⚠️ Nota:

Os arquivos verificados pelo Auditor de Ambiente são os que estão nas pastas listadas abaixo, juntamente com suas respectivas subpastas:

• %CIGAM_INSTAL% (pasta raiz da instalação)
• %CIGAM_INSTAL%Apoio\
• %CIGAM_INSTAL%Cab\
• %CIGAM_INSTAL%Scripts\

Voltar ao início

Quais as verificações de índices que são executadas?

A partir da e , a coluna "Situação" apresenta a opção "Detalhes". Ao clicar nela, uma janela é exibida contendo o resultado das verificações realizadas na tabela.

As verificações de índices incluem:

• Existência dos índices: Confirma se todos os índices especificados nas tabelas da versão estão devidamente criados no banco de dados.
• Conformidade dos índices: Verifica se os índices das tabelas possuem todos os elementos configurados corretamente, conforme definido nas tabelas da versão.

Caso alguma dessas condições não seja atendida, as seguintes situações podem ser apresentadas em "Situação - Detalhes":

• Índice não encontrado: Indica que o índice especificado não existe no banco de dados.
• Ordenação incorreta: Informa que o índice foi localizado, mas a ordenação dos elementos não está conforme o esperado, detalhando qual deveria ser a ordem correta.

Recomendações de uso

O Auditor de Ambiente pode ser executado a qualquer momento para fins de análise e verificação, não havendo restrições quanto à sua execução durante o uso do sistema.

Durante a execução, o Auditor realiza leituras e comparações da estrutura do ambiente, como tabelas, índices, objetos de banco de dados e arquivos da instalação, não impactando diretamente a utilização do sistema nesses casos.

Importante:
Ao realizar ações de correção, como:

• Ajuste de índices

é fortemente recomendado que não haja usuários utilizando o sistema, evitando conflitos de acesso ao banco de dados, bloqueios ou inconsistências durante o processo.

Essa recomendação é especialmente relevante para rotinas que envolvem alteração de índices, pois podem afetar diretamente a performance e o acesso às tabelas durante sua execução.