Criando um Log

• Console
• CLI
• API

• 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 de Grupo de Logs.

  1. Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em Log, selecione Logs.
  2. Em Escopo da lista, selecione um compartimento no qual você tenha permissão para trabalhar.
  3. Clique em Criar log personalizado.
  4. Na página Criar log personalizado, informe um nome para o log personalizado. Evite digitar informações confidenciais.
  5. Em Compartimento, selecione o compartimento no qual você deseja criar o log-in.
  6. Em Grupo de logs, selecione um grupo de logs para colocar o log personalizado.
  7. Opcionalmente, clique em Mostrar opções adicionais e forneça os seguintes valores:
     • Em Retenção de Log, selecione por 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.

     • Em Adicionar Tags, adicione uma ou mais tags ao log informando um namespace de tag (para uma tag definida), uma chave e um valor.
  8. Clique em Criar log personalizado.
     Na página Criar configuração do agente, você pode criar uma nova configuração para definir os parâmetros dos dados de log associados (o padrão) ou adicioná-la posteriormente. A configuração do agente define a quais instâncias a configuração se aplica (Grupos de hosts), a quais arquivos de log são obtidos e a quais parsers (se houver) são usados (Configurar entradas de log).

     • Se você selecionar Criar nova configuração, vá para a próxima etapa.
     • Se você selecionar Adicionar configuração posteriormente, vá para a etapa 16.
  9. Informe um nome e uma descrição para a configuração. Evite digitar informações confidenciais.
  10. Selecione o compartimento no qual você deseja criar a configuração.
  11. 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.
  12. Para adicionar grupos, clique em + Outro 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.
  13. Em Configuração do agente, defina o formato dos logs (por quais logs deseja ver) em Configurar entradas de log. Selecione uma das opções na lista Tipo de entrada:
      • 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>* }}

      Clique em + Outra entrada de log para adicionar mais entradas de log personalizadas.

  14. Clique em Opções avançadas do analisador e, no painel Opções avançadas do analisador, selecione um analisador para especificar como fazer parsing do log. Alguns parsers exigem entrada adicional e têm mais opções, dependendo do tipo escolhido.

      Por exemplo, para JSON, você deve selecionar um valor de Tipo de tempo na lista, embora, opcionalmente, você possa especificar a hora do evento e definições de campo nulo. 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 de Log e Parsers.

      Importante
      
      O tipo de parser NONE é obrigatório, mesmo que você não queira especificar um tipo de parser específico.
  15. Depois de configurar as entradas de log e o parser, você tem a opção de especificar definições de tag.
  16. Clique em Criar configuração do agente.

      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.