Tracer 생성 및 관리

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

Tracer 생성 및 관리에서는 Tracer를 생성하거나 삭제하는 방법, Tracer의 설정을 변경하는 방법, Object Storage로 내보낸 파일을 확인하는 방법을 설명합니다.

Tracer 생성

Tracer를 생성하여 설정한 조건에 맞는 작업 내역(활동 기록)을 Object Storage에 내보낼 수 있습니다.

주의

Tracer를 생성하면 다음과 같이 Object Storage 서비스 이용 요금이 부과될 수 있습니다. 자세한 요금 내용은 Object Storage 요금을 참조해 주십시오.

  • Tracer 타입에 관계없이 내보낸 데이터 용량을 기준으로 데이터 저장 요금 발생
  • Custom 타입의 Tracer로 내보낸 데이터 건수를 기준으로 데이터 전송 요금 발생

Tracer를 생성하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
  2. Services > Management & Governance > Cloud Activity Tracer 메뉴를 차례대로 클릭해 주십시오.
  3. Tracers 메뉴를 클릭해 주십시오.
  4. [Tracer 생성] 버튼을 클릭해 주십시오.
  5. Tracer 생성 팝업 창에서 Tracer 정보를 입력한 후 [생성] 버튼을 클릭해 주십시오.
    • Tracer 타입은 Default와 Custom 중에서 선택할 수 있습니다.
      • Default 타입의 Tracer는 계정당 1개만 생성할 수 있으며, Tracer 이름과 상세 조건을 임의로 설정할 수 없습니다.
      • 선택한 타입은 생성 후 변경할 수 없습니다.
    • Tracer 타입을 Custom으로 선택한 경우, Tracer 이름을 입력한 후 Tracer 대상 이벤트 조건을 설정해 주십시오.
      • Tracer 이름은 영문자, 숫자, 특수 문자 '-', '_'를 허용하며, 50자 이내로 입력해 주십시오. 문자열의 시작과 끝은 특수 문자로 구성할 수 없습니다.
      • 다른 Tracer와 중복된 이름은 사용할 수 없습니다.
      • Cloud Activity Tracer 서비스에서 수집하는 전체 리소스 목록 중에서 선택한 조건에 해당하는 리소스만 Object Storage 서비스로 내보낼 수 있습니다.
      • 리전, 상품, 계정, 태그는 각각 AND 조건으로 필터되며, 리전, 상품, 계정, 태그 내에서의 다중 선택은 OR 조건으로 필터되어 내보내기를 수행합니다.
    • 대상 Bucket을 선택해 주십시오.
      • 리전: 내보내기할 대상 Object Storage의 리전 목록
      • 버킷명: 내보내기할 대상 Object Storage의 버킷 목록
      • 생성한 버킷이 없는 경우에는 [Bucket 생성하기] 버튼이 표시되며, 클릭하여 버킷을 생성할 수 있습니다.(버킷 생성 참조)
    • 전송 데이터 형식은 JSON과 CSV 중 선택할 수 있습니다.
      • CSV 선택 시, 셀 표현 가능 범위(32767)를 초과하는 데이터가 포함된 필드는 내보내지 않습니다. 범위와 관계없이 모든 데이터를 내보내려면 JSON으로 선택해 주십시오.
    • Object Storage 전송 시점을 확인한 후 체크 박스를 클릭하여 선택해 주십시오.
      • Tracer 생성 후 최초 내보내기는 내보내기 시점을 기준으로 1년 전부터 1일 전까지의 활동 기록을 대상으로 진행됩니다. 이후에는 하루 단위로 Tracer 조건에 해당하는 1일 전 활동 기록을 버킷에 전송합니다.
      • <예시> 2021-10-27에 Tracer 생성 시
        * 2021-10-27(생성 시): 2020-10-27 00:00 ~ 2021-10-27 00:00 까지의 데이터가 Object Storage로 전송됨
=> gov-tracer-test-daily-001-GMT+9-2020102700-2021102700-0.json
* 2021-10-28 00:xx(GMT+9): 2021-10-27 00:00 ~ 2021-10-28 00:00 까지의 데이터가 Object Storage로 전송됨
=> gov-tracer-test-daily-001-GMT+9-2021102700-2021102800-0.json
* 2021-10-29 00:xx(GMT+9): 2021-10-28 00:00 ~ 2021-10-29 00:00 까지의 데이터가 Object Storage로 전송됨
=> gov-tracer-test-daily-001-GMT+9-2021102800-2021102900-0.json
* ...
참고
  • 내보낸 데이터는 Object Storage 버킷의 cat-tracer 폴더에 'gov-tracer-{TracerName}-GMT+9-{from}-{to}-{Sequence}' 파일명으로 저장됩니다.
    • TracerName: 내보낸 Tracer 이름
    • from: 내보낸 데이터 중 가장 오래된 날짜
    • to: 내보낸 데이터 중 최신 날짜
    • Sequence: 파일 번호
      • 10,000건 단위로 파일이 분할되며, 0부터 시작
  • Object Storage 서비스의 버킷 삭제, 권한 변경 등의 이유로 내보내기를 수행할 수 없어 최종 실행 결과가 실패로 처리된 경우, 최종 실행 결과에 [재실행] 버튼이 표시됩니다. 상태를 정상화한 후 [재실행] 버튼을 클릭하면, 실패한 내보내기 작업을 다시 수행할 수 있습니다.

