콘텐츠로 이동

LogBamboo로 데이터 전송

LogBamboo는 로컬 또는 자체 클라우드 환경에서 데이터를 보관할 수 있습니다. 로그, 메트릭, 트레이스 등의 데이터를 LogBamboo로 전송하면 콘솔에서 기록을 조회하여 문제 해결과 비즈니스 리뷰에 활용할 수 있습니다.

사전 조건

설정을 시작하기 전에 다음 사항을 확인합니다.

  • LogBamboo 배포를 완료하고 데이터를 수신할 대상 인덱스를 생성했는지 확인합니다.
  • 서비스 주소와 쓰기 Token을 확보했는지 확인합니다. 콘솔에서 과거 데이터를 조회하려면 별도의 조회 Token도 확보해야 합니다.
  • 배포 관리자로부터 전송 서비스가 LogBamboo에 접근할 수 있음을 확인받았는지 확인합니다.
  • 규칙 이름과 필터 조건 설정을 완료했는지 확인합니다.

서비스 주소, Token 및 필요한 인증서는 LogBamboo 관리자에게 문의하여 발급받습니다. 자세한 내용은 연결 정보 준비를 참조하십시오. 배포 및 연동 방안에 대한 자세한 내용은 영업 담당자에게 문의하십시오.

설정 시작

1단계: 전송 대상 선택

전송 대상 선택에서 LogBamboo를 선택합니다.

선택 후 서비스 연결 정보를 입력하면 됩니다. LogBamboo의 스토리지 설정은 해당 관리자가 유지 관리하므로 전송 규칙에 버킷을 입력하거나 스토리지 형식을 선택할 필요가 없습니다.

2단계: 연결 정보 입력

