Criação de log para o Red Hat OpenShift on IBM Cloud

os serviços IBM Cloud, como Red Hat OpenShift on IBM Cloud, geram registros da plataforma que podem ser usados para investigar atividades anormais e ações críticas na sua conta e solucionar problemas.

Você pode usar IBM Cloud Logs Routing, um serviço de plataforma, para rotear os logs da plataforma em sua conta para um destino de sua escolha, configurando um locatário que define para onde os logs da plataforma são enviados. Para obter mais informações, consulte Sobre o roteamento de registros.

Você pode usar IBM Cloud Logs para visualizar e alertar sobre os logs da plataforma que são gerados em sua conta e roteados por IBM Cloud Logs Routing para uma instância IBM Cloud Logs.

A partir de 28 de março de 2024, o serviço IBM Log Analysis será descontinuado e não terá mais suporte. Saiba mais sobre o IBM Cloud Logs.

Locais onde os registros são gerados

os registros Red Hat OpenShift on IBM Cloud são gerados em todas as regiões.

Locais para onde os registros são enviados IBM Cloud Logs

Red Hat OpenShift on IBM Cloud envia logs para IBM Cloud Logs em todas as regiões.

Locais para onde os registros são enviados por IBM Cloud Logs Routing

Red Hat OpenShift on IBM Cloud envia registros por IBM Cloud Logs Routing em todas as regiões.

Registros que são gerados

Os logs são gerados e gravados localmente para todos os seguintes componentes do cluster Red Hat OpenShift on IBM Cloud: nós de trabalho, contêineres, aplicativos, armazenamento persistente, balanceador de carga de aplicativos Ingress, API Kubernetes e o namespace kube-system.

Um agente de registro coleta registros com a extensão *.log e arquivos sem extensão que são armazenados no diretório /var/log/containers do seu pod de todos os namespaces, incluindo kube-system. O agente encaminha os registros para a sua instância de serviço. Também é possível rastrear a atividade administrativa iniciada pelo usuário em seu cluster. O site Kubernetes Service gera automaticamente eventos de gerenciamento de cluster e encaminha esses registros de eventos para IBM Cloud Logs. Para obter mais informações, consulte Introdução ao IBM Cloud Logs.

Para implantar um agente de registro em seu cluster, consulte Implantação do agente de registro para clusters OpenShift usando um gráfico Helm ou Implantação do agente de registro para clusters Kubernetes usando um gráfico Helm.

Ativando o Registro

Para ativar o registro em log do seu cluster, conecte-o a uma instância de serviço de registro existente na sua conta do IBM Cloud. É possível ativar o registro em log em clusters existentes ou durante a criação do cluster. A instância do serviço de registro deve pertencer à mesma conta IBM Cloud em que você criou o cluster, mas pode estar em um grupo de recursos e uma região IBM Cloud diferentes do cluster.

Observe que um cluster só pode ser conectado a uma instância de serviço de registro por vez. É possível alterar a instância do serviço de logging à qual um cluster está conectado no console, desconectando o cluster de uma instância e, em seguida, conectando-se a uma instância diferente.

Habilitar o registro em um cluster existente

  1. Se você ainda não tiver uma instância de serviço de registro em sua conta, crie uma.
  2. No console, navegue até a página de recursos do cluster e clique no cluster relevante.
  3. Em Integrações, localize a opção de registro e clique em Conectar.
  4. Selecione a instância do serviço de registro que deseja conectar ao seu cluster. Se você tiver mais de uma instância de serviço de registro, poderá filtrá-las pela região em que foram criadas.
  5. Clique em Conectar.

Ativar o registro em log ao criar um cluster

  1. Se você ainda não tiver uma instância de serviço de registro em sua conta, crie uma.
  2. Na interface de usuário de criação de cluster, configure seu cluster conforme necessário.
  3. Na seção de integrações do Observability, ative a opção Logging.
  4. Selecione a instância que deseja conectar ao seu cluster.
  5. Continue configurando o cluster.

Visualizando logs do

Para visualizar seus logs, navegue até a página de recursos do cluster no console e clique no cluster relevante. Na seção Integrações, localize a opção Logging e clique em Launch (Iniciar ). Uma janela separada é aberta, na qual é possível visualizar os registros do cluster.

Lançamento de IBM Cloud Logs na página Observability

Para obter mais informações sobre como iniciar a interface do IBM Cloud Logs Consulte Inicialização da interface do usuário na documentação IBM Cloud Logs.

Campos por tipo de registro

Para obter informações sobre os campos incluídos em cada registro de plataforma, consulte Campos para registros de plataforma.

Campos de registro de log
Campo Tipo Descrição
logSourceCRN Obrigatório Define a conta e a instância de log de fluxo nas quais o log é publicado.
saveServiceCopy Obrigatório Define se a IBM salva uma cópia do registro para fins operacionais.

Identificadores de linha por tipo

Campos de registro de log
Identificador Descrição
Source O serviço do qual os registros são enviados.
App O CRN do componente ou serviço que enviou o registro.

Analisando os registros Red Hat OpenShift on IBM Cloud

Você pode visualizar seus logs para ver detalhes sobre eventos que afetam os componentes do cluster. Por exemplo, se um pod falhar, você poderá visualizar os registros no painel para ver as mensagens de erro relacionadas.