Opções de Configuração Avançada do Management Agent

Você pode usar a console para definir as propriedades do agente para a coleta de logs do Log Analytics em vários níveis de hierarquia, sendo o nível de tenant o mais alto.

Você pode especificar manualmente as propriedades dos arquivos de log editando as propriedades de configuração na pasta de instalação do agente.

Você pode executar essa tarefa para todos os logs, exceto os eventos do Windows.

1. Se você quiser aplicar as propriedades em padrões específicos e/ou origens de log, anote o ID do padrão e o ID da origem. Abra o arquivo xml de configuração na pasta de instalação do agente agent_inst/state/laStorage/os_file/os_file.xml.

   • Exemplo de ID de Padrão: <Pattern id="495071102827757094" name="/tmp/w*.mgr" include="true">
   • Exemplo de ID de Origem: <LogSource id="-2574377491167724513" name="SS Concurrent Manager Logs" sourceType="os_file"/>

   O local da pasta de instalação do agente varia dependendo do tipo de origem. Por exemplo, o local é agent_inst/state/laStorage/database_sql/database_sql.xml para o Banco de Dados SQL.

2. Edite o arquivo de propriedades emd.properties no local agent_inst/config/emd.properties e adicione a seguinte propriedade para substituir a configuração padrão do Oracle Log Analytics:

   loganalytics.src.override_config=true
       

3. Especifique o fuso horário tz e as propriedades de codificação de caracteres enc no arquivo emd.properties selecionando um dos seguintes exemplos:

   • Aplique as propriedades para todas as origens e padrões:

     loganalytics.src.addl_src_ptn_configs=tz=UTC,enc=EUC-JP

   • Aplique as propriedades somente para origens de log específicas:

     loganalytics.src.addl_src_ptn_configs=srcid=-2574377491167724513,tz=UTC,enc=EUC-JP;srcid=-2574377491167724512,enc=UTF-8

     Neste exemplo, as propriedades UTC de fuso horário e EUC-JP de codificação de caracteres são aplicadas para o -2574377491167724513 de origem e a propriedade UTF-8 de codificação de caracteres é aplicada para o -2574377491167724512 de origem.

   • Aplique as propriedades somente para padrões específicos:

     loganalytics.src.addl_src_ptn_configs=ptnid=495071102827757094,tz=UTC,enc=EUC-JP;ptnid=495071102827757095,enc=UTF-8

     Neste exemplo, as propriedades UTC de fuso horário e EUC-JP de codificação de caracteres são aplicadas ao padrão 495071102827757094 e a propriedade UTF-8 de codificação de caracteres é aplicada ao padrão 495071102827757095.

   • Aplique as propriedades somente para uma combinação de padrões e origens específicos:

     loganalytics.src.addl_src_ptn_configs=srcid=-2574377491167724513,ptnid=495071102827757094,tz=UTC,enc=EUC-JP;srcid=-2574377491167724513,ptnid=495071102827757095,enc=UTF-8

     Neste exemplo, as propriedades UTC de fuso horário e EUC-JP de codificação de caracteres são aplicadas para logs com o padrão 495071102827757094 e o -2574377491167724513 de origem, e a propriedade UTF-8 de codificação de caracteres é aplicada para logs com o padrão 495071102827757095 e o -2574377491167724513 de origem.

Você pode personalizar a programação de coleta de SQL para cada uma das origens de log do banco de dados especificando a periodicidade em um arquivo CSV no formato especificado abaixo.

1. Navegue até o diretório de instalação do Agente de Gerenciamento ou do Oracle Cloud Agent no host do banco de dados, por exemplo, agent_inst. Crie um diretório laconfig no diretório de instalação do agente.

2. No diretório laconfig, crie um arquivo CSV logan_schedule_database_sql_*.csv. Este é o arquivo de configuração de agendamento.

