사용하기 전에

Q. CLA(Cloud Log Analytics)는 무엇인가요?

  • 네이버 클라우드 플랫폼이 제공하는 서버를 비롯한 다양한 상품을 사용하면서 발생하는 로그 이력을 저장하고 분석할 수 있는 서비스입니다.
  • 다양한 종류의 로그 파일을 수집할 수 있으며, 간단한 스크립트 실행만으로 필요한 프로그램의 다운로드, 설치, 설정, 자동 시작까지 편리하게 사용할 수 있습니다.
  • 검색 기능을 통해 데이터를 손쉽게 조회할 수 있고 필요한 정보를 간편하게 다운로드할 수 있어 효과적인 로그 관리가 가능합니다.

Q. 어떤 데이터를 수집할 수 있나요?

  • CLA는 텍스트 형식으로 생성되는 모든 종류의 로그 데이터 파일을 수집할 수 있습니다.
  • 많이 사용하는 로그는 템플릿으로 제공해 콘솔에서 선택하는 것만으로 수집 대상 로그를 설정할 수 있습니다.
  • 제공되는 템플릿의 종류는 다음과 같습니다.
    • NCP Server syslog
    • Apache 로그(access log, Apache error log)
    • MySQL 설치형 상품의 로그(error log, slow log)
    • Microsoft SQL Server 설치형 상품의 error log
    • Tomcat 로그(catalina log)
    • Windows 서버의 event log
    • Windows 서버의 각종 text 형식의 로그
    • Cloud DB for MySQL 로그
    • Cloud DB for MSSQL 로그
    • 베어메탈 서버 로그
  • 템플릿으로 제공되지 않는 로그도 custom log 기능으로 직접 대상 로그를 지정해서 수집할 수 있습니다.

Q. 저장된 데이터는 어떻게 관리되나요?

  • 고객의 데이터는 논리적으로 분리된 개별 저장소에 2개 이상의 복제본으로 분산 저장됩니다.
  • 데이터가 삭제되는 경우는 다음과 같습니다.
    • 보관 기간이 지난 데이터는 자동으로 영구히 삭제됩니다.
    • 데이터의 용량이 고객이 가입하신 상품의 저장 용량을 초과하면 과거의 데이터부터 순차적으로 삭제됩니다. 데이터 삭제 시에는 새로운 데이터가 저장될 수 있도록 최대 30%의 데이터가 삭제될 수 있습니다.
    • CLA 상품 이용을 해지하면 해지와 동시에 데이터 전체가 삭제됩니다. 단, 다른 연계상품을 사용하고 있을 경우에는 연계상품의 해지 또는 log 연동 기능을 해지한 이후에 CLA 상품을 해지할 수 있습니다.

Q. 저장된 로그 전체를 다운로드할 수 있나요?

  • 전체 데이터에 대한 다운로드는 Object Storage 상품으로 Export 기능을 제공합니다.
  • CLA에 저장된 데이터를 Object Storage로 Export를 실행하기 위해서는 Object Storage 사용 신청 및 버켓이 생성되어 있어야 합니다.
  • Object Storage로 Export된 데이터는 JSON 포맷으로 저장됩니다.
  • Object Storage에 저장되는 데이터가 1GB 이상일 경우 같은 폴더에 1GB 단위로 나뉘어 저장됩니다.
  • 데이터 저장 속도는 1GB당 10분 정도의 시간이 소요되며, 상황에 따라 다를 수 있습니다.
  • 향후 CSV 포맷과 압축 저장, 일자별 데이터 저장 기능 등을 제공할 예정입니다.

Q. Excel 파일로 다운로드할 수 있나요?

  • 검색 결과를 Excel 파일로 다운로드할 수 있습니다.
  • Excel Download는 전체 데이터가 아니라 검색 결과 화면에 보이는 내용만 다운로드할 수 있습니다.

