콘텐츠로 이동

LogBamboo 사용

배포를 완료한 후 온보딩을 사용하여 LogBamboo의 쓰기 및 쿼리를 먼저 검증하고, 필요에 따라 플랫폼 데이터 전송을 구성할 수 있습니다.

사용 전 준비

배포 관리자에게 서비스 접속 주소, 로그인 계정 및 사용 가능한 인덱스 이름을 받고, 필요에 따라 해당 자격 증명을 준비하세요.

작업 필요한 정보
LogBamboo 페이지에 로그인하여 로그 확인 할당된 로그인 계정 및 인덱스 조회 권한
온보딩을 사용해 테스트 로그를 전송하거나 플랫폼 데이터 전송 구성 현재 유효한 쓰기 Token
플랫폼에서 전송된 데이터 쿼리 별도의 쿼리 Token을 해당 전송 규칙에 입력

연결 정보 준비 방법은 배포 가이드를 참조하세요. 최초 연동 검증은 배포 관리자 또는 연동 담당자가 수행할 수 있습니다. 로그 조회만 필요한 구성원은 과거 데이터 쿼리를 바로 확인할 수 있습니다.

1단계: 로그인 및 인덱스 확인

  1. 브라우저에서 관리자가 제공한 LogBamboo 서비스 주소를 엽니다.
  2. 할당된 계정과 비밀번호로 로그인합니다. 배포를 담당하는 관리자는 배포 시 설정한 관리자 계정을 사용할 수 있습니다.
  3. 왼쪽 로그 인덱스에서 데이터를 수신하는 대상 인덱스가 표시되는지 확인하고, 인덱스를 클릭하여 로그 쿼리 페이지로 이동합니다.

인덱스는 데이터를 분류하여 저장하는 데 사용됩니다. 배포 가이드의 예시 구성을 그대로 사용하는 경우 먼저 app 인덱스를 확인할 수 있습니다. 실제 연동 시에는 관리자가 제공한 인덱스 이름을 기준으로 합니다.

필요한 인덱스가 표시되지 않으면 관리자에게 문의하여 인덱스 구성 및 계정 권한을 확인하세요. 인덱스 추가 또는 보존 정책 조정은 배포 관리자가 유지 관리하며, 작업 방법은 인덱스 확인 및 연결 정보 준비를 참조하세요.

2단계: 온보딩을 통한 서비스 검증

로그 쿼리 페이지에서 대상 인덱스를 선택한 후 왼쪽 하단의 설정 > 온보딩으로 이동하여 페이지의 세 영역에 따라 검증을 완료합니다.

인덱스 연결

인덱스 연결 영역에서 현재 인덱스를 확인하여 이번에 검증할 대상과 일치하는지 점검합니다. 스크린샷의 예시 인덱스는 app입니다.

테스트 로그 쓰기

  1. 쓰기 Token에 관리자가 제공한 현재 유효한 쓰기 Token을 입력합니다.
  2. 페이지에 표시되는 테스트 내용을 확인하고 테스트 로그 한 건 전송을 클릭합니다.
  3. 페이지 안내에 따라 쓰기 결과를 확인하고, 이후 확인을 위해 전송 시간 및 테스트 내용을 기록합니다.

이 작업은 현재 인덱스에 테스트 로그 한 건을 실제로 기록하며, 기존 보존 정책에 따라 저장됩니다. 쓰기가 성공하거나 페이지를 떠나면 토큰 입력 내용이 지워지므로, 다시 테스트할 때는 페이지 요구 사항에 따라 다시 입력해야 합니다.

쿼리 가능 여부 확인

  1. 쓰기 성공 후 쿼리 가능 여부 확인 영역에서 쿼리 가능 여부 검사를 클릭합니다.
  2. 페이지에서 일시적으로 쿼리할 수 없다고 안내하면 처리 완료 후 다시 검사합니다. 테스트 로그를 다시 전송할 필요는 없습니다.
  3. 쿼리 가능함을 확인한 후 오른쪽 상단의 로그 쿼리로 돌아가기를 클릭하고, 이 문서의 쿼리 단계에 따라 테스트 내용을 검색하여 확인할 수 있습니다.

