Certifique-se de ter coletado as informações necessárias sobre seu cluster do Kubernetes em sua tenancy e ter os privilégios necessários para conectar seu cluster. A Oracle recomenda que um usuário com privilégios de Administrador execute esta operação. Após uma conexão bem-sucedida, os logs, as métricas e as informações do objeto dos componentes do Kubernetes relacionados e os nós de computação são coletados desse cluster.

1. Abra o menu de navegação e clique em Observabilidade e Gerenciamento. Em Logging Analytics, clique em Soluções e clique em Kubernetes. A página Solução de Monitoramento do Kubernetes é aberta.

2. Na página Solução de Monitoramento do Kubernetes, clique em Conectar clusters. O assistente Adicionar Dados é aberto. Aqui, a seção Monitorar o Kubernetes já está expandida. Clique em Oracle OKE. A página Configurar monitoramento do ambiente do OKE é aberta.

3. Selecione o cluster do OKE com o qual você deseja estabelecer conexão com o Oracle Logging Analytics clicando na linha correspondente na tabela de clusters. Use os detalhes na tabela para identificar o cluster correto do OKE. Clique em Próximo.

4. No menu, selecione o compartimento para armazenar os dados de telemetria e os recursos de monitoramento relacionados.

5. Opcionalmente, as Políticas e grupos dinâmicos necessários são criados. Você poderá desativar a caixa de seleção se já as tiver criado. Para obter as políticas necessárias, consulte Permitir Todas as Operações da Solução Kubernetes.

6. Opcionalmente, o servidor de métricas é instalado para o conjunto de métricas de uso. Você pode desativar a caixa de seleção se já a tiver instalado.

7. Selecione a Opção de implantação da solução:

   • Ativar os clusters acima automaticamente: Selecione esta opção para permitir que o Oracle Logging Analytics crie automaticamente todos os recursos necessários.
     Observação
     
     Esta opção de implantação não é recomendada para clusters do OKE que não têm ponto final do servidor de API pública. Nesses casos, use a opção de implantação Implantarei manualmente os clusters acima. Para obter detalhes, consulte a Página GitHub de Monitoramento do OCI Kubernetes.

     A configuração de coleta automática de logs cria ou atualiza os seguintes recursos:

     • Política do IAM e Grupos Dinâmicos
     • Entidades e Grupos de Logs do Oracle Logging Analytics
     • Chave do Management Agent
     • Namespace da métrica
     • Configuração do Management Agent
     • Configuração do Fluentd
     • Manifestos e gráfico de Helm do Kubernetes
   • Implantarei manualmente os clusters acima: Selecione esta opção para que o Oracle Logging Analytics crie todos os recursos do Oracle Cloud Infrastructure e forneça a você a capacidade de gerenciar a implantação do Fluentd e de outras configurações por meio de manifestos do Helm/Kubernetes no cluster. No entanto, as instruções de instalação serão fornecidas no final do workflow de conexão. Essa opção permite personalizar a configuração padrão e outros parâmetros de coleta usados na implantação automática.

8. Clique em Configurar coleta de logs para confirmar a configuração especificada.

   Os recursos do Oracle Cloud Infrastructure agora são criados.

9. Se você selecionar a opção de implantação manual para a solução, siga as instruções de instalação fornecidas no final do workflow de conexão para implantação de gráfico Helm.

Com isso, a configuração é concluída para coletar os dados do cluster do Kubernetes. Vá para a página da solução de monitoramento do Kubernetes e aguarde alguns minutos para que a coleta de dados seja concluída. Quando a coleta de dados está em andamento, a Telemetria Mais Recente do cluster é Unknown. É possível visualizar a solução após essa alteração de status.

Os dados de telemetria coletados do cluster do Kubernetes são apresentados em várias views para ajudá-lo a obter insights sobre o ambiente e seu desempenho.

Para exibir a solução do cluster do Kubernetes:

1. Abra o menu de navegação e clique em Observabilidade e Gerenciamento. Em Logging Analytics, clique em Soluções e clique em Kubernetes. A página Solução de Monitoramento do Kubernetes é aberta. Os clusters que já estão conectados ao Oracle Logging Analytics são listados na guia Clusters monitorados.

2. Em Clusters monitorados, clique no nome do cluster que você deseja monitorar e analisar. A solução do cluster selecionado é aberta com a exibição Cluster padrão.

Agora explore a solução e as várias exibições disponíveis para percorrer as camadas da topologia e obter detalhes em cada nível na Exibição de cluster, Exibição de carga de trabalho, Exibição de nó e Exibição de pod. Observe que o contexto do filtro é mantido entre as diferentes views.

View do cluster

Um exemplo de exibição de cluster da solução Kubernetes:

As seguintes seções são exibidas na exibição de cluster:

• Seletor de tempo (2 na imagem): Há duas opções de intervalo de tempo, Last 60 Minutes (padrão) e Last 24 Hours. Qualquer alteração feita no intervalo de tempo afetará os Eventos e os Widgets do Painel Direito.

• Filtros (1 na imagem):

  • Filtro de Namespaces: Para filtrar a view por namespace do Kubernetes.

