Documentação do Oracle Cloud Infrastructure

Criando um Log

Crie um log que contenha informações críticas de diagnóstico que informem como os serviços do OCI (Oracle Cloud Infrastructure) estão sendo executados e acessados.

Grupos de logs são contêineres lógicos para organizar logs. Os logs sempre devem estar dentro dos grupos de logs. Você deve criar um grupo de logs antes de criar um log.

Para obter mais informações sobre logs e permissões necessárias para trabalhar com eles, consulte Gerenciamento do Grupo de Logs.

    1. Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em Log, selecione Logs.
    2. Selecione um compartimento que você tenha permissão para trabalhar.
    3. Selecione Criar log personalizado.
    4. Na página Criar log personalizado, informe um nome para o log personalizado. Evite digitar informações confidenciais.
    5. Selecione o compartimento no qual deseja criar o log-in.
    6. Em Grupo de logs, selecione um grupo de logs existente para colocar o log personalizado ou crie um.
    7. (Opcional) Na seção Tags, adicione uma ou mais tags ao log.

      Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deve ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recurso. Se você não tiver certeza se deseja aplicar tags, ignore essa opção ou pergunte a um administrador. Você pode aplicar as tags posteriormente.

    8. Selecione Mostrar opções adicionais e, em seguida, selecione quanto tempo manter o log, em incrementos de 30 dias, até um máximo de 180 dias:
      Observação

      Se você alterar o período de retenção de seis meses para um mês, todos os logs com mais de um mês não ficarão mais acessíveis. Por exemplo, se a alteração de um mês para seis meses, os logs não estarão disponíveis após um mês, e os logs de seis meses não estarão disponíveis.

      Além disso, a hora e a data futuras em que um log não ficará mais disponível se baseiam na hora e data exatas em que você criou o log. Por exemplo, se você criou um log em 21 de julho às 15:05 UTC com um período de retenção de três meses, em 19 de outubro às 15:05, o log não poderá mais ser pesquisado.

    9. Selecione Próximo.
    10. Na página Criar configuração do agente, crie uma nova configuração para definir os parâmetros dos dados do log associados (o padrão) ou adicione-os mais tarde. A configuração do agente define a quais instâncias a configuração se aplica (Grupos de hosts), quais arquivos de log são obtidos e qual parser (se houver) é usado (Configurar entradas de log).
      • Se você selecionar Adicionar nova configuração, vá para a próxima etapa.
      • Se você selecionar Adicionar configuração mais tarde, passe para a última etapa desta tarefa.
    11. Informe um nome e uma descrição para a configuração. Evite digitar informações confidenciais.
    12. Selecione o compartimento no qual você deseja criar a configuração.
    13. Em Grupos de Hosts, onde você define quais VMs se aplicam a essa configuração, selecione uma das seguintes opções na lista Tipo de grupo:
      • Dynamic group: Dynamic Group refere-se a um grupo de instâncias que você pode criar no recurso IAM da Console. Para obter mais informações, consulte Sobre Grupos Dinâmicos. Selecione um grupo dinâmico na lista Grupo.
      • Grupo de usuários: Grupo de usuários refere-se ao recurso Grupos do IAM da Console. Para obter mais informações, consulte Gerenciando Grupos. Selecione um grupo de usuários na lista Grupo.
    14. Para adicionar mais grupos, selecione Adicionar grupo de hosts.

      Você pode adicionar uma combinação de tipos de grupo para a configuração do agente.

      Observação

      É permitido um máximo de cinco grupos por configuração, e um host pode estar em, no máximo, cinco grupos distintos.
    15. Em Configuração do agente, defina o formato dos logs (quais logs você deseja observar) em Configurar entradas de log. Selecione uma das opções na lista Tipo de entrada e informe os valores relevantes:
      • Para log de eventos do Windows, informe um nome de entrada e selecione um ou mais canais de eventos.
      • Para Caminho de log, informe um nome de entrada e um ou mais caminhos de arquivo. Por exemplo, /<log_path>/<log_name>.

      Você pode especificar vários caminhos de arquivo de log, separados por uma vírgula (,). Para obter mais informações, consulte https://docs.fluentd.org/input/tail#path.

      <source>
@type tail
tag 757261.oc_oslogs_linux
path /var/log/.log,/var/log/.out,/var/log/dmesg,var/log/grubby,/var/log/messages*,
 var/log/secure,/var/log/auth,/var/log/acpid,/root/.bash_history
pos_file /etc/unifiedmonitoringagent/pos/757261-oc_oslogs_linux.pos
path_key tailed_path
</source>
      Exemplo de configuração:
      {{path C:\Program Files (x86)\<application>\<directory>*, 
 C:\Program Files (x86)\<application>\<application_logs_directory>\<directory>* }}

      Selecione Adicionar entrada de log para adicionar mais entradas de log personalizadas.

    16. Selecione Mostrar opções avançadas de parser e, em seguida, selecione um parser para especificar como fazer parsing do log. Alguns parsers exigem mais entrada e têm mais opções, dependendo do tipo escolhido.

      Por exemplo, para JSON, você deve selecionar um valor do tipo de tempo na lista, enquanto, opcionalmente, você pode especificar configurações de campo nulo e hora do evento. Para REGEXP, você pode especificar a expressão regular para logs correspondentes, juntamente com o formato de hora. Para obter mais informações, consulte Entradas e Parsers de Log.

      Importante

      O tipo de parser NONE é obrigatório, mesmo que você não queira especificar um tipo de parser específico.
    17. Selecione Criar.

      O objeto de log personalizado é criado, junto com sua configuração de agente associada (se especificada), que extrai dados das instâncias e os envia para o objeto de log personalizado.

  • Use o comando oci logging log create e os parâmetros necessários para criar um log em um grupo de logs:

    oci logging log create --display-name display_name --log-group-id log_group_ocid --log-type log_type [OPTIONS]

    Para obter uma lista completa de parâmetros e opções de variável para comandos da CLI, consulte a Referência de Linha de Comando.

  • Execute a operação CreateLog para criar um log em um grupo de logs.