NSX의 지원 번들 기능을 사용하여 자세한 문제 해결 및 진단 목적으로 Antrea Kubernetes 클러스터 노드에서 로그 파일을 수집할 수 있습니다.

NSX는 지원 번들을 지원 번들 수집 요청을 트리거한 NSX Manager 노드에 업로드하거나, 지원 번들을 요청에 지정한 원격 파일 서버에 업로드할 수 있습니다. 지원 번들이 NSX Manager 노드에 업로드되면 로컬 컴퓨터에 다운로드할 수 있습니다.

참고: 이 설명서에서는 "Antrea Kubernetes 클러스터"라는 용어를 사용하여 Antrea CNI가 있는 Kubernetes 클러스터를 나타냅니다. "Kubernetes 클러스터"라는 용어는 Antrea CNI가 있는 TKG( Tanzu Kubernetes Grid) 클러스터, Antrea CNI가 있는 OpenShift 클러스터 또는 Antrea CNI가 있는 DIY(Do It Yourself) Kubernetes 클러스터를 나타내는 일반 용어입니다.

UI는 일부 UI 필드 또는 레이블에 "Antrea 컨테이너 클러스터"라는 용어를 사용합니다. 이 설명서의 "절차" 섹션에서 해당 UI 필드 또는 레이블에 "Antrea 컨테이너 클러스터"라는 용어가 유지됩니다. 모든 자유 형식 텍스트의 경우 "Antrea Kubernetes 클러스터"라는 용어가 사용됩니다.

Antrea Kubernetes 클러스터에 대한 지원 번들에는 다음 구성 요소에 대한 로그 파일이 포함되어 있습니다.
  • Antrea 컨트롤러
  • Antrea 에이전트
  • 관리부 어댑터
  • 중앙 제어부 어댑터
  • Open vSwitch
지원되는 기능 및 지원되지 않는 기능
  • NSX Manager 노드에서는 단일 지원 번들 수집 요청만 시작할 수 있습니다. 하지만 단일 수집 요청으로 여러 Antrea Kubernetes 클러스터에 대한 지원 번들을 수집할 수 있습니다.
  • 3개의 관리 노드가 있는 NSX Manager 클러스터를 사용하는 경우 각 NSX Manager 노드에서 별도의 지원 번들 수집 요청을 동시에 시작할 수 있습니다. 그러나 각 수집 요청에서 선택하는 Antrea Kubernetes 클러스터는 서로 달라야 합니다.

    예를 들어 NSX Manager 노드 A에서 지원 번들 수집 요청을 시작했다고 가정합니다. 이 수집 요청에서 클러스터 노드 1과 2를 Antrea Kubernetes 클러스터 X에서 선택했습니다. 동시에 Antrea Kubernetes 클러스터 X의 클러스터 노드 3과 4에 대해 NSX Manager 노드 B에서 수집 요청을 시작하면 이러한 두 수집 요청 중 하나가 실패합니다. 동일한 Antrea Kubernetes 클러스터에 대한 두 번째 요청을 트리거하기 전에 첫 번째 수집 요청이 완료될 때까지 기다려야 합니다.

  • NSX Manager Central CLI의 지원 번들 수집은 현재 Antrea Kubernetes 클러스터에서 지원되지 않습니다.

사전 요구 사항

Antrea Kubernetes 클러스터는 NSX에 등록됩니다.

프로시저

  1. 브라우저의 https://nsx-manager-ip-address에서 NSX Manager에 로그인합니다.
  2. 시스템 > 지원 번들로 이동합니다.
    번들 요청 페이지가 열립니다.
    중요: 브라우저에서 NSX Manager 애플리케이션을 시작할 때 NSX Manager UI가 등록된 Antrea Kubernetes 클러스터에 대한 정보를 가져옵니다. 애플리케이션 UI가 이미 열려 있으면 Antrea Kubernetes 클러스터 등록 정보를 자동으로 가져오지 않습니다. 이 동작은 현재 UI 디자인에 따라 예상되는 동작입니다. NSX Manager 애플리케이션을 연 후 첫 번째 Antrea Kubernetes 클러스터를 등록한 경우 번들 요청 페이지로 이동한 후 브라우저를 새로 고쳐야 합니다. 수동 새로 고침을 수행하면 이 절차의 다음 단계에서 Antrea Kubernetes 클러스터를 대상 노드로 선택할 수 있습니다.

    이 수동 브라우저 새로 고침은 한 번만 필요하며 새 Antrea Kubernetes 클러스터가 NSX에 등록될 때마다 매번 필요하지는 않습니다.

  3. 지원 번들 요청에 포함할 대상 노드를 선택합니다.
    사용 가능한 노드 유형은 다음과 같습니다.
    • 컨테이너 클러스터 Antrea
    • 관리 노드
    • Edge
    • 호스트

    단일 지원 번들 요청에는 NSX 환경에 있는 여러 다른 유형의 노드가 혼합되어 포함될 수 있습니다. 예를 들어 동일한 수집 요청에서 Antrea Kubernetes 클러스터의 노드, NSX Manager 노드 및 NSX Edge 노드를 선택할 수 있습니다. 그러나 이 절차에서는 Antrea Kubernetes 클러스터에 대해서만 지원 번들 수집 요청을 생성하는 워크플로를 설명합니다.

  4. 유형 드롭다운 메뉴에서 Antrea 컨테이너 클러스터를 선택합니다.
  5. 컨테이너 클러스터 목록에서 클러스터의 이름을 선택합니다.
    목록에 선택할 수 있는 클러스터가 여러 개 있는 경우 클러스터 이름의 처음 몇 자를 입력합니다. 시스템은 목록을 필터링하고 입력한 문자와 일치하는 클러스터 이름만 표시합니다.
    선택한 클러스터의 모든 노드가 사용 가능 목록에 표시됩니다.
  6. 클러스터에서 노드를 하나 이상 선택하고 오른쪽 화살표를 클릭하여 선택됨 목록으로 이동합니다.
    단일 수집 요청에서 여러 클러스터의 노드를 선택하려면 각 클러스터에 대해 4단계와 5단계를 반복합니다.
  7. (선택 사항) 로그 보존 기간(일) 텍스트 상자에서 기본값을 유지하거나 지원 번들에 포함할 로그의 특정 일수를 입력합니다. 로그 사용 기간을 일 단위로 지정합니다.
  8. (선택 사항) 지원 번들을 원격 파일 서버에 업로드하려면 파일 서버 설정을 지정합니다.
    1. 원격 파일 서버의 IP 주소 또는 호스트 이름을 입력합니다.
    2. 파일 전송 프로토콜 및 포트 번호를 입력합니다. 기본 포트 번호는 22입니다.
    3. 원격 파일 서버에 액세스하기 위한 사용자 이름 및 암호를 입력합니다.
    4. 지원 번들 파일이 업로드될 대상 폴더의 경로를 입력합니다.
    원격 파일 서버 설정을 지정하지 않으면 지원 번들이 지원 번들 수집 요청을 트리거한 NSX Manager 노드로 업로드됩니다.
  9. 번들 수집 시작을 클릭합니다.
    수집 요청의 런타임 세부 정보는 상태 페이지에 표시됩니다. 수집 프로세스는 몇 분 정도 걸립니다. 지원 번들을 생성하는 데 소요되는 시간은 컨테이너 클러스터의 각 노드에서 수집할 로그 파일의 수에 따라 다릅니다.
  10. 수집 프로세스가 완료되면 다운로드를 클릭합니다.
    지원 번들 파일이 로컬 시스템에 저장됩니다. 원격 파일 서버 설정을 지정한 경우 다운로드 버튼이 UI에 표시되지 않습니다.

