노드

클러스터 및 노드에 대한 개요는 개요를 참고하세요. 시스템 > 클러스터 > 노드에서는 로그프레소 클러스터를 구성하는 노드 페어를 조회하고, 클러스터 구성에 사용할 노드 페어를 추가하거나 수정할 수 있습니다. 이 화면에서는 이중화된 노드를 하나의 노드 페어 단위로 관리합니다.

이 메뉴는 클러스터 관리자만 사용할 수 있습니다.

노드 페어 목록 조회

시스템 > 클러스터 > 노드에서 등록된 노드 페어 목록을 조회할 수 있습니다.

클러스터 노드 목록 예시

노드 페어 목록에서 다음 정보를 확인할 수 있습니다.

  • 상태: 노드 페어의 연결 상태(녹색: 연결됨, 회색: 연결되지 않음)
  • 이름: 노드 페어의 고유 이름
  • 유형: 노드 페어의 역할(분석, 수집, 전달 중 하나)
  • 대표 IP 주소: 노드 A와 노드 B가 공유하는 가상 IP 주소와 포트
  • 노드 ID: 노드 A와 노드 B의 ID. 각각 별도 줄에 표시됩니다.
  • 노드 주소: 노드 A와 노드 B의 주소. 각각 별도 줄에 표시됩니다.
  • 설명: 노드 페어에 대한 설명

노드 페어 목록을 좁혀서 보려면 상단 도구 모음의 검색창을 사용하세요. 검색어는 이름 또는 설명에 포함된 문자열과 대조합니다(노드 ID는 검색 대상이 아닙니다).

노드 목록 다운로드

노드 페어 목록을 파일로 저장하려면 다음 순서로 진행하세요.

  1. 도구 모음에서 다운로드를 클릭하세요.

  2. 노드 목록 다운로드 대화상자에서 다운로드할 파일의 속성을 지정한 뒤 다운로드를 클릭하세요.

    노드 목록 다운로드

    • 파일 이름: 다운로드할 파일 이름입니다(기본값: 클러스터 노드).
    • 컬럼: 다운로드에 포함할 항목입니다. 상태, 이름, 유형, 대표 IP 주소, 대표 IP 포트, 노드 A ID, 노드 A 주소, 노드 A 포트, 노드 B ID, 노드 B 주소, 노드 B 포트, 설명 중에서 선택하세요(기본값: 모두 선택).
    • 파일 형식: CSV, XML, Microsoft Word, HTML, JSON, PDF 중 선택하세요(기본값: CSV).
    • 인코딩: 파일의 문자열 인코딩 형식입니다. 파일 형식이 CSV 또는 JSON일 때만 나타나며, UTF8, UTF16, MS949 중 선택할 수 있습니다(기본값: 파일 형식이 CSV이면 MS949, JSON이면 UTF8).
    • 범위: 내려받을 구간의 시작 번호와 끝 번호(기본값은 현재 페이지의 첫 행 번호부터 전체 건수까지). 번호는 목록에 보이는 순서대로 매겨집니다.
노드 목록 새로 고침

노드 페어 목록을 최신 정보로 갱신하려면 도구 모음에서 새로 고침을 클릭하세요.

노드 페어 추가

노드 페어는 클러스터를 구성하는 기본 단위입니다. 필요하면 Node A만 먼저 등록한 뒤 나중에 Node B를 추가할 수 있습니다.

