Documentação do Oracle Cloud Infrastructure

Exibindo Logs do Aplicativo em Nós Gerenciados e Nós Autogerenciados

Descubra como exibir os logs de aplicativos em execução em nós gerenciados e nós autogerenciados em um cluster do Kubernetes que você criou usando o Kubernetes Engine (OKE).

Tendo criado um cluster usando o Kubernetes Engine, você pode usar o Oracle Cloud Infrastructure Logging para exibir e pesquisar os logs dos aplicativos executados nas instâncias de computação que hospedam nós gerenciados e nós autogerenciados no cluster.

Para que você possa coletar e fazer parsing dos logs do aplicativo usando o Oracle Cloud Infrastructure Logging:

  • Você já deverá ter:
    • Monitoramento ativado para instâncias de computação que hospedam nós gerenciados e nós autogerenciados (consulte Ativando o Monitoramento de Instâncias do Serviço Compute).
    • Instalou o software Oracle Cloud Agent em instâncias de computação que hospedam nós gerenciados e nós autogerenciados. O agente permite que você especifique quais logs coletar e como fazer parsing deles. O agente é instalado por padrão nas instâncias de computação do nó gerenciado. Para confirmar se o agente já está instalado, consulte Verificar Instalação do Agente.
  • Você já deverá ter:
    • Criado um grupo dinâmico com uma regra que inclui as instâncias de computação que hospedam nós gerenciados e nós autogerenciados como hosts de destino (consulte Sobre Grupos Dinâmicos e Selecionando Hosts de Destino com Grupos Dinâmicos). Por exemplo:
      instance.compartment.id = 'ocid1.tenancy.oc1..<unique-id>'
    • Criado uma política para o grupo dinâmico com uma instrução de política para permitir que os hosts de destino do grupo dinâmico enviem logs para o Oracle Cloud Infrastructure Logging (consulte Selecionando Hosts de Destino com Grupos Dinâmicos). Por exemplo:
      allow dynamic-group <dynamic-group-name> to use log-content in tenancy

      Observe que, se um grupo dinâmico não estiver no domínio de identidades padrão, coloque o nome do grupo dinâmico como prefixo com o nome do domínio de identidades no formato dynamic-group '<identity-domain-name>'/'<dynamic-group-name>'. Você também pode especificar o grupo dinâmico usando seu OCID, no formato dynamic-group id <dynamic-group-ocid>.

Depois de concluir os pré-requisitos anteriores, você poderá definir logs personalizados e configurações associadas do agente para exibir os logs dos aplicativos nas instâncias de computação que hospedam nós gerenciados e nós autogerenciados. Observe que os logs do aplicativo devem ser enviados para o caminho do arquivo especificado quando você cria uma configuração de agente (geralmente, mas não necessariamente, /var/logs/containers). Para obter mais informações sobre logs personalizados e configurações do agente, consulte Logs Personalizados.

Observe que, além de exibir logs do aplicativo em instâncias de computação que hospedam nós gerenciados e nós autogerenciados, você também pode:

Usando a Console

Para definir um novo objeto de log personalizado e uma configuração de agente associada para permitir que você exiba e pesquise os logs de aplicativos em execução nas instâncias de computação que hospedam nós gerenciados e nós autogerenciados em um cluster:

  1. Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em Log, selecione Logs.
  2. Escolha um Compartimento no qual você tem permissão para trabalhar.
  3. Selecione Criar log personalizado para criar um novo log personalizado.

  4. Na página Criar log personalizado, especifique:

    • Nome do Log Personalizado: Um nome de sua escolha para o novo log personalizado. Evite digitar informações confidenciais.
    • Compartimento: O compartimento no qual criar o novo log personalizado.
    • Grupo de Logs: O grupo de logs no qual o log personalizado será colocado. Opcionalmente, selecione Criar Novo Grupo para criar um novo grupo de log (consulte Logs e Grupos de Log).
  5. Opcionalmente, selecione Mostrar opções adicionais e especifique:
    • Retenção de Log: O período (em meses) de retenção do log personalizado. Selecione uma das opções predefinidas ou Horário personalizado e especifique um número de meses de sua escolha (até 60).
    • Opções de Tag: 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 Recursos. Se você não tiver certeza se deseja aplicar tags, ignore essa opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.

  6. Selecione Criar log personalizado.

    Um novo log personalizado é criado e a página Criar configuração do agente é exibida.

    Por conveniência, essas instruções agora descrevem como criar uma nova configuração do agente associada ao novo log personalizado (embora você possa criar mais tarde uma nova configuração do agente, se preferir).

  7. Na página Criar configuração do agente, selecione Criar nova configuração e especifique:

    • Nome da Configuração: Um nome de sua escolha para a nova configuração do agente. Evite digitar informações confidenciais.
    • Descrição: Uma descrição para a nova configuração do agente.
    • Compartimento: O compartimento no qual criar a nova configuração do agente.
  8. No painel Grupos de Hosts da página Criar configuração do agente, especifique:
    • Tipo de grupo: Selecione Grupo dinâmico.
    • Grupo: Um grupo dinâmico existente que inclui nós gerenciados nos pools de nós gerenciados do cluster como hosts de destino. O grupo dinâmico selecionado deve ter permissão para acessar o compartimento especificado para a configuração do agente e também deve permitir que os hosts de destino enviem logs para o Oracle Cloud Infrastructure Logging.

  9. No painel Configuração do agente, na página Criar configuração do agente, especifique:

    • Configurar entradas de log: Um ou mais locais dos quais obter os logs do aplicativo como entradas para o log personalizado, conforme a seguir:
      • Tipo de entrada: Selecione Caminho do log.
      • Nome da entrada: Um nome de sua escolha para a nova entrada de log.
      • Caminhos de arquivo: O caminho para logs de aplicativos nas instâncias de computação que hospedam nós gerenciados e nós autogerenciados. Por exemplo, normalmente (mas não necessariamente) /var/logs/containers/*
    • Selecionar destino de log: As opções são pré-preenchidas com os detalhes de log personalizados especificados anteriormente.
  10. Opcionalmente, selecione Mostrar opções adicionais e especifique:
    • Opções de Tag: 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 Recursos. Se você não tiver certeza se deseja aplicar tags, ignore essa opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.
  11. Selecione Criar configuração do agente para criar a configuração do agente associada ao log personalizado.

Para exibir e pesquisar o conteúdo de um log personalizado criado para um aplicativo em execução em instâncias de computação que hospedam nós gerenciados e nós autogerenciados em um cluster:

  1. Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em Log, selecione Logs.
  2. Selecione o nome do log personalizado que você deseja exibir. Você pode classificar as entradas de log por idade e filtrar por tempo.
  3. (Opcional) Selecione Ações e selecione Explorar com Pesquisa de Log para abrir a página Pesquisar de registro em log central. Você pode aplicar filtros, explorar e visualizar dados de log de diferentes maneiras (consulte Exibindo Logs Personalizados em uma Instância do Serviço Compute).