설정 항목 필수 여부 설명
서비스 주소 예 LogBamboo 서비스 주소입니다(예: https://logbamboo.example.com:8080). 루트 주소만 입력하고 쓰기 엔드포인트 경로는 추가하지 않습니다.
대상 인덱스 예 LogBamboo에 이미 존재하는 인덱스 이름을 입력합니다. 길이는 1–128자이며 영문자, 숫자 및 ., _, -를 사용할 수 있습니다. . 또는 ..만으로 구성할 수 없습니다.
쓰기 Token 예 LogBamboo에 데이터를 쓰는 데 사용합니다. 저장 후에는 평문으로 표시되지 않습니다.
조회 Token 조회 시 필수 콘솔에서 전송된 데이터를 조회하는 데 사용합니다. 전송만 수행하는 경우에는 입력하지 않아도 되며, 쓰기 Token과 같을 수 없습니다.
신뢰 인증서 아니요 배포 관리자가 신뢰 인증서 설정을 요구하는 경우 HTTPS 인증서 설정을 펼치고 관리자가 제공한 PEM 형식 인증서 내용을 입력합니다.

LogBamboo 관리자가 제공한 Token을 사용하고, 워크스페이스 Token이나 로그인 비밀번호를 입력하지 마십시오.

3단계: 연결 테스트

연결 테스트를 클릭합니다. 검사에 실패하면 페이지 안내에 따라 서비스 주소, Token 및 대상 인덱스를 확인합니다.

검사를 통과한 후 규칙 저장을 계속 진행하고, 전송 결과 확인에 따라 데이터가 정상적으로 전송되는지 확인합니다.

4단계: 데이터 조회 권한 설정 및 저장

콘솔에서 데이터를 조회해야 하는 경우 조회 Token을 입력하고, 데이터 조회 권한에 따라 워크스페이스 내 조회 범위를 설정합니다.

  • 제한 없음: 워크스페이스의 모든 멤버가 해당 규칙의 전송 데이터를 조회할 수 있습니다.
  • 사용자 지정: 지정된 역할의 멤버만 조회할 수 있습니다.

설정을 완료한 후 규칙을 저장하고 규칙이 활성화되었는지 확인합니다. 이후 조건에 맞는 데이터는 규칙에 따라 전송됩니다.

전송 결과 확인

  1. 전송 조건에 맞는 데이터가 있으며 규칙이 활성화되어 있는지 확인합니다.
  2. LogBamboo에서 데이터 처리가 완료될 때까지 기다립니다.
  3. 데이터 전송 > 데이터 조회로 이동하여 해당 규칙을 선택합니다.
  4. LogBamboo가 데이터를 수신한 시간을 기준으로 조회 범위를 선택하고 키워드를 입력하여 조회합니다.
  5. 결과에 예상 데이터가 포함되어 있는지 확인합니다. 조회되지 않으면 아래 설명과 자주 묻는 질문을 참고하여 문제를 해결합니다.

데이터 조회 가능 시점

데이터를 전송한 후 LogBamboo의 처리가 완료되어야 조회할 수 있습니다. 기본 프로덕션 구성에서는 데이터 양이 적은 경우 약 1시간 이상 기다려야 할 수 있으며, 구체적인 시간은 실제 배포 환경의 처리 주기에 따릅니다.

방금 전송한 데이터를 일시적으로 조회할 수 없을 때는 먼저 조회 규칙과 시간 범위를 확인한 후 잠시 후 다시 시도하십시오. 일시적으로 조회되지 않는다는 이유로 동일한 데이터를 반복 전송하지 마십시오.

조회 시간 선택 기준

원본 데이터의 발생 시간이 아니라 LogBamboo가 데이터를 수신한 시간을 기준으로 조회합니다.

예를 들어 어제 생성된 데이터를 오늘 LogBamboo로 전송한 경우 오늘의 수신 시간을 선택하여 조회해야 합니다. 원래 발생 시간은 데이터 내용에서 계속 확인할 수 있습니다.

페이지에서 계속 조회할 수 있다고 안내하면 이후 결과를 계속 가져옵니다.

용량 및 구매

커뮤니티 버전은 기본적으로 5TB 데이터 보관 용량을 제공하며, 비압축 콘텐츠 기준으로 계산합니다. 용량 한도에 도달하면 오래된 데이터가 자동으로 정리됩니다. 사용 전에 관리자와 스토리지 용량 및 보존 정책을 확인하십시오.

더 많은 용량이 필요한 경우 영업 담당자에게 문의하여 상용 라이선스 및 구매 방법을 확인하십시오. 라이선스 비용 설명은 데이터 전송 FAQ를 참조하십시오.

자주 묻는 질문

현상 확인 사항
서비스 주소에 연결할 수 없음 서비스 주소와 포트를 확인하고, 배포 관리자에게 전송 서비스가 LogBamboo에 접근할 수 있는지 확인합니다.
인증 실패 Token이 올바르게 입력되었는지 확인합니다. 관리자가 Token을 교체한 경우 전송 규칙도 함께 수정합니다.
대상 인덱스를 사용할 수 없음 관리자에게 인덱스가 생성되었고 현재 Token이 해당 인덱스에 접근할 권한이 있는지 확인합니다.
인증서 검증 실패 관리자에게 HTTPS 인증서를 확인하도록 요청합니다. 신뢰 인증서를 설정해야 하는 경우 관리자가 제공한 인증서 내용을 입력합니다.
연결 테스트는 통과했지만 데이터를 조회할 수 없음 규칙이 활성화되어 있고, 조건에 맞는 데이터가 있으며, 조회 Token이 입력되었는지 확인하고 수신 시간 기준으로 조회합니다. 방금 전송한 데이터는 잠시 후 다시 시도할 수 있습니다.
조회 시 복구 대기 안내가 표시됨 안내에 따라 데이터 복구가 완료될 때까지 기다린 후 다시 조회합니다.
용량 부족 또는 라이선스 이상 관리자에게 사용 가능한 용량, 보존 정책 및 라이선스 상태를 확인하도록 요청합니다.

규칙 수정 및 비활성화

  • 관리자가 Token을 교체한 후에는 전송 규칙의 해당 Token도 함께 업데이트해야 합니다.
  • 규칙 이름이나 전송 대상을 수정해도 수정 전 데이터가 자동으로 조회되지는 않습니다. 수정 전에 기존 데이터의 조회 방법을 확인하십시오.
  • 규칙을 비활성화하거나 삭제해도 LogBamboo에 이미 저장된 과거 데이터는 정리되지 않습니다. 데이터 보존 및 정리는 LogBamboo 관리자가 관리합니다.

문서 평가

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