Q. 저장 용량이 부족합니다.

  • 2017년 11월부터는 유료 서비스로 전환되어, 최대 100GB까지 저장할 수 있습니다.
  • 100GB 용량을 넘어갔을 경우 추가 저장 용량 확보를 위해 최대 30% 정도의 데이터가 삭제될 수 있습니다.
  • 저장 용량과 저장 기간을 더 늘리길 원하시면 고객지원으로 문의해 주시기 바랍니다.
  • 과거 데이터를 보관하려면 "Object Storage로 보내기" 기능을 이용하여 과거 데이터를 Object Storage로 백업할 수 있습니다.

Q. 보관 기간을 늘리고 싶어요.

  • CLA 서비스는 최대 30일 동안 데이터가 보관되며, 검색 및 대시보드에서 확인할 수 있습니다.
  • 30일이 지난 데이터는 과거 데이터부터 순차적으로 삭제됩니다.
  • 30일이 지나지 않았더라도 저장된 데이터가 100GB를 초과하면 최대 30%까지 과거 데이터부터 매일 삭제될 수 있습니다.

Q. 이용 해지가 되지 않습니다.

  • CLA 상품은 네이버 클라우드 플랫폼에서 사용하는 여러 플랫폼의 로그를 통합 저장/검색할 수 있는 상품입니다.
  • Cloud DB for MySQL, Cloud DB for MSSQL과 같은 Paas 상품에서 CLA의 로그 관리(저장/검색) 기능을 사용하는 경우에는 CLA 상품이 해지되지 않습니다.
  • 해당 상품을 먼저 해지하거나 반납한 이후에 CLA 상품을 이용 해지할 수 있습니다.

Q. 테스트로 사용해 보고 싶어요.

  • CLA에 저장된 데이터는 월 평균 1GB까지는 무료로 사용하실 수 있으며, 월 평균 저장 용량이 1GB를 초과하여 사용 시 초과분에 대하여 과금됩니다.
  • 월 평균 1GB를 초과하지 않는 경우에는 과금이 되지 않습니다.
  • 현재 저장된 전체 용량은 CLA > Dashboard에서 확인할 수 있으며, 월 평균 사용량은 ncloud.com의 마이페이지에서 확인할 수 있습니다.

사용 방법

CLA 이용 신청하기

CLA 상품은 고객의 NCP에서 발생하는 다양한 로그를 수집하고, 이를 확인/분석할 수 있도록 제공되는 플랫폼 서비스입니다. CLA에서는 서버, 웹, 앱, 보안로그, event log, db log, Paas 상품 등의 로그를 수집하고 조회 및 분석할 수 있습니다. CLA 서비스를 이용하기 위해서는 CLA 서비스 이용을 신청해야 합니다.

① 콘솔에서 All Products를 선택합니다.
② 우측 하단의 Analytics > Cloud Log Analytics를 선택합니다.

CLA 서비스로 이동합니다. 서비스 이용이 신청되어 있지 않을 경우에는 서비스 이용 신청 후 서비스를 사용할 수 있습니다.

① CLA 서비스가 이용 신청되어 있지 않으면 서비스 이용 신청 화면으로 이동합니다.
② 하단의 이용 신청 버튼을 클릭하면 이용 신청이 완료됩니다.

① 이용 신청이 완료되었습니다.

CLA 로그 수집 설정

데이터 수집에 필요한 로그 데이터를 웹 화면에서 손쉽게 설정할 수 있습니다. 기본으로 제공되는 다양한 템플릿을 사용해 수집할 로그 데이터를 바로 선택할 수 있습니다.

CLA 로그 수집을 설정하려면 로그를 수집할 서버를 선택하고 대상 로그 타입과 경로를 선택합니다. 서버에 접속하여 로그 수집 agent를 설치하면 로그 수집 설정이 완료됩니다.

1. 수집 대상 서버 선택

CLA에서 Management 메뉴를 선택하면 사용 중인 서버의 목록을 확인할 수 있습니다.

