SearchMetricList
    • PDF

    SearchMetricList

    • PDF

    Article summary

    The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.

    Available in Classic and VPC

    Get the list of metrics for a monitoring target group.

    Request

    This section describes the request format. The method and URI are as follows:

    MethodURI
    POST/cw_fea/real/cw​/api​/rule​/group​/metric​/search

    Request headers

    For information about the headers common to all Cloud Insight APIs, see Cloud Insight request headers.

    Request body

    See MetricListRequest for more information about the fields related to metric information.

    Request example

    The request example is as follows:

    curl --location --request POST 'https://cw.apigw.ntruss.com/cw_fea/real/cw​/api​/rule​/group​/metric​/search' \
    --header 'x-ncp-apigw-timestamp: {Timestamp}' \
    --header 'x-ncp-iam-access-key: {Access Key}' \
    --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
    --header 'Content-Type: application/json' \
    --data '{
        "dimValues": [
            {
                "name": "type",
                "value": "cpu"
            }
        ],
        "query": "used",
        "dimensionsSelectedList": [
          {
            "name": "cpu_idx",
            "values": [
              "0",
              "1"
            ]
          }
        ],
        "prodKey": "**********"
    }'
    

    Response

    This section describes the response format.

    Response body

    The response body includes the following data:

    FieldTypeRequiredDescription
    metricsArray-Metric list
    prodKeyStringRequiredProduct key (cw_key)

    metrics

    The following describes metrics.

    FieldTypeRequiredDescription
    dataTypeString-Data type
    descString-Metric description
    dimensionsArray-Dimension list
    idDimensionString-Dimension name
    metricString-Metric name
    optionsObject-Aggregation method
    • Displayed in the form of "Aggregation cycle": [Aggregation function]
      • Aggregation cycle: Min1 | Min5 | Min30 | Hour2 | Day1
      • Aggregation function: COUNT | SUM | MAX | MIN | AVG
    prodKeyStringRequiredProduct key (cw_key)
    unitString-Unit

    dimensions

    The following describes dimensions.

    FieldTypeRequiredDescription
    dimString-Dimension name
    valString-Dimension value

    Response status codes

    For response status codes common to NAVER Cloud Platform, see Cloud Insight API response status codes.

    Response example

    The response example is as follows:

    {
      "metrics": [
        {
          "dataType": "FLOAT",
          "desc": "used ratio",
          "dimensions": [
            {
              "dim": "type",
              "val": "cpu"
            },
            {
              "dim": "cpu_idx",
              "val": "0"
            }
          ],
          "idDimension": "instanceNo",
          "metric": "used_rto",
          "options": {
            "Min1": [
              "COUNT",
              "SUM",
              "MAX",
              "MIN",
              "AVG"
            ],
            "Min5": [
              "COUNT",
              "SUM",
              "MAX",
              "MIN",
              "AVG"
            ],
            "Min30": [
              "COUNT",
              "SUM",
              "MAX",
              "MIN",
              "AVG"
            ],
            "Hour2": [
              "COUNT",
              "SUM",
              "MAX",
              "MIN",
              "AVG"
            ],
            "Day1": [
              "COUNT",
              "SUM",
              "MAX",
              "MIN",
              "AVG"
            ]
          },
          "prodKey": "**********",
          "unit": "%"
        },
        {
          "dataType": "FLOAT",
          "desc": "used ratio",
          "dimensions": [
            {
              "dim": "type",
              "val": "cpu"
            },
            {
              "dim": "cpu_idx",
              "val": "1"
            }
          ],
          "idDimension": "instanceNo",
          "metric": "used_rto",
          "options": {
            "Min1": [
              "COUNT",
              "SUM",
              "MAX",
              "MIN",
              "AVG"
            ],
            "Min5": [
              "COUNT",
              "SUM",
              "MAX",
              "MIN",
              "AVG"
            ],
            "Min30": [
              "COUNT",
              "SUM",
              "MAX",
              "MIN",
              "AVG"
            ],
            "Hour2": [
              "COUNT",
              "SUM",
              "MAX",
              "MIN",
              "AVG"
            ],
            "Day1": [
              "COUNT",
              "SUM",
              "MAX",
              "MIN",
              "AVG"
            ]
          },
          "prodKey": "**********",
          "unit": "%"
        }
      ],
      "prodKey": "**********"
    }
    

    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.