Tracers
    • PDF

    Tracers

    • PDF

    Article Summary

    Available in Classic and VPC

    This document explains how to create or delete tracers, modify settings of a tracer, and how to see the files exported to Object Storage. To access the Tracers menu, connect to the NAVER Cloud Platform portal, click the [Console] button, and then click the Services > Management & Governance > Cloud Activity Tracer > Tracers menus, in this order.

    Tracers page

    The Tracers page is laid out as follows.
    cloudactivitytracer-use-tracers_screen_ko

    FieldDescription
    ① Menu nameName of the menu currently being viewed
    ② Basic featuresFeatures provided on the first page when the user enters the Tracers menu
  • [Create tracer]: Click to create a tracer. (Refer to Create tracer.)
  • [Learn more about product] button: Click to go the Cloud Activity Tracer introduction page.
  • [Refresh] button: Click to refresh the tracer list.
  • [Auto-refresh (60s)] button: Click to activate the feature to automatically refresh the tracer list every 60 seconds.
  • Change settingsClick to modify the tracer settings. (Refer to Change tracer settings.)
    DeleteClick to delete the tracer. (Refer to Delete tracer.)
    ⑤ Tracer listThe list of tracers created (Refer to View tracer list.)
  • [View more] button: It's enabled only when the conditions set are 3 or more for each item. You can click this button to see the tracer's conditions in detail.
  • [Rerun] button: It's displayed when an export fails. Click to retry the export.
  • View tracer list

    The following describes how to view a tracer created from the tracer list.

    Note

    You can see the list only when there is one more tracers created. If there is no tracer created, then the list isn't shown in the Tracer page.

    1. From the NAVER Cloud Platform console, click the Services > Management & Governance > Cloud Activity Tracer menus, in that order.
    2. Click the Tracers menu.
    3. Check the summary information in the tracer list, or click a tracer to see the details.
      cloudactivitytracer-use-tracers_list_ko
      • Tracer name: name of the tracer set upon creation
      • Tracer type: type of the tracer
        • DEFAULT: You can't set the name and detailed conditions for a tracer of this type.
        • CUSTOM: You can set the name and detailed conditions for a tracer of this type.
      • Target bucket (region): name and region information of the bucket in Object Storage for export
      • Last run result: the result of the last export
        • Initial: the status in which the tracer is created, but not yet exported to Object Storage
        • Executing: the status in which an export to Object Storage is in progress
        • Success: the status in which the export to Object Storage has been completed
        • Fail: the status in which the export to Object Storage has failed
      • Last run date and time: date and time of the last export
      • Detailed tracer condition: information of the region, product, account, and tag set up upon creation of the tracer
      • Cause of last failure: the cause of failure in exporting to Object Storage
      • Modification date and time: date and time when tracer settings have been modified last
      • Creation date and time: date and time when the tracer was created

    Create tracer

    You can create a tracer, and export resource activity history that fits the conditions set up to Object Storage.
    The following describes how to create a tracer.

    1. From the NAVER Cloud Platform console, click the Services > Management & Governance > Cloud Activity Tracer menus, in that order.
    2. Click the Tracers menu.
    3. Click the [Create tracer] button.
    4. Enter the tracer information in the tracer creation pop-up window, and then click the [Create] button.
      • You can choose the Tracer type between Default and Custom.
        • One tracer of the Default type can be created per account. You can't set the tracer name and detailed conditions arbitrarily.
      Caution

      Fee for Object Storage is additionally charged, regardless of the created tracer type.

      • If you chose Custom, enter the tracer name, and set up the tracer target event conditions.
        • The tracer name must be unique.
        • From All resources list collected by Cloud Activity Tracer, you can only export resources that fit the selected conditions to Object Storage.
        • Region, product, and account are filtered by the AND condition. Multiple selections within the region, product, and account are filtered by the OR condition for export.
        • An additional fee is charged for the total sum of events set up for export.
      • Select the target bucket.
        • Region: region list of the Object Storage which is the export target
        • Bucket name: Bucket list of the Object Storage which is the export target
        • The [Create bucket] button is displayed if there are no buckets created. You can click it to create a bucket. (Refer to Create bucket.)
      • Transmission data format can be chosen between JSON and CSV.
        • If you choose CSV, you can't export a data field if it contains data that exceeds the cell's expression range (32767). In such a case, select JSON as the transmission data format.
      • Check when it's to be sent to Object Storage, and click the checkbox to select it.
        • The user's activity history pertaining to the tracer condition is transferred to the bucket on a daily basis. The data sent is of the day before. However, the activity history from the last 90 days until the day before is exported in bulk to Object Storage, when creating a new tracer.
        • When a tracer is created on 10-27-2021
          * 10-27-2021 (creation): The data from 07-29-2021 00:00 to 10-27-2021 00:00 is sent to Object Storage.
          => pub-tracer-test-daily-001-GMT+9-2021072900-2021102700-0.json
          * 10-28-2021 00:xx (GMT+9): The data from 10-27-2021 00:00 to 10-28-2021 00:00 is sent to Object Storage.
          => pub-tracer-test-daily-001-GMT+9-2021102700-2021102800-0.json
          * 10-29-2021 00:xx (GMT+9): The data from 10-28-2021 00:00 to 10-29-2021 00:00 is sent to Object Storage.
          => pub-tracer-test-daily-001-GMT+9-2021102800-2021102900-0.json
          - ...
          
    Note

    If export can't be done due to bucket deleted, changed permission, etc., from Object Storage, and the final execution result is processed as failed, the [Rerun] button is displayed in Final execution result. The user can normalize the status, and then click the [Rerun] button to rerun the failed export task.

    Change tracer settings

    The following describes how to change tracer settings.

    1. From the NAVER Cloud Platform console, click the Services > Management & Governance > Cloud Activity Tracer menus, in that order.
    2. Click the Tracers menu.
    3. Select the tracer to change the settings, and then click the [Change settings] button.
    4. Apply the changes in the tracer settings modification pop-up window, and then click the [Change] button.
      • The [Change] button will be enabled only when there are changes.
      • You can't change the Tracer type.
      • For more details about each item, refer to Create tracer.
    Note

    The changed settings will apply from the point of running the next export.

    Delete tracer

    The following describes how to delete a tracer.

    1. From the NAVER Cloud Platform console, click the Services > Management & Governance > Cloud Activity Tracer menus, in that order.
    2. Click the Tracers menu.
    3. Select the tracer to delete, and then click the [Delete] button.
    4. Check the details in the tracer deletion pop-up window, and then click the [Delete] button.
    Note

    Data files exported to Object Storage are not deleted, even when the tracer is deleted.

    View Object Storage files

    The following describes how to view data files exported to Object Storage.

    1. From the NAVER Cloud Platform console, select the region where the target bucket exported belongs.
    2. Click the Services > Storage > Object Storage > Bucket Management menus, in that order.
    3. Click the target bucket exported.
    4. Click the cat-tracer folder.
      • You can view the exported data file.
      • Click the file to view details to see the details.
      • To download files, select the file to download and click the [Download] button. JSON or CSV files will be downloaded according to the Tracer settings.

    Detailed description of the download file field

    The detailed descriptions for the fields of the files downloaded from Object Storage are as follows.

    Field nameDescriptionExample
    actionName of the resource change taskcreateServerInstance
    actionResultTypeSuccess or failure of the resource change taskSUCCESS/FAIL
    actionSubAccountNoNumber of the sub account that triggered the resource change task (same value as the SubAccountNo field of the sub account list search API)10000
    actionUserTypeRequesting user type
  • Customer: main account
  • Sub: sub account
  • Customer/Sub
    domainCodeDomain code (fixed value)PUB
    eventTimeTime when the resource change task was created (epoch (Unix) time)1621584442893
    historyIdUnique ID of the resource change task60a74edddcee96b0dcba0e60
    nrnUnique key value that can identify the resourcenrn:PUB:Server:KR:14---33:Server/1---4
    productDataDetails of the resource{"hostName":"test-server","asyncTaskUuid":"ae339ad9-6f46-...-537369cb1444","...":"..."}
    productDataStatusResource status after the resource change task has been createdrunning
    productNameService code of the resourceServer
    regionCodeRegion code of the resourceKR
    regionNameRegion name of the resourceKorea
    resourceTypeResource type of the resourceServer
    sourceIPClient IP that triggered the resource change task1.1.1.1
    sourceSubTypeDetailed type of the request that triggered the resource change eventAUTO_SCALING/INTERNAL
    sourceTypeType of the request that triggered the resource change eventCONSOLE/API/SYSTEM/ADMIN
    Note
    • The field is identical for both CSV and JSON files.
    • Since the field order may change for CSV files, it is recommended that you use a JSON file when you convert it to program.

    Was this article helpful?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.