TheKoguryo's 기술 블로그

 Version 2024.11.15

1.5.1.1 OCI Logging을 사용한 Control Plane 로그 모니터링

OKE 클러스터를 생성후, 모니터링 및 문제해결을 위해 쿠버네티스 Control Plane 상의 프로세스에 대한 로그 모니터링이 필요할 수 있습니다. 컨트롤 플레인상의 프로세스에 대한 로그는 OKE 서비스 로그로 간주되어 OCI 서비스 로그를 다루는 방법과 동일하게 설정하여 사용할 수 있습니다.

OKE 서비스 로그로 제공하는 Control Plane 상의 프로세스에 대한 제공 로그는 다음과 같습니다.

  • kube-scheduler 로그: 스케줄러 결정 같은 kube-scheduler에서 발생하는 로그, 에러, 이벤트
  • kube-controller-manager 로그: replica 수에 맞게 배포에 대한 재조정 같은 kube-controller-manager에서 발생하는 로그, 에러, 이벤트
  • cloud-controller-manager 로그: 로드 밸런서 프로비저닝 같은 cloud-controller-manager에서 발생하는 로그, 에러, 이벤트
  • kube-apiserver 로그: Kubernetes API 서버로 전송된 모든 요청같은 kube-apiserver 로그, 에러, 이벤트
Log Group 만들기

Log Group은 로그들을 관리하는 말 그대로 로그의 묶음 단위 입니다. 로그들을 담는 그릇으로 그룹이 없는 경우에 먼저 만듭니다.

  1. 좌측 상단 햄버거 메뉴에서 Observability & Management > Logging > Log Groups로 이동합니다.

  2. Create Log Group을 클릭하여 로그 그룹을 만듭니다.

    • Name: 예, oke-log-group

    image-20230705233346319

OKE 서비스로 활성화하기
  1. 좌측 상단 햄버거 메뉴에서 Observability & Management > Logging > Logs로 이동합니다.

  2. 위치할 Compartment를 선택합니다.

  3. Enable service log를 클릭합니다.

  4. Select Resource

    • OCI Kubernetes Engine 서비스를 선택하고, 대상 OKE 클러스터를 선택합니다.

      image-20240115112325825

  5. Configure Log

    1. 대상 로그를 지정합니다. 특정 프로세스 또는 전체 로그를 선택합니다.

      image-20240115113001912

    2. 로그 이름을 입력합니다.

      • Name: 예, oke-control-plane-log-for-oke-cluster-1
  6. Show Advanced Options를 클릭하여 필요하면 추가 설정을 합니다.

    • Log Location: 속할 로그 그룹을 앞서 만든 Log Group으로 선택합니다.
    • Log Retention: 보관 기간을 지정합니다. 최대 6개월(180일) 까지 OCI Logging에서
  7. 설정 완료후 Enable Log를 클릭합니다.

  8. OCI 서비스 콘솔에서 Log 화면으로 다시 돌아갑니다.

  9. 화면에서 Resources > Explore Log에서 로그를 조회 할 수 있습니다. 검색을 위해서는 로그목록 오른쪽 위에 있는 Explore with Log Search를 클릭합니다.

    image-20240115114513779

  10. Custom filters 항목에서 source='cloud-controller-manager' 같이 검색값으로 조회하면 됩니다. Custom filters에 값을 입력하고 엔터키를 꼭 칩니다.

    image-20240115115104865

  11. 검색된 로그 데이터를 확인할 수 있습니다.

    image-20240115115419206

  12. OCI Logging 에 수집된 로그는 필요시, OCI Service Connector Hub를 통해 타시스템으로 전달할 수 있습니다.



이 글은 개인으로서, 개인의 시간을 할애하여 작성된 글입니다. 글의 내용에 오류가 있을 수 있으며, 글 속의 의견은 개인적인 의견입니다.

Last updated on 11 Jan 2024