View Search Engine monitoring data

Article summary

Did you find this summary helpful?

Thank you for your feedback

Can be used in a VPC environment.

Description

View the Search Engine monitoring data for clusters or servers.

Requests

Request URL

GET https://vpcsearchengine.apigw.ntruss.com/api/v2/monitoring/getSearchEngineMonitoringData/{service-group-instance-no}
?computeInstanceNo={computeInstanceNo}
&interval={interval}
&metric={metric}
&timeEnd={timeEnd}
&timeStart={timeStart} [KR]

GET https://vpcsearchengine.apigw.ntruss.com/api/sgn-v2/monitoring/getSearchEngineMonitoringData/{service-group-instance-no}
?computeInstanceNo={computeInstanceNo}
&interval={interval}
&metric={metric}
&timeEnd={timeEnd}
&timeStart={timeStart} [SGN]

GET https://vpcsearchengine.apigw.ntruss.com/api/jpn-v2/monitoring/getSearchEngineMonitoringData/{service-group-instance-no}
?computeInstanceNo={computeInstanceNo}
&interval={interval}
&metric={metric}
&timeEnd={timeEnd}
&timeStart={timeStart} [JPN]

Request header

Header	Description
x-ncp-apigw-timestamp	Number of milliseconds that have elapsed since January 1, 1970 00:00:00. If the time difference compared to the API Gateway server is more than 5 minutes, then the request is considered invalid. `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	Value of Access Key ID issued on Naver Cloud Platform portal `x-ncp-iam-access-key:{Account Access Key}`
x-ncp-apigw-signature-v2	Signature encrypted with the Access Key ID value and Secret Key `x-ncp-apigw-signature-v2:{API Gateway Signature}`
Content-Type	Specifies the request body content type as application/json `Content-Type: application/json`

Request parameters

Parameter	Type	Requirement status	Description
serviceGroupInstanceNo	String	Y	Cluster number to be searched
timeStart	Long	Y	Search start time (milliseconds)
timeEnd	Long	Y	Search end time (milliseconds)
metric	String	Y	Metric name to be searched
computeInstanceNo	String	Y	Compute instance number of the server to be searched (compute instance number of the manager server if searching cluster metric)
interval	String	N	Aggregation interval (default: Min1)

Search Engine Metric(Cluster)
When calling, one of the computeInstanceNo for the manager server must be entered for the computeInstanceNo.

Metric	Description
CLUSTER_ALL_METRICS	All Metrics in the cluster

Search Engine metric (server)

Metric	Description
SES_ALL_METRICS	All Metrics in Search Engine

Interval

Metric	Description
Min1	Search every minute (maximum one day)
Min5	Search every 5 minutes (maximum one week)
Min30	Search every 30 minutes (maximum one month)
Hour2	Search every 2 hours (maximum 3 months)
Day1	Search everyday (maximum one year)

Request example

GET https://vpcsearchengine.apigw.ntruss.com/api/v2/monitoring/getSearchEngineMonitoringData/1768175
?computeInstanceNo=2416997
&metric=SES_ALL_METRICS
&timeEnd=1657590447000
&timeStart=1657586847000
HOST: vpcsearchengine.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: zq0FrtlU8JZJi9esTK31bCQUNG3H+jo4CMjMkJDoWSc=
x-ncp-apigw-timestamp: 1593848345548
x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw

curl -X GET "https://vpcsearchengine.apigw.ntruss.com/api/v2/monitoring/getSearchEngineMonitoringData/1768175
?computeInstanceNo=2416997
&metric=SES_ALL_METRICS
&timeEnd=1657590447000
&timeStart=1657586847000 \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw" \
-H "x-ncp-apigw-timestamp: 1601971222179" \
-H "x-ncp-apigw-signature-v2: zrCelnR48AADdK/uh6Xe3yy468i8KpQoewYHUmeqYh4=" \

Response parameters

public class QueryDataResponseVo {
    List<MetricInfoResponseVo> data;
}

public class MetricInfoResponseVo{ 
    List<ArrayList<Object>> dps;
    String aggregation;
    DimensionsVo dimensions;
    String interval;
    String metric;
    String graphName;
    String productName;
}

public class DimensionsVo {
     @JsonProperty("Svc_group_instance_no")
     String serviceGroupInstanceNo;
     String instanceNo;
}

Field

Parameter name	Type	Description
data	List	Information of monitoring data
dps	List<ArrayList	Monitoring information (timestamp, data format)
aggregation	String	Aggregation functions of the searched data
dimensions	DimensionsVo	Separators of the searched data
interval	String	Aggregation interval of the searched data
metric	String	Name of the searched metric
graphName	String	Graph name
productName	String	Product name
serviceGroupInstanceNo	String	Service group instance number of the searched cluster
instanceNo	String	Compute instance number of the searched server

Response example

{
  "code": 0,
  "message": "SUCCESS",
  "result": {
    "data": [
      {
        "dps": [
          [
            1626315360000,
            0
          ],
          [
            1626315420000,
            0
          ]
        ],
        "aggregation": "AVG",
        "dimensions": {
          "instanceNo": "1768176",
          "Svc_group_instance_no": "1768175"
        },
        "interval": "Min1",
        "metric": "Indexing Rate",
        "graphName": "Indexing Rate(/m)",
        "productName": "Search Engine Service(VPC)"
      },
      {
        "dps": [
          [
            1626315360000,
            0
          ],
          [
            1626315420000,
            0
          ]
        ],
        "aggregation": "AVG",
        "dimensions": {
          "instanceNo": "1768176",
          "Svc_group_instance_no": "1768175"
        },
        "interval": "Min1",
        "metric": "Search Rate",
        "graphName": "Search Rate(/m)",
        "productName": "Search Engine Service(VPC)"
      },
      {
        "dps": [
          [
            1626315360000,
            0
          ],
          [
            1626315420000,
            0
          ]
        ],
        "aggregation": "AVG",
        "dimensions": {
          "instanceNo": "1768176",
          "Svc_group_instance_no": "1768175"
        },
        "interval": "Min1",
        "metric": "Indexing Latency",
        "graphName": "Indexing Latency(/ms)",
        "productName": "Search Engine Service(VPC)"
      },
      {
        "dps": [
          [
            1626315360000,
            0
          ],
          [
            1626315420000,
            0
          ]
        ],
        "aggregation": "AVG",
        "dimensions": {
          "instanceNo": "1768176",
          "Svc_group_instance_no": "1768175"
        },
        "interval": "Min1",
        "metric": "Search Latency",
        "graphName": "Search Latency(/ms)",
        "productName": "Search Engine Service(VPC)"
      },
      {
        "dps": [
          [
            1626315360000,
            5
          ],
          [
            1626315420000,
            5
          ],
          [
            1626315480000,
            5
          ]
        ],
        "aggregation": "AVG",
        "dimensions": {
          "instanceNo": "1768176",
          "Svc_group_instance_no": "1768175"
        },
        "interval": "Min1",
        "metric": "Node Count",
        "graphName": "Node Count",
        "productName": "Search Engine Service(VPC)"
      },
      {
        "dps": [
          [
            1626315360000,
            1
          ],
          [
            1626315420000,
            1
          ],
          [
            1626315480000,
            1
          ]
        ],
        "aggregation": "AVG",
        "dimensions": {
          "instanceNo": "1768176",
          "Svc_group_instance_no": "1768175"
        },
        "interval": "Min1",
        "metric": "Documents Total",
        "graphName": "Documents Total",
        "productName": "Search Engine Service(VPC)"
      },
      {
        "dps": [
          [
            1626315360000,
            11
          ],
          [
            1626315420000,
            11
          ],
          [
            1626315480000,
            11
          ]
        ],
        "aggregation": "AVG",
        "dimensions": {
          "instanceNo": "1768176",
          "Svc_group_instance_no": "1768175"
        },
        "interval": "Min1",
        "metric": "Indices Total",
        "graphName": "Indices Total",
        "productName": "Search Engine Service(VPC)"
      },
      {
        "dps": [
          [
            1626315360000,
            22
          ],
          [
            1626315420000,
            22
          ],
          [
            1626315480000,
            22
          ]
        ],
        "aggregation": "AVG",
        "dimensions": {
          "instanceNo": "1768176",
          "Svc_group_instance_no": "1768175"
        },
        "interval": "Min1",
        "metric": "Shards Total",
        "graphName": "Shards Total",
        "productName": "Search Engine Service(VPC)"
      },
      {
        "dps": [
          [
            1626315360000,
            0
          ],
          [
            1626315420000,
            0
          ],
          [
            1626315480000,
            0
          ]
        ],
        "aggregation": "AVG",
        "dimensions": {
          "instanceNo": "1768176",
          "Svc_group_instance_no": "1768175"
        },
        "interval": "Min1",
        "metric": "Disk Used",
        "graphName": "Disk Used(GB)",
        "productName": "Search Engine Service(VPC)"
      }
    ]
  },
  "requestId": "418fc34b-0eb2-4e4e-b670-37c08aea3ed9"
}

Was this article helpful?

What's Next

View OS monitoring data

Table of contents

Description
Requests
Response parameters
Field