Você pode usar a console para definir as propriedades do agente para a coleta de logs do Logging Analytics em vários níveis de hierarquia, sendo o nível do 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 Logging 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, o fuso horário UTC e as propriedades de codificação de caracteres EUC-JP são aplicadas para a origem -2574377491167724513 e a propriedade de codificação de caracteres UTF-8 é aplicada para a origem -2574377491167724512.

   • 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, o fuso horário UTC e as propriedades de codificação de caracteres EUC-JP são aplicadas para o padrão 495071102827757094 e a propriedade de codificação de caracteres UTF-8 é aplicada para o 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 de fuso horário UTC e codificação de caracteres EUC-JP são aplicadas para logs com o padrão 495071102827757094 e a origem -2574377491167724513, e a propriedade de codificação de caracteres UTF-8 é aplicada para logs com o padrão 495071102827757095 e a origem -2574377491167724513.

Você pode personalizar a programação de coleta 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 Management Agent 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 programação.

3. No arquivo de configuração de 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 a programação de cada origem, uma por linha.

   Os parâmetros de linha do 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 Logging Analytics.	Qualquer um
   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 :	MIN: minutos HOUR: horas DAY: dias WEEK: semanas MÊS: meses
   RECURRENCE_PATTERN_VALUE	O valor da unidade de padrão selecionada.	MIN: intervalo 5 MIN, 15 MIN HOUR: intervalo de 1 hora DAY: execução diária em 1 ou 12 WEEK: SUN, MON, TUE, WED, THU, FRI, SAT MÊS: data de 1 a 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 da entidade de origem. 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 do agendamento:

As pastas que contêm mais de 10.000 arquivos podem causar alto uso de recursos (memória/armazenamento/CPU) pelo Agente de Gerenciamento, o que pode levar a uma coleta lenta de logs, afetar outras funcionalidades do Agente de Gerenciamento e também diminuir a velocidade da máquina host.

Quando pastas grandes são encontradas pelo plug-in do Management Agent Logging Analytics, uma mensagem semelhante à seguinte mensagem de exemplo é 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 Logging 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 editar o arquivo emd.properties.

Talvez você precise fazer algumas alterações de configuração no seu agente host para ativar esse suporte. Experimente as novas configurações em um ambiente de desenvolvimento ou teste antes de criá-las em produção. Determine o aumento dos 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.

• Aumente o tamanho do heap do Management Agent. 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 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 analisador usar a função Header-Detail, 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 é aplicável 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. Isso é interpretado na forma sem distinção entre maiúsculas e minúsculas.