노드 페어를 추가하려면,

  1. 시스템 > 클러스터 > 노드에서 도구 모음의 추가를 클릭하세요.

  2. 노드 추가 화면에서 공통 설정을 입력하세요.

    노드 추가 - 공통 설정

    • 유형: 노드 페어의 역할(기본값: 수집 노드, 선택지: 수집 노드, 분석 노드, 전달 노드)
    • 이름: 노드 페어를 식별하는 고유한 이름(필수, 최대 50자). 전달 노드는 로그를 보낼 노드 페어를 이 이름으로 찾으므로, 로그를 받는 노드 페어(수집 노드 페어, 2 티어 아키텍처에서는 분석 노드 페어)의 이름은 설치할 때 전달 노드의 로그프레소 셸에서 forwarder.addBasepair 명령어에 똑같이 입력합니다(수집한 로그 전송 설정 참고). 설치 설명서의 예시처럼 공백 없이 영문자와 숫자로 된 짧은 식별자(예: c1, d1, f1)로 지으세요.
    • 설명: 노드 페어에 대한 설명(최대 2,000자)
    • TLS: 노드 간 REST API 통신에 TLS를 적용할지 여부(기본값: 사용)
    • 인증서 검증: TLS 통신 시 인증서를 검증할지 여부(기본값: 사용 안 함)
    • 접속 타임아웃: 연결을 기다리는 최대 시간(기본값: 10,000밀리초, 범위: 0-3,600,000)
    • 읽기 타임아웃: 응답을 기다리는 최대 시간(기본값: 10,000밀리초, 범위: 0-3,600,000)
    • 고가용성 구성: 고가용성 이중화 사용 여부. 이 옵션을 사용하면 대표 IP와 노드 B 설정을 입력할 수 있습니다.
    • 대표 IP: 노드 A와 노드 B가 공유할 가상 IP 주소와 포트. 고가용성 구성을 사용할 때만 입력할 수 있으며, 주소와 포트 중 하나를 입력하면 나머지도 입력해야 합니다.
    Note
    대표 IP는 노드 A 또는 노드 B의 주소와 중복되면 안 됩니다.

  3. 노드 A 설정과 필요하면 노드 B 설정에서 노드별 속성을 입력하세요. 노드 B 설정은 고가용성 구성을 사용하는 경우에만 입력할 수 있습니다.

    노드 추가 - 노드 A/B 설정

    • GUID: 노드의 GUID. 노드 페어를 생성한 후 표시됩니다.
    • 노드 ID: 노드의 고유 식별자(필수, 최대 255자). 쿼리에서 노드를 지정할 때(예: table d1a:WEB_ACCESS)와 설치할 때 로그프레소 셸의 forwarder.setGuid·sentry.setGuid 명령어에 이 값을 그대로 쓰므로, 공백 없이 영문자와 숫자로 된 짧은 식별자(예: c1a, c1b)로 지으세요.
    • 주소: 노드의 실제 IP 주소 또는 도메인 주소와 포트(필수, 포트 범위: 0-65535, 기본값: 443 — 노드 유형·노드 A/B와 무관하게 항상 같은 기본값을 씁니다). 분석 노드는 443, 수집 노드와 전달 노드는 8443을 입력하세요(설치 설명서의 분석 노드 페어 등록, 수집 노드 페어 등록, 전달 노드 페어 등록 참고).
    • 계정: 노드 통신에 사용할 계정 ID(필수, 최대 50자, 기본값: root)
    • 암호: 노드 통신 계정의 암호(노드 페어 생성 시 필수, 최대 50자)

  4. 설정을 검토한 후 저장을 클릭하세요. 추가를 취소하려면 뒤로 가기 버튼으로 사이드 패널을 닫으세요.

노드 페어 수정

노드 페어를 수정하거나, 기존 노드 페어에 Node B를 추가하거나, 대기 노드 구성을 해제하려면,

  1. 노드 페어 목록에서 수정할 노드 페어의 이름을 클릭하세요.

  2. 노드 수정 화면에서 필요한 항목을 변경하세요. 입력 항목은 노드 페어 추가를 참고하세요.

    노드 수정

    • 노드 페어를 생성한 후에는 유형과 기존 노드 ID를 수정할 수 없습니다.
    • 로그를 받는 노드 페어의 이름은 전달 노드의 베이스 노드 페어 이름(forwarder.addBasepair)과 이미 배포된 수집기 설정이 함께 참조하므로, 운영을 시작한 뒤에는 처음 정한 이름을 그대로 쓰세요. 이름을 바꿔야 하면 기술 지원팀에 문의하세요.
    • 기존 Node A와 Node B의 GUID는 수정 화면에서만 표시됩니다.
    • Node B를 사용하지 않으려면 고가용성 구성을 해제하세요.

  3. 변경한 내용을 검토한 후 저장을 클릭하세요.

노드 페어 삭제

노드 페어를 삭제하려면,

  1. 삭제하려는 노드 페어를 참조하는 수집기가 있는지 확인하세요.

  2. 노드 페어의 체크박스를 선택한 후 도구 모음에서 삭제를 클릭하세요.

  3. 노드 삭제 대화상자에서 삭제 대상을 확인한 후 삭제를 클릭하세요. 삭제하지 않으려면 취소를 클릭하세요.

    노드 삭제

선택한 노드 페어 중 삭제할 수 없는 항목이 있으면 노드 이름과 실패 이유가 표시되는 실패 대화상자가 나타나고, 이때 선택한 노드 페어는 하나도 삭제되지 않습니다. 대화상자에 나온 수집기를 먼저 정리한 뒤 다시 삭제하세요.

Caution
노드 페어 삭제는 일반적인 작업이 아닙니다. 운영 환경에서 노드 페어를 삭제해야 하는 경우, 반드시 기술 지원팀에 문의하세요.
스토리지 관리

노드 페어를 추가하거나 수정할 때 스토리지 관리에서 여유 공간이 부족할 때의 기준과 동작을 설정할 수 있습니다.

노드 추가 - 스토리지 관리 설정

  • 최소 여유 공간 기준을 설정하세요.
    • % 단위일 때 기본값은 5이고, 유효 범위는 1-50입니다.
    • MB 단위일 때 기본값은 100이고, 유효 범위는 100-9,999,999,999입니다.
  • 남은 디스크 용량이 설정한 기준보다 작아지면 수행할 동작을 선택하세요.
    • 오래된 데이터부터 삭제: 오래된 데이터부터 삭제하여 여유 공간을 확보합니다(기본값).
    • 수집 중지: 해당 노드 페어에서 로그 수집을 중지합니다.
Note
스토리지 관리 기능은 데이터 생명주기 보관 설정과 별개로 독립적으로 동작합니다.