--- title: "Tracers" slug: "cat-tracers" tags: ["Cloud Activity Tracer"] updated: 2026-09-17T09:07:54Z published: 2026-09-17T09:07:54Z canonical: "guide.ncloud-docs.com/cat-tracers" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Tracers Classic/VPC 환경에서 이용 가능합니다. Tracers에서 Tracer를 생성하거나 삭제하는 방법과 Tracer의 설정을 변경하는 방법, Object Storage로 내보낸 파일을 확인하는 방법을 설명합니다. **Tracers** 메뉴에 접속하려면 네이버 클라우드 플랫폼 포털에 접속하여 **[콘솔]** 버튼을 클릭한 후 **Menu** > **All Services** > **Management & Governance** > **Cloud Activity Tracer** > **Tracers** 메뉴를 차례대로 클릭해 주십시오. ## Tracers 화면 Tracers 화면은 다음과 같이 구성되어 있습니다. ![cloudactivitytracer-use-tracers_screen_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/cloudactivitytracer-use-tracers_screen_ko.png?sv=2026-02-06&spr=https&st=2026-11-13T05%3A01%3A31Z&se=2026-11-13T06%3A01%3A31Z&sr=c&sp=r&sig=n3RzbUsDOQL7qeZB7JBO9BtY6cQxeDn2wHKUIFqJQ5I%3D) | 영역 | 설명 | | --- | --- | | ① 메뉴명 | 현재 확인 중인 메뉴명 | | ② 기본 기능 | **Tracers** 메뉴에 최초 진입 시 제공되는 기능 - **[Tracer 생성]** 버튼: 클릭하여 Tracer 생성([Tracer 생성](/docs/cat-tracers#Tracer%EC%83%9D%EC%84%B1) 참고) - **[상품 더 알아보기]** 버튼: 클릭하여 Cloud Activity Tracer 소개 페이지로 이동 - **[새로 고침]** 버튼: 클릭하여 Tracer 목록 새로 고침 - **[자동갱신(60s)]** 버튼: 클릭하여 활성화하면 60초마다 Tracer 목록 자동 새로 고침 가능 | | ③ **설정 변경** | 클릭하여 Tracer 설정 변경([Tracer 설정 변경](/docs/cat-tracers#Tracer%EC%84%A4%EC%A0%95%EB%B3%80%EA%B2%BD) 참고) | | ④ **삭제** | 클릭하여 Tracer 삭제([Tracer 삭제](/docs/cat-tracers#Tracer%EC%82%AD%EC%A0%9C) 참고) | | ⑤ Tracer 목록 | 생성한 Tracer 목록([Tracer 목록 확인](/docs/cat-tracers#Tracer%EB%AA%A9%EB%A1%9D%ED%99%95%EC%9D%B8) 참고) - **[자세히 보기]** 버튼: 설정한 조건이 항목당 3개 이상인 경우에만 활성화되며, 클릭하여 Tracer 상세 조건 확인 가능 - **[재실행]** 버튼: 내보내기에 실패한 경우 표시되며, 클릭하여 내보내기 재실행 | ## Tracer 목록 확인 Tracer 목록에서 생성한 Tracer를 확인하는 방법은 다음과 같습니다. 참고 생성한 Tracer가 1개 이상인 경우에만 목록을 확인할 수 있습니다. 생성한 Tracer가 없는 경우, Tracer 화면에서 목록이 표시되지 않습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Management & Governance** > **Cloud Activity Tracer** 메뉴를 차례대로 클릭해 주십시오. 2. **Tracers** 메뉴를 클릭해 주십시오. 3. Tracer 목록에서 요약 정보를 확인하거나 Tracer를 클릭하여 상세 정보를 확인해 주십시오. ![cloudactivitytracer-use-tracers_list_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/cloudactivitytracer-use-tracers_list_ko.png?sv=2026-02-06&spr=https&st=2026-11-13T05%3A01%3A31Z&se=2026-11-13T06%3A01%3A31Z&sr=c&sp=r&sig=n3RzbUsDOQL7qeZB7JBO9BtY6cQxeDn2wHKUIFqJQ5I%3D) - **Tracer 이름**: Tracer 생성 시 설정한 이름 - **Tracer 타입**: Tracer 타입 - **DEFAULT**: Tracer 이름 및 상세 조건을 임의로 설정할 수 없는 타입 - **CUSTOM**: Tracer 이름 및 상세 조건을 임의로 설정할 수 있는 타입 - **대상 Bucket (리전)**: 내보내기할 Object Storage의 버킷명과 해당 버킷의 리전 정보 - **최종 실행 결과**: 마지막으로 수행한 내보내기 수행 결과 - **Initial**: Tracer를 생성한 후 Object Storage로 내보내기 전인 상태 - **Executing**: Object Storage로 내보내기 중인 상태 - **Success**: Object Storage로 내보내기를 완료한 상태 - **Fail**: Object Storage로 내보내기를 실패한 상태 - **최종 실행 일시**: 마지막으로 내보내기를 수행한 일시 - **Tracer 상세 조건**: Tracer 생성 시 설정한 **리전**, **상품**, **계정**, **태그** 정보 - **최종 실패 원인**: Object Storage로 내보내기를 실패한 원인 - **변경 일시**: Tracer의 설정이 변경된 최종 일시 - **생성 일시**: Tracer를 생성한 일시 - **태그** : Tracer를 쉽게 분류할 수 있도록 태그 키/값을 부여 - **[태그관리]** 를 통해 전체 태그 조회/생성/수정/삭제 가능 - 1개의 태그 키에는 1개의 태그 값만 부여 가능 ## Tracer 생성 Tracer를 생성하여 설정한 조건에 맞는 리소스 작업 내역을 Object Storage에 내보낼 수 있습니다. Tracer를 생성하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Management & Governance** > **Cloud Activity Tracer** 메뉴를 차례대로 클릭해 주십시오. 2. **Tracers** 메뉴를 클릭해 주십시오. 3. **[Tracer 생성]** 버튼을 클릭해 주십시오. 4. Tracer 생성 팝업 창에서 Tracer 정보를 입력한 후 **[생성]** 버튼을 클릭해 주십시오. 주의 생성한 Tracer 타입과 무관하게 Object Storage 요금이 별도로 부과됩니다. - **Tracer 타입**은 **Default**와 **Custom** 중 선택할 수 있습니다. - **Default**는 계정당 1개만 생성할 수 있으며, Tracer 이름과 상세 조건을 임의로 설정할 수 없습니다. - **Custom**을 선택한 경우, **Tracer 이름**을 입력한 후 **Tracer 대상 이벤트 조건**을 설정해 주십시오. - 다른 Tracer와 중복된 이름은 사용할 수 없습니다. - Cloud Activity Tracer에서 수집하는 [전체 리소스 목록](/docs/cat-spec#%EB%A6%AC%EC%86%8C%EC%8A%A4%EC%9E%91%EC%97%85%EB%AA%A9%EB%A1%9D) 중에서 선택한 조건에 해당하는 리소스만 Object Storage로 내보낼 수 있습니다. - **리전**, **상품**, **계정**은 각각 AND 조건으로 필터되며, **리전**, **상품**, **계정** 내에서의 다중 선택은 OR 조건으로 필터되어 내보내기를 수행합니다. - 내보내기 설정한 이벤트 건수를 합산하여 요금이 별도로 발생합니다. - **대상 Bucket**을 선택해 주십시오. - **리전**: 내보내기할 대상 Object Storage의 리전 목록 - **버킷명**: 내보내기할 대상 Object Storage의 버킷 목록 - 생성된 버킷이 없는 경우 **[Bucket 생성하기]** 버튼이 표시되며, 클릭하여 Bucket을 생성할 수 있습니다.([버킷 생성](/docs/objectstorage-use-bucket#%EB%B2%84%ED%82%B7%EC%83%9D%EC%84%B1) 참고) - **전송 데이터 형식**은 **JSON**과 **CSV** 중 선택할 수 있습니다. - **CSV** 선택 시, cell 표현 가능 범위(32767)를 넘는 데이터가 포함된 경우 해당 데이터의 필드는 내보내기가 수행되지 않습니다. 이 경우, **전송 데이터 형식**을 **JSON**으로 선택해 주십시오. - Object Storage 전송 시점을 확인한 후 체크 박스를 클릭하여 선택해 주십시오. - Tracer 조건에 해당하는 사용자의 활동 이력은 1일 전 이력이 하루 단위로 버킷에 전송됩니다. 단, Tracer 신규 생성 시에는 90일 전부터 1일 전까지의 활동 이력을 Object Storage로 일괄로 내보냅니다. - <예시> 2021-10-27에 Tracer 생성 시 ``` * 2021-10-27(생성 시): 2021-07-29 00:00 ~ 2021-10-27 00:00까지의 데이터가 Object Storage로 전송됨 => pub-tracer-test-daily-001-GMT+9-2021072900-2021102700-0.json * 2021-10-28 00:xx(GMT+9): 2021-10-27 00:00 ~ 2021-10-28 00:00까지의 데이터가 Object Storage로 전송됨 => pub-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로 전송됨 => pub-tracer-test-daily-001-GMT+9-2021102800-2021102900-0.json - ... ``` - 태그 영역에 Tracer를 분류할 수 있는 태그 Key:Value를 입력해 주십시오. 참고 Object Storage의 버킷 삭제, 권한 변경 등의 이유로 내보내기를 수행할 수 없어 최종 실행 결과가 실패로 처리된 경우, **최종 실행 결과**에 **[재실행]** 버튼이 표시됩니다. 사용자는 상태를 정상화한 후 **[재실행]** 버튼을 클릭하여 실패한 내보내기 작업을 다시 수행할 수 있습니다. ## Tracer 설정 변경 Tracer 설정을 변경하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Management & Governance** > **Cloud Activity Tracer** 메뉴를 차례대로 클릭해 주십시오. 2. **Tracers** 메뉴를 클릭해 주십시오. 3. 설정을 변경할 Tracer를 선택한 후 **[설정 변경]** 버튼을 클릭해 주십시오. 4. Tracer 설정 변경 팝업 창에서 변경할 사항을 적용한 후 **[수정]** 버튼을 클릭해 주십시오. - 변경된 사항이 있는 경우에만 **[수정]** 버튼이 활성화됩니다. - **Tracer 타입**은 변경할 수 없습니다. - 각 항목에 관한 자세한 내용은 [Tracer 생성](/docs/cat-tracers#Tracer%EC%83%9D%EC%84%B1)을 참고해 주십시오. 참고 변경된 설정은 다음 내보내기를 수행하는 시점부터 적용됩니다. ## Tracer 삭제 Tracer를 삭제하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Management & Governance** > **Cloud Activity Tracer** 메뉴를 차례대로 클릭해 주십시오. 2. **Tracers** 메뉴를 클릭해 주십시오. 3. 삭제할 Tracer를 선택한 후 **[삭제]** 버튼을 클릭해 주십시오. 4. Tracer 삭제 팝업 창의 내용을 확인한 후 **[삭제]** 버튼을 클릭해 주십시오. 참고 Tracer가 삭제되어도 Object Storage로 내보내기한 데이터 파일은 삭제되지 않습니다. ## Object Storage 파일 확인 Object Storage로 내보내기한 데이터 파일을 확인하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 내보내기한 대상 버킷이 속한 리전을 선택해 주십시오. 2. **Menu** > **All 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 파일을 이용할 것을 권장합니다.