① 수집 설정을 위해서 왼쪽 메뉴에서 Management를 선택합니다.
② Management 메뉴를 선택하면 보유하고 있는 서버 리스트가 기본 화면으로 표시됩니다. 이 화면에서 다음 단계를 따라 서버를 선택하여 로그 수집을 설정할 수 있습니다.
③ Cloud DB for MySQL을 사용하는 고객의 경우에는 Server 옆에 CDB-MySQL 탭이 나타나며, 보유하고 있는 CDB-MySQL 리스트를 같이 확인할 수 있습니다.
④ Cloud DB for MSSQL을 사용하는 고객의 경우에는 Server 옆에 CDB-MSSQL 탭이 나타나며, 보유하고 있는 CDB-MSSQL 리스트를 같이 확인할 수 있습니다.
⑤ 베어메탈 서버를 사용할 경우에는 Bare Metal Server 탭에서 일반 서버와 동일한 방법으로 서버 리스트 확인 및 로그 수집 설정을 할 수 있습니다.

사용 중인 서버 중 로그 수집을 원하는 서버를 선택하고 수집 설정을 클릭합니다.

① 사용 중인 서버의 목록에서 로그를 수집할 대상 서버를 선택합니다.
② 대상 서버를 선택하면 수집 설정이 활성화됩니다. 수집 설정을 클릭하면 수집할 로그를 지정하는 화면으로 변경됩니다.

2. 수집할 로그 지정

로그 수집 설정 부분에는 일반적으로 많이 사용하는 로그에 대한 템플릿을 제공하므로 템플릿을 선택해서 사용할 수 있습니다. 직접 로그 타입과 경로, 파일 이름을 입력할 수도 있습니다.

  • 로그 템플릿 사용 설정하기

    ① 로그 설정 화면에서 수집 대상 로그 템플릿 목록을 확인합니다.
    ② 수집할 로그 템플릿을 선택합니다. 로그를 선택하면 자동으로 등록됩니다.
    ③ 선택한 로그가 현재 설정된 수집 로그 목록에 추가됩니다.
    적용을 클릭합니다.

  • Custom Log 설정하기: 템플릿으로 제공되지 않는 로그를 수집 설정하는 방법입니다.

    ① 템플릿에서 Custom Log를 선택합니다.
    ② 로그 타입을 입력합니다. 여기에 입력한 로그 타입으로 검색이나 대시보드에 데이터가 표시됩니다.
    ③ 로그 파일의 경로와 파일명을 입력합니다.
    ④ 선택한 로그를 추가합니다.
    ⑤ 설정을 완료합니다.

3. 로그 수집 agent 설치 명령어 복사

설정이 완료되면 로그 수집 agent 설치 방법이 안내됩니다. 로그 수집 agent 설치 명령어에 설치키(install key)가 포함되어 제공되며 이 값이 정확해야 정상적으로 설치할 수 있습니다.

설정을 완료하면 팝업 창에 OS 종류별 로그 수집 agent 설치 방법이 표시됩니다.

① OS가 Linux인 경우 Linux 옆의 클립보드에 복사하기를 클릭하여 로그 수집 agent 설치 명령어를 복사합니다.
② OS가 Windows 2008인 경우 Windows 2008 옆의 클립보드에 복사하기를 클릭하여 로그 수집 agent 설치 명령어를 복사합니다.
③ OS가 Windows 2012인 경우 Windows 2012 옆의 클립보드에 복사하기를 클릭하여 로그 수집 agent 설치 명령어를 복사합니다.
④ 팝업 창을 닫습니다.

4. 서버에 로그 수집 agent 설치

앞 단계에서 복사한 로그 수집 agent 설치 명령어를 실행하면 로그 수집 agent 다운로드, 설치, 환경 설정, agent 실행, 데이터 수집이 자동으로 시작됩니다.

설치 시에는 root 권한이 필요하므로 설치할 서버에 접속한 후 root 계정이나 sudo 권한이 있는 계정으로 작업해야 합니다.

로그 수집 agent 설치 명령어의 설치키가 맞지 않으면 데이터가 수집되지 않습니다.

Linux(베어메탈 서버)에서 설치 및 확인하기

① 설정 완료 시 확인한 설치 명령어를 실행하면 설정한 정보 확인 후 agent 다운로드 및 설치, 설정 파일 다운로드, agent 실행이 진행됩니다.
② 설치가 끝나면 agent가 실행됩니다. 실행된 agent의 프로세스를 확인할 수 있습니다.
③ 로그가 수집되는지 테스트합니다. 이 예는 syslog에 로그를 남기는 테스트입니다.