로그가 수신된 후 쿼리 가능해질 때까지 일정한 처리 시간이 필요합니다. 자세한 설명은 데이터 조회 가능 시점을 참조하세요. 대기하는 동안 페이지의 게시 및 영속화 설명을 펼쳐 안내를 확인할 수도 있습니다.

온보딩의 테스트는 LogBamboo 서비스의 쓰기 및 쿼리를 검증하는 데 사용됩니다. 플랫폼 전송이 필요하면 다음 단계도 완료하고, 전송 규칙을 통해 전송된 비즈니스 레코드를 확인해야 합니다.

3단계: 플랫폼 데이터 전송 구성

플랫폼을 통해 데이터를 전송해야 하는 경우 다음 구성을 완료합니다.

  1. 플랫폼의 관리 > 데이터 전송 > 전송 규칙으로 이동하여 전송 규칙을 생성합니다.
  2. 규칙 이름과 필터 조건을 설정하고 대상지를 LogBamboo로 선택합니다.
  3. 관리자가 제공한 서비스 주소, 대상 인덱스 및 쓰기 Token을 입력합니다. 플랫폼에서 다시 조회해야 하는 경우 별도의 쿼리 Token도 입력하고 데이터 조회 권한을 설정합니다.
  4. 연결을 테스트한 후 규칙을 저장하고 활성화하여 조건에 맞는 데이터가 전송 프로세스로 유입되도록 합니다.

전체 필드 설명과 작업 단계는 LogBamboo로 데이터 전송을 참조하세요.

연동 후 해당 규칙을 통해 전송되었고 명확한 키워드가 포함된 비즈니스 레코드 하나를 선택하여 이후 수신 및 쿼리 결과를 확인하는 데 사용할 수 있습니다.

4단계: 쓰기 및 게시 상태 확인

관리자는 로그 쿼리 페이지에서 운영 상태 보기를 클릭하거나 왼쪽 하단의 설정 > 운영 상태로 이동할 수 있습니다. 먼저 페이지에 표시된 노드, 인덱스 및 시간대를 확인한 다음 해당 범위의 데이터 상태를 점검합니다. 현재 계정에 관련 권한이 없으면 관리자에게 문의하여 확인을 요청하세요.

그림의 상태와 값은 페이지 예시이므로, 현재 노드, 인덱스 및 페이지에 표시된 통계 범위를 기준으로 합니다.

쓰기 및 게시 확인

먼저 쓰기 및 게시의 사용 가능한 상태를 확인한 다음, 아래 정보와 함께 실제 데이터 처리 상황을 확인합니다.

페이지 정보 확인 항목
최근 확인된 쓰기 새로운 데이터 쓰기가 관찰되었는지 확인
최근 게시 새로운 데이터 게시가 관찰되었는지 확인
게시 대기 논리 데이터 아직 처리 및 게시를 기다리는 데이터 양 확인
가장 오래된 게시 대기 로그 수신 시간을 기준으로 데이터가 얼마나 오래 대기했는지 판단

아직 관찰되지 않음으로 표시되면 먼저 현재 인덱스로 데이터를 전송했는지 확인하고, 현재 조회 중인 노드와 인덱스를 점검합니다. 데이터가 수신된 후 쿼리 가능해질 때까지 일정한 처리 시간이 필요합니다. 자세한 설명은 데이터 조회 가능 시점을 참조하세요.

용량 및 보존 범위 확인

용량 및 보존에서 용량 변화와 인덱스 보존 설정을 확인합니다.

페이지 정보 확인 항목
용량 상한 도달 예상 최근 용량 증가 추세를 참고하는 데 사용됩니다. 증가 샘플이 부족하거나 순증가가 없으면 페이지에 해당 안내가 표시됩니다.
일일 논리 쓰기(현재 속도 기준) 현재 쓰기 속도로 추산한 참고값
시간 기준 보존 현재 인덱스에 구성된 보존 시간 확인
인덱스 스토리지 용량 상한 현재 인덱스에 용량 보존 상한이 설정되어 있는지 확인
로컬 상태 사용량 / 디스크 사용 가능 용량 현재 노드의 로컬 디스크 상황 확인