결과

지원 번들 수집 요청은 파일 이름 지정 규칙인 nsx_support_archive_datestamp_timestamp.tar를 사용하여 단일 TAR(테이프 아카이브) 파일을 생성합니다

다음과 같은 경우 지원 번들 수집 요청이 실패할 수 있습니다.
  • 지원 번들 요청이 진행 중일 때 Kubernetes 클러스터의 Antrea NSX 어댑터가 실패하면 해당 Kubernetes 클러스터에 대한 로그 수집이 실패합니다.
  • 지원 번들 요청이 진행 중일 때 NSX Manager 장치가 실패하거나 장치에 연결하지 못하면 로그 수집이 실패합니다. NSX Manager에 대한 연결 문제가 해결될 때까지 Antrea의 네이티브 명령줄 도구(antctl)를 사용하여 Antrea Kubernetes 클러스터에서 로그 파일을 수집할 수 있습니다.
부분 성공 시나리오
지원 번들 수집을 위해 단일 Antrea Kubernetes 클러스터에서 10개의 노드를 선택했다고 가정합니다. 수집 프로세스 중에 로그 파일이 Antrea Kubernetes 클러스터의 5개 노드에서 성공적으로 수집되었지만 나머지 5개 노드에 대해서는 수집되지 않았습니다. 즉, 수집 요청이 부분적으로 성공했습니다. 이 경우 수집 요청 상태는 성공이며 TAR(지원 번들 파일)에는 5개의 성공적인 노드에 대한 로그가 포함됩니다.

다음에 수행할 작업

  1. TAR 파일을 추출합니다. 다음 파일이 표시됩니다.
    파일 이름 설명
    manifest.json

    이 파일에는 수집 요청 결과 및 수집 요청의 속성에 대한 요약이 포함되어 있습니다.

    예를 들어 다음과 같은 정보가 포함됩니다.
    • 수집이 성공한 노드
    • 수집이 실패한 노드
    • 수집 요청에 사용된 클러스터 ID 및 노드 ID
    nsx_antrea_cluster-id.tgz

    지원 번들에 있는 각 Antrea Kubernetes 클러스터에 대해 단일 .tgz 아카이브 파일이 생성됩니다.

  2. nsx_antrea_cluster-id.tgz 파일을 추출합니다. 다음 파일이 표시됩니다.
    파일 이름 설명
    adapters.tar.gz

    이 아카이브 파일에는 관리부 어댑터중앙 제어부 어댑터 로그 파일이 포함되어 있습니다.

    agent_node_name.tar.gz

    이 아카이브 파일에는 Antrea 에이전트 및 Open vSwitch의 로그 파일이 포함되어 있습니다. 수집 요청의 각 Antrea Kubernetes 클러스터 노드에 대해 하나의 아카이브 파일이 생성됩니다.

    이 아카이브 파일을 추출할 때 다음 파일을 볼 수 있습니다.
    • agentinfo 파일
    • 에이전트 로그(/logs/agent)
    • Open vSwitch 로그(/logs/ovs)
    • OpenFlow 덤프
    • IPtables
    • 경로 덤프
    clusterinfo
    이 파일은 지원 번들 요청의 각 Antrea Kubernetes 클러스터에 대해 생성됩니다. 이 파일에는 Kubernetes API 서버에서 수집되는 다음 Kubernetes 리소스에 대한 정보가 포함되어 있습니다.
    • 포드
    • 노드
    • 배포
    • ReplicaSets
    • DaemonSets
    controller.tar.gz

    이 아카이브 파일에는 Antrea 컨트롤러의 로그 파일이 포함되어 있습니다.

    이 아카이브 파일을 추출할 때 다음 파일을 볼 수 있습니다.
    • controllerinfo 파일
    • Controller 로그(/logs/controller)