Configurar Coleção de Comandos do SO

Pré-requisitos para Configurar a Coleta de Saída de Comando do SO

Conclua as seguintes tarefas de pré-requisito antes de configurar a coleta de logs:

• Criar um script personalizado que consiste em um comando do sistema operacional, cuja saída pode ser coletada no Oracle Log Analytics como logs. A saída do STDOUT e STDERR do script é enviada como payload pelo agente para a nuvem. O payload STDOUT e STDERR pode ser uma única entrada de log ou várias entradas de log. Certifique-se de que o parser usado na origem do Oracle Log Analytics possa fazer parsing dele. Além disso, o script deve ser capaz de tratar condições de erro e verificar se há pré-requisitos.

  Armazene seu script personalizado na pasta logan/scripts/os_cmd. Portanto, o caminho absoluto para armazenar o script é:

  • Para o Oracle Management Agent: /opt/oracle/mgmt_agent/usercontent/logan/scripts/os_cmd
  • Para o plug-in do Oracle Cloud Agent- Management Agent: /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/usercontent/logan/scripts/os_cmd

• Permissões especiais de arquivo podem precisar ser fornecidas para executar comandos específicos no script. Configure essas permissões no host de agente manualmente. O script e quaisquer outros comandos/scripts executados pelo script devem ter a permissão execute para o usuário do Management Agent.

Fluxo Geral para Coleta de Logs de Comando do SO

A seguir estão as tarefas de alto nível para coletar a saída de um script de comando do SO:

• Instale o Management Agent no host no qual você deseja executar OS scripts de comando do sistema operacional e gerar a saída que precisa ser coletada no Oracle Log Analytics. Consulte Configurar Coleta Contínua de Logs Usando o Management Agent.

• Crie uma entidade para identificar o host do agente no Oracle Log Analytics. A entidade deve estar no mesmo host que o Agente de Gerenciamento no qual o script será executado. A execução remota de comandos do SO não é suportada. Geralmente, a entidade é criada automaticamente quando você instala o Management Agent. Consulte Criar uma Entidade para Representar Seu Recurso de Emissão de Log.

• Crie um parser que possa fazer parsing da saída do script. Este parser deve ser usado na origem que será identificada na etapa a seguir. Consulte Criar um Parser.
• Identifique uma origem existente ou crie uma origem de log do tipo comando OS. Consulte Criar uma Origem de Comando do SO.
• Verifique se você deseja configurar a propriedade de coleta do agente customized_schedule para definir o intervalo de coleta da coleta de comandos do SO. O valor-padrão é 30 seconds. Você pode atualizar a programação no nível do agente, no nível de origem, no nível da entidade ou no nível de associação usando as propriedades de coleta do agente. Consulte Propriedades do Agente que Você Pode Modificar e Modificar Propriedades do Agente.

• Associe as entidades à origem que você criou anteriormente. Consulte Configurar Nova Associação entre Origem e Entidade.

  Após a conclusão da associação, o agente começa a executar o comando do SO periodicamente, o STDOUT e o STDERR do comando são coletados como dados de log e esses dados de log começam a fluir para o Oracle Log Analytics.

• Exiba dados de log no Log Explorer selecionando a origem do Comando do SO que você criou anteriormente. Consulte Filtrar Logs por Atributos de Origem.

Se os dados de log não aparecerem no Log Explorer após a conclusão da configuração, você poderá verificar se há avisos de coleta de agentes para quaisquer problemas. As seguintes advertências estão especificamente relacionadas à coleta de saída do Comando do SO:

• Falha de Execução de Aplicativo Externo: Ocorreu um erro durante a execução do script ou o comando do SO não é suportado.

• Aplicativo Externo Não Encontrado: Script não encontrado, Sem permissões de Leitura/Execução no script.

Consulte Exibir Advertências de Coleta do Agente.

Fatores Importantes a Considerar ao Configurar a Coleta de Comandos do SO

• Use o caminho completo dos comandos nos scripts; Por exemplo, use /bin/sudo em vez de sudo.

• Os scripts são executados como o mesmo usuário que o Management Agent está executando. Isso é importante ao ler ou gravar arquivos no script.

• A saída gerada pelo script em Saída Padrão (STDOUT) e Erro Padrão (STDERR) é coletada como texto para extrair as entradas de log.

• As seguintes palavras ou prefixos não são suportados no comando do SO ou no nome do script: sh, bash, csh, zsh, ksh, dash, cmd

• OS seguintes caracteres não são suportados no comando do SO ou no nome do script: |, &, ;, >, <

• As seguintes sequências de travessia do diretório pai não são suportadas no comando do SO ou no nome do script: /../ ou \..\. Além disso, o comando do SO não pode terminar com /.. ou \...

• A variável de ambiente a seguir é passada para os scripts do agente. Você pode usar a variável nos scripts.

  • LA_SOURCE_COMMAND_ID: Este é o id de padrão gerado internamente do comando na origem de log. Ele pode ser usado para diferenciar instâncias de script se o mesmo script for fornecido em vários comandos.