인덱스 스토리지 용량 상한이 구성되지 않음으로 표시되면 해당 인덱스에 용량 보존 상한이 설정되지 않았음을 의미합니다. 그래도 현재 배포의 라이선스 용량 및 시간 보존 정책을 따라야 합니다.

아래로 계속 내려가면 최근 1시간 쓰기 추세를 확인할 수 있습니다. 데이터 보존 범위 검사를 클릭하고 페이지 결과에 따라 데이터 보존 상황을 확인합니다. 통계 기준 또는 현재 노드의 최근 용량 제거를 펼치면 해당 설명과 정리 기록을 확인할 수 있습니다.

페이지 정보를 업데이트해야 할 때는 상태 새로고침을 클릭합니다. 관리자 또는 배포 지원의 도움이 필요하면 진단 정보 복사를 클릭하여 페이지에서 생성된 정보를 제공할 수 있습니다.

5단계: 과거 데이터 쿼리

LogBamboo 페이지에서 쿼리

  1. 왼쪽 로그 인덱스에서 쿼리할 인덱스를 선택합니다.
  2. 먼저 시간대를 확인한 다음 LogBamboo 데이터 수신 시간을 포함하는 쿼리 범위를 설정합니다. 최근 15분, 최근 1시간, 최근 24시간 등의 빠른 범위를 선택하거나 시작 및 종료 시간을 수동으로 설정할 수도 있습니다.
  3. 검색창에 error와 같은 키워드를 입력하고 오른쪽의 검색을 클릭합니다.
  4. 아래 결과 영역에서 반환된 로그 내용을 확인하여 예상 레코드가 포함되어 있는지 점검합니다. 결과가 많으면 페이지 안내에 따라 페이지를 넘기거나 시간 범위와 쿼리 조건을 좁힙니다.

스크린샷의 시간대는 UTC입니다. 시작 및 종료 시간을 입력할 때 사용하는 시간이 페이지에서 선택한 시간대와 일치하는지 확인하세요. 과거 로그를 보충 전송하는 경우에도 이번 수신 시간 기준으로 쿼리하며, 로그의 원래 발생 시간은 내용에 그대로 유지됩니다.

LogBamboo 로그 쿼리 페이지에서는 다음 쿼리 예시를 제공합니다.

쿼리 내용 용도
error 키워드 error로 로그 검색
timeout OR 失败 키워드 중 하나라도 일치하는 로그 검색
connection AND reset 두 키워드가 모두 일치하는 로그 검색

더 많은 쿼리 작성 방법이 필요하면 페이지 상단의 쿼리 가이드를 클릭할 수 있습니다.

일치하는 레코드 수를 정확히 집계해야 할 때는 검색 버튼 아래의 정확한 카운트 스위치를 필요에 따라 사용할 수 있습니다. 자주 사용하는 쿼리 조건은 현재 쿼리 즐겨찾기로 저장한 뒤 이후 즐겨찾기 쿼리에서 사용할 수 있으며, 이전에 실행한 쿼리는 쿼리 기록에서 확인할 수 있습니다.

LogBamboo 페이지에서 쿼리할 때는 해당 인덱스를 조회할 권한이 있는 계정으로 로그인하면 됩니다.

플랫폼에서 전송된 데이터 쿼리

  1. 관리 > 데이터 전송의 데이터 조회 페이지로 이동합니다.
  2. 해당 전송 규칙을 선택하고 LogBamboo 수신 시간 기준으로 쿼리 범위를 설정합니다.
  3. 키워드를 입력하여 쿼리하고 반환 결과를 확인합니다.
  4. 페이지에서 후속 결과가 있다고 안내하면 후속 데이터를 계속 가져옵니다.

플랫폼에서 다시 조회하려면 해당 전송 규칙에 쿼리 Token을 입력해야 하며, 현재 워크스페이스 구성원에게 해당 규칙의 데이터 조회 권한이 있어야 합니다. 자세한 설명은 전송 결과 검증을 참조하세요.

