Documentação do Oracle Cloud Infrastructure

Exibindo Logs de Serviços do Kubernetes Engine (OKE)

Descubra como exibir os logs de processos do Kubernetes (como kube-scheduler, kube-controller-manager, cloud-controller-manager e kube-apiserver) em execução no plano de controle de clusters 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 processos do Kubernetes executados no plano de controle do cluster. Os logs de processo do plano de controle do Kubernetes estão disponíveis no Oracle Cloud Infrastructure Logging como logs do serviço Kubernetes Engine, onde são chamados de logs de serviço.

Os seguintes logs de processo do plano de controle do Kubernetes estão disponíveis para o Kubernetes Engine como logs de serviço:

  • O log do kube-scheduler, contendo erros e eventos no processo do kube-scheduler (como decisões do scheduler).
  • O log do kube-controller-manager, contendo erros e eventos dentro do processo do kube-controller-manager (como reconciliar a implantação).
  • O log do cloud-controller-manager, contendo erros e eventos no processo do cloud-controller-manager (como provisionar o balanceador de carga).
  • O log do kube-apiserver, contendo erros e eventos no processo do kube-apiserver (para cada solicitação enviada ao servidor de API do Kubernetes).

Os logs de serviço são configurados no nível de log padrão do Kubernetes (v=2). Nesse nível, os logs de serviço contêm informações úteis de estado estacionário sobre o serviço e mensagens de log importantes que podem se correlacionar a alterações significativas no sistema.

Você verá os logs de serviço úteis ao solucionar problemas de cluster, como:

  • Shutdowns da(s) máquina(s) virtual(is) do plano de controle do cluster.
  • Problemas de particionamento de rede dentro de um cluster ou entre o cluster e os usuários.
  • O software Kubernetes falha.
  • Perda ou indisponibilidade de dados de armazenamento persistente.
  • Erros do operador, como Kubernetes ou software de aplicativo configurados incorretamente.

Depois de ativar e configurar logs de serviço, você poderá exibir subsequentemente os logs de serviço.

Para obter mais informações sobre logs de serviço, consulte Logs de Serviço.

Observe que, além de exibir os logs de serviço do Kubernetes Engine, você também pode:

Usando a Console

Para criar um novo objeto de log de serviço para permitir que você exiba e pesquise os logs dos processos do Kubernetes em execução no plano de controle de 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 Ativar log de serviço para criar um novo log de serviço.

  4. Na caixa de diálogo Ativar Log de Recurso:

    1. Identifique o cluster, especificando:
      • Compartimento de Recursos: Selecione o compartimento ao qual o cluster pertence.
      • Serviço: Selecione Kubernetes Engine.
      • Recurso: Selecione o cluster para o qual você deseja ativar logs de serviço.
    2. Configure o log de serviço que deseja exibir especificando:
      • Categoria de Log: Selecione o processo do Kubernetes para o qual você deseja exibir o log de serviço (por exemplo, kube-controller-manager) ou selecione Todas as origens de log.
      • Nome do Log: Um nome de sua escolha para o novo log de serviço. Evite fornecer informações confidenciais.
    3. Opcionalmente, selecione Mostrar Opções Avançadas e especifique:
      • Local do Log: O compartimento no qual criar o log de serviço.
      • Grupo de Logs: O grupo de logs no qual o log de serviço será colocado. Opcionalmente, selecione Criar Novo Grupo para criar um novo grupo de log (consulte Logs e Grupos de Log).
      • Retenção de Log: O tempo (em meses) pelo qual o log de serviço será retido. Selecione uma das opções predefinidas ou selecione Horário personalizado e especifique um número de meses (até um máximo de 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ê deverá 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 esta opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.
    4. Selecione Habilitar Log.

      Um novo log de serviço é criado e a página Detalhes do Log é exibida.

Para exibir e pesquisar o conteúdo de um log de serviço:

  1. Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em Log, selecione Logs.
  2. Selecione o nome do log de serviço que 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 e explorar e visualizar os dados de log de diferentes maneiras.