Windows에서 설치 및 확인하기

① 설정 완료 시 확인한 설치 명령어를 실행하면 설정한 정보 확인 후 agent 다운로드 및 설치, 설정 파일 다운로드, agent 실행이 진행됩니다.
② 설치가 끝나면 agent가 실행됩니다. 실행된 agent의 프로세스를 확인할 수 있습니다.

Winidows Event 로그는 agent를 설치 및 실행하면서 발생한 로그를 대시보드나 검색을 통해 확인할 수 있습니다.

CLA 데이터 확인하기

CLA 데이터 보관

CLA 서비스는 최대 100GB의 데이터를 최대 1개월 간 보관하여, 다양한 방법으로 저장된 데이터를 검색할 수 있습니다.

1개월이 지난 데이터는 순차적으로 영구히 삭제되며, 100GB 용량을 초과하면 과거 데이터부터 순차적으로 영구히 삭제됩니다. 삭제된 데이터는 복구할 수 없습니다.

CLA 대시 보드

수집된 데이터에 대한 다양한 현황을 대시보드에서 실시간으로 확인할 수 있습니다.

① 전체 Log Count: 서버에 저장된 전체 데이터 수를 보여 줍니다.
② 일별 Log Count: 일별 데이터 발생량을 그래프로 보여 줍니다.
③ 최근 Log 발생량: 최근 1분 평균 데이터 발생량을 보여 줍니다.
④ 상품 정보: 현재 사용하고 있는 상품 정보와 사용 가능한 저장 공간을 보여 줍니다.
⑤ 저장 용량(MB): 전체 사용 가능 저장 공간 중 현재 사용하고 있는 저장 공간을 보여 줍니다.
⑥ Type별 사용 용량: 저장된 전체 데이터 중에서 타입별 데이터 사용 비율을 퍼센트 단위로 보여 줍니다.
⑦ Type별 Log 발생 현황: 데이터 종류별 발생 현황을 비교할 수 있게 보여 줍니다.
⑧ Server별 Log 발생 현황: 데이터를 수집하는 서버별 로그의 전체 수를 보여 줍니다.

CLA 데이터 검색

다양한 필터와 키워드를 조합해 원하는 시점의 원하는 데이터를 조회할 수 있습니다.

① 검색하고자 하는 데이터의 종류를 선택합니다. 기본값은 전체입니다.
② 검색하고자 하는 데이터의 조회 기간을 선택하거나 직접 입력해 원하는 시간대를 선택할 수 있습니다. 기본값은 최근 1시간입니다.
Log 발생시간에서 직접 입력을 선택한 경우 검색 시작 일자를 입력합니다.
Log 발생시간에서 직접 입력을 선택한 경우 검색 종료 일자를 입력합니다.
⑤ 로그를 키워드로 검색하는 경우 검색하고자 하는 문자열을 입력합니다.
⑥ 로그를 키워드로 검색하는 경우 검색하고자 하는 문자열을 입력한 후 클릭합니다.
⑦ 검색 필터를 설정한 후에는 적용을 클릭하여 검색 필터를 적용합니다.
⑧ 검색 결과 데이터를 시간대별로 보여 줍니다.
⑨ 검색 결과 데이터의 원본 메시지를 화면에 보여 줍니다. 한 페이지에 10개의 데이터가 표시됩니다.
⑩ 검색 결과를 페이지를 넘겨가면서 확인할 수 있습니다.
⑪ 검색 결과를 Excel 파일로 다운로드할 수 있습니다. 화면에 보이는 데이터만 다운로드할 수 있으며, 전체 데이터에 대한 다운로드는 향후 지원할 예정입니다.
⑫ 검색 결과 페이지 크기를 수정할 수 있습니다. 기본 20개씩 출력되며 20, 30, 50, 100개 단위로 출력할 수 있습니다.
⑬ 검색 결과 원하는 페이지로 직접 이동이 가능합니다.
⑭ 검색 결과 막대그래프의 막대를 선택하면 선택된 시간으로 다시 검색됩니다.
⑮ 검색 결과 데이터 전체를 Object Storage로 Export합니다.