플랫폼 연동을 검증할 때는 대상 인덱스에서 전송 규칙을 통해 전송된 비즈니스 레코드를 조회할 수 있는지 확인한 다음, 플랫폼의 해당 규칙에서 동일한 레코드를 점검하세요. 온보딩의 테스트 로그는 LogBamboo 서비스 자체 검증에 사용됩니다.

이후 관리

쓰기 Token 교체

관리자는 설정 > 쓰기 Token으로 이동합니다. 페이지에는 구성 출처와 최근 수정 정보가 표시되며, 현재 쓰기 Token은 확인할 수 없습니다. 기존 토큰이 필요하면 배포 관리자에게 요청하여 받으세요.

이 쓰기 Token은 현재 배포의 모든 인덱스에 적용됩니다. 교체가 필요하면 다음 단계에 따라 작업합니다.

  1. 새 쓰기 Token에 페이지 요구 사항에 맞는 새 값을 입력하거나 임의 Token 생성을 클릭합니다.
  2. 필요에 따라 표시 또는 복사를 사용하여 새 값을 확인하고 안전하게 보관합니다.
  3. 해당 토큰을 사용하는 모든 쓰기 엔드포인트를 동시에 업데이트할 준비가 되었는지 확인하고 새 토큰을 저장했으며 모든 쓰기 엔드포인트를 업데이트할 준비가 되었습니다를 선택합니다.
  4. 저장 및 교체를 클릭합니다.
  5. 즉시 플랫폼 전송 규칙 또는 수집 엔드포인트의 쓰기 Token을 업데이트합니다. 최신 구성 상태를 확인해야 할 때는 상태 다시 로드를 클릭합니다.

저장 후 새 토큰이 즉시 적용되고 이전 토큰은 무효화됩니다. 교체 전에 모든 관련 쓰기 엔드포인트의 업데이트를 준비하여 자격 증명 만료가 이후 쓰기에 영향을 주지 않도록 하세요. 새 값은 직접 보관해야 하며, 이후에는 현재 토큰에서 확인할 수 없습니다.

이 페이지에서는 쓰기 Token을 관리합니다. 플랫폼에서 다시 조회할 때 사용하는 쿼리 Token은 별도로 준비해야 하며, 자세한 내용은 연결 정보 준비를 참조하세요.

계정 및 권한

다른 구성원이 데이터를 조회하도록 하려면 관리자가 계정을 할당하고 액세스 가능한 인덱스를 설정합니다. 구성원이 필요한 인덱스를 볼 수 없으면 관리자에게 구성 및 권한 범위를 확인하도록 요청하세요.

용량 및 라이선스

관리자는 설정 > 라이선스에서 운영 모드, 용량, 만료 시간 및 클러스터 ID를 확인할 수 있습니다. 더 많은 용량이 필요하거나 만료 안내를 받은 경우 영업 담당자에게 문의하고 용량 및 상용 라이선스에 따라 구매, 활성화 또는 갱신을 완료하세요.

자주 묻는 질문

문제 처리 방법
로그인 실패 관리자에게 계정, 비밀번호 및 계정 사용 가능 여부 확인 요청
대상 인덱스를 찾을 수 없음 관리자에게 인덱스가 구성되어 적용되었는지, 현재 계정에 조회 권한이 있는지 확인 요청
온보딩에서 일시적으로 쿼리할 수 없다고 안내 처리 완료 후 쿼리 가능 여부 검사를 다시 클릭하며, 테스트 로그를 반복 전송할 필요는 없음
연동 후 데이터를 찾을 수 없음 데이터가 대상 인덱스에 도달했는지 확인하고 수신 시간 기준으로 쿼리하며 처리 완료를 기다립니다. 동시에 시간대, 키워드 및 데이터 보존 범위를 점검
쓰기 Token 교체 후 쓰기 실패 발생 모든 관련 전송 규칙 또는 수집 엔드포인트가 새 Token으로 업데이트되었는지 확인합니다. 이전 Token은 저장 및 교체 후 무효화됩니다
LogBamboo에서는 조회되지만 플랫폼에서는 조회되지 않음 전송 규칙의 대상 인덱스, 쿼리 Token 및 데이터 조회 권한을 점검하고 동일한 수신 시간 범위를 선택했는지 확인

문서 평가

이 페이지가 도움이 되었나요?