3. No arquivo de configuração da programação, forneça os detalhes da programação de origem no seguinte formato:

   NAME,RECURRENCE_PATTERN_UNIT,RECURRENCE_PATTERN_VALUE,START_HOUR
   <Source-Name>,DAY,1,1

   A linha do cabeçalho deve ter o conteúdo prescrito: NAME,RECURRENCE_PATTERN_UNIT,RECURRENCE_PATTERN_VALUE,START_HOUR

   Nas linhas subsequentes, especifique o cronograma para cada origem, um por linha.

   Os parâmetros da linha de cabeçalho e seus valores:

   Parâmetro da Linha do Cabeçalho	Descrição	Valores Permitidos
   NAME	O nome da origem de log do banco de dados definida no Oracle Log Analytics.	Qualquer
   RECURRENCE_PATTERN_UNIT	Esta é a unidade de cadência da coleta de SQL, por exemplo, minutos ou dias. WEEK e MONTH podem ter vários valores separados por :	Mínimo: minutos HOUR: horas DIA: dias WEEK: semanas MÊS: meses
   RECURRENCE_PATTERN_VALUE	O valor da unidade de padrão selecionada.	MIN: intervalo de 5 MIN, 15 MIN HOUR: intervalo 1 hora DAY: execução diária em 1 ou 12 WEEK: SUN, MON, TUE, WED, THU, FRI, SAT MÊS: data 1-31, ÚLTIMO dia do mês
   START_HOUR	A hora inicial da coleta de SQL, por exemplo, 0100 horas ou 1200 horas. Se esse valor não for especificado, a coleta de SQL começará imediatamente após a associação origem-entidade. Observe que, mesmo que o valor não seja especificado, a vírgula anterior deve estar presente na linha para que a programação seja válida.	1 ou 12.

4. Depois de salvar o arquivo CSV, reinicie o agente.

Alguns dos valores de exemplo para a configuração da programação:

Pastas contendo mais de 10.000 arquivos podem causar alto uso de recursos (memória/armazenamento/CPU) pelo Agente de Gerenciamento, o que pode levar à coleta lenta de logs, afetar outras funcionalidades do Agente de Gerenciamento e também pode tornar a máquina host mais lenta.

Quando pastas grandes são encontradas pelo plug-in Log Analytics do Management Agent, uma mensagem semelhante ao seguinte exemplo de mensagem é adicionada ao arquivo mgmt_agent_logan.log do Management Agent:

2020-07-30 14:46:51,653 [LOG.Executor.2388 (LA_TASK_os_file)-61850] INFO - ignore large dir /u01/service/database/logs. set property loganalytics.enable_large_dir to enable.

No entanto, se quiser continuar monitorando logs em pastas grandes, você poderá ativar o suporte fazendo as alterações a seguir.

Você pode editar manualmente a propriedade de configuração loganalytics.enable_large_dir para true na pasta de instalação do agente para ativar a coleta de logs de pastas com mais de 10000 arquivos. Por padrão, o valor da propriedade é false.

Edite o arquivo de propriedades emd.properties no local agent_inst/config/emd.properties e adicione o valor de propriedade acima para substituir a configuração padrão do Oracle Log Analytics:

sudo -u mgmt_agent echo "loganalytics.enable_large_dir=true" >> INSTALL_DIRECTORY/agent_inst/config/emd.properties

Substitua INSTALL_DIRECTORY pelo caminho para a pasta agent_inst. Reinicie o agente de gerenciamento após a edição do arquivo emd.properties.

Talvez você precise fazer algumas alterações de configuração no agente do host para ativar esse suporte. Experimente as novas configurações em um ambiente de desenvolvimento ou teste antes de colocá-las em produção. Determine o aumento para os seguintes fatores usando um ambiente representativo para testá-los. O aumento necessário real dependerá de fatores como o número de arquivos, a taxa de criação de arquivos e os outros tipos de coleta que o Agente de Gerenciamento está fazendo.

• Aumentar o tamanho do heap do Agente de Gerenciamento. Para diretórios com um grande número de arquivos, o tamanho do heap necessário aumenta com o número de arquivos. Consulte a documentação do Serviço Management Agent.
• Certifique-se de que haja espaço em disco e inodes suficientes disponíveis para tratar o grande número de arquivos de estado que o Agente de Gerenciamento pode ter que manter. Isso depende do tipo de origem de log e do parser usado. Se o seu parser usar a função Cabeçalho-Detalhe, o agente criará e armazenará o cabeçalho em um arquivo de cache, desde que o arquivo de log original exista.
• Certifique-se de que a definição do sistema operacional para o número de arquivos abertos possa suportar o Agente de Gerenciamento lendo a pasta grande e o número potencialmente grande de arquivos de estado.

Use a macro ignore-case (?i) no padrão de caminho do arquivo de log para interpretá-la no formato sem distinção entre maiúsculas e minúsculas. Isso se aplica ao padrão de caminho do arquivo de log fornecido nas origens de log do tipo Arquivo.

A macro (?i) será aplicada somente quando estiver no início do elemento do caminho.

Considere o exemplo:

/tmp/(?i)FOO/*.log

No exemplo acima, o elemento do caminho que segue a macro é FOO. Isto é interpretado na forma sem distinção entre maiúsculas e minúsculas.