Object Storage 사용 준비하기

CLA에서 Object Storage로 파일을 보내기 위해서는 인증키를 생성해야 합니다. 인증키는 마이페이지 > 인증키 관리 메뉴에서 생성할 수 있습니다.

① ncloud.com의 마이페이지 > 인증키 관리 메뉴를 선택합니다.
신규 API 인증키 생성 버튼을 클릭합니다.
③ 인증키 생성이 완료되었습니다.
④ 생성된 인증키를 확인합니다.

CLA 데이터 작업 상태

CLA에서 수집된 데이터를 사용/관리하는 작업을 확일할 수 있습니다. 현재는 Object Storage로 보내기 결과에 대한 상태, 결과 등을 확인할 수 있습니다. Object Storage에 저장된 데이터는 Object Storage에서 다운로드할 수 있습니다.

① 메뉴에서 ExportLog를 클릭합니다.

② Object Storage에 Export된 리스트를 확인합니다.

  • 설정시간: Object Storage로 내보내기한 시작시간
  • 유형: 사용자가 직접 내보내기를 수행한 경우 수동으로 표시되며, 자동 설정으로 보내진 경우 자동으로 표시됩니다.
  • 리전: 내보내기를 수행한 리전
  • 대상 Bucket: 대상 버켓과 저장된 경로 표시
  • 폴더이름: Object Storage에 생성된 디렉토리명
  • Export 로그 종류: 검색 시 지정한 로그 타입
  • 진행률: Upload 진행률
  • 상태: 작업에 대한 상태(complete, processing, fail)
  • 설명: Object Storage로 Upload 실패할 경우에 대한 사유

③ 자동 내보내기 설정합니다.

로그 자동 내보내기 설정

① 자동 설정 이력

  • 수행시간: 자동 내보내기를 설정한 수행 시간입니다.
  • 설정/해제: 로그 자동 내보내기 설정 상태를 나타내며, 테이블 제일 상단의 값인 최신의 설정 기준으로 반영이 됩니다.
  • 리전: 자동 내보내기로 설정한 리전 정보
  • 대상 Bucket: 자동 내보내기로 설정한 Bucket 정보
  • Export 로그 종류: 자동 내보내기로 설정한 로그 정보

② 자동 내보내기 설정
③ Object Storage의 리전, Bucket, 로그 정보등의 설정 정보 입력합니다.
④ 설정 정보 저장하면 다음날부터 새벽에 전날 하루치 데이터가 백업됩니다.

로그 자동 내보내기 해제

① 자동 내보내기 해제
② 설정 해제 신청
③ 확인 버튼을 눌러 팝업을 닫습니다.

로그 수집 해제하기

로그 수집을 해제하려면 CLA의 Management 메뉴에서 로그 수집을 해제하려는 서버를 선택하고 수집 해제를 클릭합니다. 로그 수집을 해제한 후 팝업 창에서 안내하는 대로 로그 수집 agent 삭제 명령어를 실행하여 서버에서 로그 수집 agent를 삭제합니다.

서버에서 로그 수집 agent를 삭제하지 않으면 CLA에 데이터가 저장되지는 않지만 데이터가 CLA에 계속 전송되어 불필요한 내부 데이터 트래픽이 발생합니다.

① 데이터 수집을 중단하고자 하는 서버를 선택합니다.
② 선택한 서버에서 데이터 수집을 중단하기 위해 수집 해제를 클릭합니다.

① 수집 중단 대상 서버에 설정된 수집 설정 정보를 확인합니다.
② 수집 중단 설정을 완료하기 위해 적용을 클릭합니다.

① 서버에 접속해서 수집 중단을 위해 로그 수집 agent를 삭제하는 명령어를 복사합니다. 클립보드에 복사하기를 클릭하면 명령어가 클립보드에 복사됩니다.
② 여러 OS를 선택하여 수집 해제할 경우에는 OS 종류별로 command에 차이가 있으므로 잘 확인하고 사용해야 합니다.
③ Linux 서버와 베어메탈 서버는 수집설정/해제 command가 동일합니다.
닫기를 클릭하여 팝업 창을 닫습니다.

