--- title: "Tracer 생성 및 관리" slug: "cloudactivitytracer-tracer" tags: ["Classic", "Cloud Activity Tracer", "VPC"] updated: 2026-05-21T09:01:48Z published: 2026-05-21T09:03:16Z canonical: "guide-gov.ncloud-docs.com/cloudactivitytracer-tracer" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Tracer 생성 및 관리 Classic/VPC 환경에서 이용 가능합니다. Tracer 생성 및 관리에서는 Tracer를 생성하거나 삭제하는 방법, Tracer의 설정을 변경하는 방법, Object Storage로 내보낸 파일을 확인하는 방법을 설명합니다. ## Tracer 생성 Tracer를 생성하여 설정한 조건에 맞는 작업 내역(활동 기록)을 Object Storage에 내보낼 수 있습니다. 주의 Tracer를 생성하면 다음과 같이 Object Storage 서비스 이용 요금이 부과될 수 있습니다. 자세한 요금 내용은 [Object Storage 요금](https://www.gov-ncloud.com/product/storage/objectStorage#pricing)을 참조해 주십시오. - Tracer 타입에 관계없이 내보낸 데이터 용량을 기준으로 데이터 저장 요금 발생 - **Custom** 타입의 Tracer로 내보낸 데이터 건수를 기준으로 데이터 전송 요금 발생 Tracer를 생성하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **Services** > **Management & Governance** > **Cloud Activity Tracer** 메뉴를 차례대로 클릭해 주십시오. 2. **Tracers** 메뉴를 클릭해 주십시오. 3. **[Tracer 생성]** 버튼을 클릭해 주십시오. 4. 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 생성하기]** 버튼이 표시되며, 클릭하여 버킷을 생성할 수 있습니다.([버킷 생성](/docs/objectstorage-use-bucket#%EB%B2%84%ED%82%B7%EC%83%9D%EC%84%B1) 참조) - **전송 데이터 형식**은 **JSON**과 **CSV** 중 선택할 수 있습니다. - **CSV** 선택 시, 셀 표현 가능 범위(32767)를 초과하는 데이터가 포함된 필드는 내보내지 않습니다. 범위와 관계없이 모든 데이터를 내보내려면 **JSON**으로 선택해 주십시오. - **태그관리**를 통해 Tracer를 분류할 수 있는 태그 조회/생성/수정/삭제가 가능합니다. - 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. **Menu** > **Services** > **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. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **Services** > **Management & Governance** > **Cloud Activity Tracer** 메뉴를 차례대로 클릭해 주십시오. 2. **Tracers** 메뉴를 클릭해 주십시오. 3. 설정을 변경할 Tracer를 선택한 후 **[설정 변경]** 버튼을 클릭해 주십시오. 4. Tracer 설정 변경 팝업 창에서 변경할 사항을 적용한 후 **[수정]** 버튼을 클릭해 주십시오. - 변경한 사항이 있는 경우에만 **[수정]** 버튼이 활성화됩니다. - **Tracer 타입**은 변경할 수 없습니다. - 각 항목에 관한 자세한 내용은 [Tracer 생성](/docs/cloudactivitytracer-tracer#Tracer%EC%83%9D%EC%84%B1)을 참고해 주십시오. 참고 변경한 설정은 다음 내보내기를 수행하는 시점부터 적용됩니다. ## Tracer 삭제 Tracer를 삭제하는 방법은 다음과 같습니다. 주의 Tracer를 삭제하더라도 Object Storage 버킷에 저장된 데이터는 자동으로 삭제되지 않으므로, Object Storage 서비스 이용 요금이 계속 부과될 수 있습니다. 필요하지 않은 데이터는 Object Storage 서비스에서 직접 삭제하여 요금 발생을 방지해 주십시오. 데이터 삭제 방법은 [Object Storage 파일/폴더 관리](/docs/objectstorage-use-file#%ED%8C%8C%EC%9D%BC%ED%8F%B4%EB%8D%94-%EA%B4%80%EB%A6%AC)를 참조해 주십시오. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **Services** > **Management & Governance** > **Cloud Activity Tracer** 메뉴를 차례대로 클릭해 주십시오. 2. **Tracers** 메뉴를 클릭해 주십시오. 3. 삭제할 Tracer를 선택한 후 **[삭제]** 버튼을 클릭해 주십시오. 4. Tracer 삭제 팝업 창의 내용을 확인한 후 **[삭제]** 버튼을 클릭해 주십시오.