Object Storage 파일 확인

Object Storage로 내보낸 데이터 파일을 확인하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 내보낸 대상 버킷이 속한 리전을 선택해 주십시오.
  2. Services > Storage > Object Storage > Bucket Management 메뉴를 차례대로 클릭해 주십시오.
  3. 내보낸 대상 버킷을 클릭해 주십시오.
  4. cat-tracer 폴더를 더블 클릭해 주십시오.
    • 내보낸 데이터 파일을 확인할 수 있습니다.
    • 상세 정보를 확인하려면 상세 정보를 확인할 파일을 클릭해 주십시오.
    • 파일을 다운로드하면 내보낸 작업 내역을 자세히 확인할 수 있습니다. 파일을 다운로드하려면 다운로드할 파일을 선택한 후 [다운로드] 버튼을 클릭해 주십시오. Tracer 설정에 따라 JSON 또는 CSV 파일이 다운로드됩니다.

다운로드 파일 필드 상세 설명

Object Storage 버킷에서 다운로드한 파일의 필드에 대한 자세한 설명은 다음과 같습니다.

필드 설명 예시
action 리소스 변경 작업 이름 createServerInstance
actionResultType 리소스 변경 작업 수행 성공 여부 SUCCESS/FAIL
actionSubAccountNo 리소스 변경 작업을 발생시킨 Sub Account No(서브 계정 목록 조회 API의 SubAccountNo 필드와 동일한 값) 10000
actionUserType 요청 사용자 구분
  • Customer: 메인 계정
  • Sub: 서브 계정
 Customer/Sub
domainCode 도메인 코드(고정값) PUB
eventTime 리소스 변경 작업이 발생한 시각(epoch(unix) time) 1621584442893
historyId 리소스 변경 작업의 유일한 ID 60a74edddcee96b0dcba0e60
nrn 해당 리소스를 식별할 수 있는 유일한 Key 값 nrn:PUB:Server:KR:14---33:Server/1---4
productData 해당 리소스의 상세 정보 {"hostName":"test-server","asyncTaskUuid":"ae339ad9-6f46-...-537369cb1444","...":"..."}
productDataStatus 해당 리소스 변경 작업이 발생한 후 리소스의 상태 running
productName 해당 리소스의 서비스 코드 Server
regionCode 해당 리소스의 리전 코드 KR
regionName 해당 리소스의 리전명 Korea
resourceType 해당 리소스의 리소스 유형 Server
sourceIP 리소스 변경 작업을 발생시킨 클라이언트 IP 1.1.1.1
sourceSubType 리소스 변경 이벤트를 발생시킨 요청 상세 구분 AUTO_SCALING/INTERNAL
sourceType 리소스 변경 이벤트를 발생시킨 요청 구분 CONSOLE/API/SYSTEM/ADMIN
참고
  • CSV, JSON 파일은 동일한 필드로 구성되어 있습니다.
  • CSV 파일은 필드 순서가 달라질 수 있으므로, 프로그램으로 변환 시 JSON 파일 사용을 권장합니다.

Tracer 설정 변경

Tracer 설정을 변경하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Services > Management & Governance > Cloud Activity Tracer 메뉴를 차례대로 클릭해 주십시오.
  2. Tracers 메뉴를 클릭해 주십시오.
  3. 설정을 변경할 Tracer를 선택한 후 [설정 변경] 버튼을 클릭해 주십시오.
  4. Tracer 설정 변경 팝업 창에서 변경할 사항을 적용한 후 [수정] 버튼을 클릭해 주십시오.
    • 변경한 사항이 있는 경우에만 [수정] 버튼이 활성화됩니다.
    • Tracer 타입은 변경할 수 없습니다.
    • 각 항목에 관한 자세한 내용은 Tracer 생성을 참고해 주십시오.
참고

변경한 설정은 다음 내보내기를 수행하는 시점부터 적용됩니다.

Tracer 삭제

Tracer를 삭제하는 방법은 다음과 같습니다.

주의

Tracer를 삭제하더라도 Object Storage 버킷에 저장된 데이터는 자동으로 삭제되지 않으므로, Object Storage 서비스 이용 요금이 계속 부과될 수 있습니다. 필요하지 않은 데이터는 Object Storage 서비스에서 직접 삭제하여 요금 발생을 방지해 주십시오.
데이터 삭제 방법은 Object Storage 파일/폴더 관리를 참조해 주십시오.

  1. 네이버 클라우드 플랫폼 콘솔에서 Services > Management & Governance > Cloud Activity Tracer 메뉴를 차례대로 클릭해 주십시오.
  2. Tracers 메뉴를 클릭해 주십시오.
  3. 삭제할 Tracer를 선택한 후 [삭제] 버튼을 클릭해 주십시오.
  4. Tracer 삭제 팝업 창의 내용을 확인한 후 [삭제] 버튼을 클릭해 주십시오.