① 각 서버에 접속해서 위 단계에서 복사한 로그 수집 agent 삭제 명령어를 실행합니다.
② 명령어를 실행하면 설치된 agent가 정지되고 agent 및 설정 파일이 삭제됩니다.

CLA 상품 해지하기

상품을 해지하려면 콘솔의 CLOUD LOG ANALYTICS 메뉴에서 이용해지를 클릭합니다. 상품 해지와 동시에 기존에 저장된 데이터는 모두 삭제됩니다.

Cloud DB for MySQL 상품을 사용하고 있다면 CLA 데이터가 Cloud DB for MySQL Log Viewer 기능의 데이터 소스로 사용되므로 CLA 상품을 해지할 경우에는 Cloud DB for MySQL 상품에서 로그를 수집/조회할 수 없습니다.

CLA 상품 해지 전에 먼저 다른 상품을 통한 로그 수집이 모두 중단되어야 CLA 상품을 해지할 수 있습니다.
수집 해제 후 서버에서 로그 수집 agent 삭제 명령어를 실행하지 않으면 불필요한 내부 트래픽이 발생합니다.

이용 해지를 클릭하시면 해지를 최종 확인하는 팝업 창이 나타납니다.
② 다른 상품에서 로그 수집을 사용 중인 경우에는 다른 상품을 사용하고 있어서 해지할 수 없다는 메시지가 나타나며 해지되지 않습니다.
③ 팝업 창에서 확인을 클릭하시면 CLA 상품이 이용 해지되며, 데이터도 즉시 삭제됩니다.

참고 사항

  • CLA 상품은 네이버 클라우드 플랫폼의 PaaS 상품의 로그를 함께 저장하고 통합된 뷰(view)를 제공합니다.
  • PaaS 상품에서 발생하는 로그는 가입한 CLA 상품의 보관 기간과 용량 내에서 수집하고 조회할 수 있습니다.
  • 2017년 11월 기준 Cloud DB for MySQL의 Slow Log, Error Log의 데이터를 같이 저장하며, Cloud DB for MySQL에서 조회하는 로그를 CLA에서 다른 로그와 통합하여 조회할 수 있습니다.
  • 2017년 12월 FileStorage로 데이터를 내보내는 기능이 추가되었습니다.
  • 2018년 2월 Cloud DB for MSSQL의 Event 로그와 베어메탈 서버 로그 수집 기능이 추가되었습니다.
  • 2018년 2월 싱가포르 리전 서버의 로그 수집이 가능 합니다. 리전 선택시 해당 리전의 서버만 확인 가능합니다.
  • 2018년 3월 Secure Zone Firewall, App Safer 서비스의 로그 수집 기능이 추가되었습니다.
  • 2018년 4월 Image Optimizer, Cloud Activity Tracer 서비스의 로그 수집 기능이 추가되었습니다.
  • 2018년 11월 FileStorage로 데이터를 내보내는 기능이 Fade-out되었습니다.
  • 2018년 11월 Object Storage로 데이터를 내보내는 기능이 추가되었습니다.

추가 제공 예정 기능

  • 이벤트 기반 알림: 로그에서 특별한 이벤트가 발생했거나 이벤트(로그 발생 수와 로그 크기)가 급증하는 등의 상황에 대한 다양한 알림을 제공할 예정입니다.
  • 다양한 형태의 대시보드: 로그 종류별 맞춤 대시보드, 실시간 Aggregation Chart, 확장 가능한 위젯 형태의 대시보드와 고객이 대시보드의 종류를 직접 설정할 수 있는 custom 대시보드 기능을 지속적으로 업그레이드해 제공할 예정입니다.
  • Sub Account, 로그인, 사용자 액션, 방화벽, CDN(Content Delivery Network, Load Balancer, Auto Scaling, 콘솔 등의 로그를 통합하여 저장하고 조회할 수 있는 기능을 제공할 예정입니다.

연관 정보

""에 대한 건이 검색되었습니다.

    ""에 대한 검색 결과가 없습니다.

    처리중...