• Topologia (3 na imagem): Os dados de objetos coletados do ambiente do Kubernetes são exibidos nesta seção. Clique com o botão direito do mouse em um namespace para adicioná-lo ao filtro. Em seguida, a view de topologia é alterada para refletir os objetos no namespace, que inclui cargas de trabalho e nós. A topologia é baseada na hora atual e não é afetada pelas configurações de intervalo de tempo.

  A cor de cada objeto na topologia indica seu status derivado de eventos de aviso ativos associados ao objeto ou seus filhos. Por exemplo, se um pod tiver um ou mais eventos de advertência, o código de cor do pod será alterado para RED e a carga de trabalho correspondente (que possui o pod) e o namespace também serão refletidos com o mesmo status.

• Pods por namespace (5 na imagem): Os pods disponíveis na topologia. Para obter detalhes sobre a cor de cada pod, consulte o parágrafo acima.
• Resumo do Painel Esquerdo (4 na imagem): O Resumo do Painel Esquerdo é baseado no horário atual e não é afetado pelas definições de intervalo de tempo.
• Eventos (7 na imagem): Esta seção exibe as alterações de Estado que ocorrem no Cluster do Kubernetes na forma de Eventos. Você pode filtrar ainda mais os eventos por Somente Avisos ou Todos.

  Você pode expandir a seção de eventos para exibir a tabela no centro da página.

• Widgets do Painel Direito (6 na imagem): Esses widgets ajudam a monitorar a integridade do sistema. The type of widgets available upon using the rotating scroll bar are CPU core (used/allocatable) in %, CPU core used, Memory (used/allocatable) in %, Memory used, Kubernetes system, OS health, Total API server requests, API server request duration, API response size, API request execution duration, etcd request duration, Network: bytes rx, Network: byts tx, Network Packet Rx Rate, Network: Packet Tx Rate, Network: Packet Rx Dropped Rate, and Network: Packet Tx Dropped Rate.

Você pode expandir cada seção para exibir uma visualização maior e fazer um mouse-over para exibir mais detalhes.

Visualização da carga de trabalho

Um exemplo de exibição de carga de trabalho da solução Kubernetes:

As seções Seletor de tempo, Eventos, Resumo do Painel Esquerdo e Widgets do Painel Direito são iguais às da view de cluster. O contexto Filtro de Namespace é retido na view de cluster e um filtro adicional para cargas de trabalho também está disponível nessa view. A seção Pods por Carga de Trabalho oferece a exibição dos pods conforme agrupados pela carga de trabalho à qual eles pertencem. Além disso, a view inclui os Detalhes da carga de trabalho. Nesta seção, você pode expandir cada tipo de carga de trabalho para exibir as informações detalhadas do namespace, nome da carga de trabalho, status e sua idade.

View de nó

Um exemplo de exibição de nó da solução Kubernetes:

As seções Seletor de tempo, Eventos, Resumo do Painel Esquerdo e Widgets do Painel Direito são iguais às da view de cluster. O contexto Filtro de Namespace e Filtro de Cargas de Trabalho são mantidos na view Cargas de Trabalho, e o filtro adicional para Nós também está disponível nessa view. A seção Pods por nó oferece a view dos pods conforme agrupados pelo nó ao qual eles pertencem. Além disso, a view inclui o Status do nó. Nesta seção, você pode expandir cada nó para exibir as informações detalhadas, como status, problemas, idade, SO, runtime do contêiner, versões do kubelet / kubeproxy, CPU, memória (capacidade) e memória (alocável). Você também pode exibir seletivamente o status apenas dos nós que têm problemas ou não estão prontos.

Um exemplo de exibição de pod da solução Kubernetes:

As seções Seletor de tempo, Eventos, Resumo do Painel Esquerdo e Widgets do Painel Direito são iguais às da view de cluster. O contexto Filtro de Namespace, Filtro de Cargas de Trabalho e Filtro de Nós é retido na view Nós. A seção Pods exibe os pods e seu status com base na seleção do filtro. Além disso, a view inclui o Status dos pods. Nesta seção, você pode expandir cada pod para exibir as informações detalhadas, como status, nó, namespace, pod IP, controlador, tipo de controlador e programador. Você também pode exibir seletivamente os detalhes dos pods com base em seu status atual, como execução, falha, sucesso e pendente.

Crie um grupo dinâmico para permitir a coleta de informações de logs, métricas e objetos:

ALL {instance.compartment.id = '<OKE_COMPARTMENT_OCID>'}
ALL {resource.type='managementagent', resource.compartment.id='<TELEMETRY_COMPARTMENT_OCID>'}

Crie políticas para permitir que o grupo dinâmico execute as operações de coleta de dados:

allow dynamic-group <dynamic_group_name> to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment id <TELEMETRY_COMPARTMENT_OCID>
allow dynamic-group <dynamic_group_name> to use METRICS in compartment id <TELEMETRY_COMPARTMENT_OCID> WHERE target.metrics.namespace = 'mgmtagent_kubernetes_metrics'
allow dynamic-group <dynamic_group_name> to {LOG_ANALYTICS_DISCOVERY_UPLOAD} in tenancy

Para obter informações sobre grupos dinâmicos e políticas do serviço IAM, consulte Documentação do OCI: Gerenciando Grupos Dinâmicos e Documentação do OCI: Gerenciando Políticas.