Cloud Data Streaming Service Monitoring 데이터 조회
- 인쇄
- PDF
Cloud Data Streaming Service Monitoring 데이터 조회
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
VPC 환경에서 이용 가능합니다.
설명
Cluster 또는 서버의 Cloud Data Streaming Service Monitoring 데이터를 조회합니다.
요청
요청 URL
POST https://clouddatastreamingservice.apigw.gov-ntruss.com/api/v1/monitoring/getCdssMonitoringData/{service-group-instance-no} [수도권]
POST https://clouddatastreamingservice.apigw.gov-ntruss.com/api/krs-v1/monitoring/getCdssMonitoringData/{service-group-instance-no} [남부권]
요청 헤더
| 헤더명 | 설명 |
|---|---|
| x-ncp-apigw-timestamp | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 x-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key | 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값x-ncp-iam-access-key:{Account Access Key} |
| x-ncp-apigw-signature-v2 | Access Key ID 값과 Secret Key로 암호화한 서명x-ncp-apigw-signature-v2:{API Gateway Signature} |
| Content-Type | Request body content type을 application/json으로 지정Content-Type: application/json |
요청 파라미터
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| serviceGroupInstanceNo | String | Y | 조회할 Cluster의 번호 |
| timeStart | Long | Y | 조회 시작 시간(Millisecond) |
| timeEnd | Long | Y | 조회 종료 시간(Millisecond) |
| metric | String | Y | 조회하려는 metric 명 |
| computeInstanceNo | String | Y | 조회할 서버의 Compute Instance No(Cluster Metric 조회 시, 매니저 서버의 Compute Instance No) |
| interval | String | N | 집계 주기(default: Min1) |
- Cloud Data Streaming Service Metric(Cluster)
호출 시 반드시, computeInstanceNo는 매니저 서버의 computeInstanceNo를 입력해야 합니다.
| Metric | Description |
|---|---|
| CLUSTER_ALL_METRICS | 클러스터의 모든 Metric(Cloud Data Streaming Serivce의 모니터링 페이지에 있는 항목들) |
- Cloud Data Streaming Service Metric(서버)
| Metric | Description |
|---|---|
| BROKER_ALL_METRICS | Broker의 모든 Metric(Cloud Data Streaming Serivce의 모니터링 페이지에 있는 항목들) |
- Interval
| Metric | Description |
|---|---|
| Min1 | 1분 간격으로 조회(최대 1일) |
| Min5 | 5분 간격으로 조회(최대 1주일) |
| Min30 | 30분 간격으로 조회(최대 1개월) |
| Hour2 | 2시간 간격으로 조회(최대 3개월) |
| Day1 | 1일 간격으로 조회(최대 1년) |
요청 예시
POST https://clouddatastreamingservice.apigw.gov-ntruss.com/api/v1/monitoring/getCdssMonitoringData/1773271
HOST: clouddatastreamingservice.apigw.gov-ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: zq0FrtlU8JZJi9esTK31bCQUNG3H+jo4CMjMkJDoWSc=
x-ncp-apigw-timestamp: 1593848345548
x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw
{
"timeEnd": "1626240000000",
"timeStart": "1626239850000",
"metric": "CLUSTER_ALL_METRICS",
"computeInstanceNo": "1773272",
"interval" : "Min1"
}
curl -X POST "https://clouddatastreamingservice.apigw.gov-ntruss.com/api/v1/monitoring/getCdssMonitoringData/1773271 \
-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=" \
-d \
'{
"timeEnd": "1626240000000",
"timeStart": "1626239850000",
"metric": "CLUSTER_ALL_METRICS",
"computeInstanceNo": "1773272",
"interval" : "Min1"
}'
응답 파라미터
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 {
String instanceNo;
}
필드
| 파라미터명 | 타입 | 설명 |
|---|---|---|
| data | List | Monitoring 데이터 정보 |
| dps | List<ArrayList | 모니터링 정보(timestamp, data 형태) |
| aggregation | String | 조회하는 데이터의 집계함수 |
| dimensions | DimensionsVo | 조회하는 데이터의 구분자 |
| interval | String | 조회하는 데이터의 집계주기 |
| metric | String | 조회하는 Metric 명 |
| graphName | String | 그래프 이름 |
| productName | String | 상품 이름 |
| instanceNo | String | 조회하는 서버의 Compute Instance No |
응답 예시
{
"code": 0,
"message": "SUCCESS",
"result": {
"data": [
{
"dps": [
[
1626239880000,
1
],
[
1626239940000,
1
],
[
1626240000000,
1
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "Topics Total",
"graphName": "Topics Total",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
1
],
[
1626239940000,
1
],
[
1626240000000,
1
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "Partitions Total",
"graphName": "Partitions Total",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
0
],
[
1626239940000,
0
],
[
1626240000000,
0
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "Messages Total",
"graphName": "Messages Total",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
0
],
[
1626239940000,
0
],
[
1626240000000,
0
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "messagesInSecMean",
"graphName": "Messages In(/sec)",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
0
],
[
1626239940000,
0
],
[
1626240000000,
0
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "messagesInSecOneMin",
"graphName": "Messages In(/sec)",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
0
],
[
1626239940000,
0
],
[
1626240000000,
0
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "messagesInSecFiveMin",
"graphName": "Messages In(/sec)",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
0
],
[
1626239940000,
0
],
[
1626240000000,
0
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "messagesInSecFifteenMin",
"graphName": "Messages In(/sec)",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
0
],
[
1626239940000,
0
],
[
1626240000000,
0
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "bytesInSec",
"graphName": "Bytes In(/sec)",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
0
],
[
1626239940000,
0
],
[
1626240000000,
0
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "bytesInSecOneMin",
"graphName": "Bytes In(/sec)",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
0
],
[
1626239940000,
0
],
[
1626240000000,
0
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "bytesInSecFiveMin",
"graphName": "Bytes In(/sec)",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
0
],
[
1626239940000,
0
],
[
1626240000000,
0
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "bytesInSecFifteenMin",
"graphName": "Bytes In(/sec)",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
0
],
[
1626239940000,
0
],
[
1626240000000,
0
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "bytesOutSec",
"graphName": "Bytes Out(/sec)",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
0
],
[
1626239940000,
0
],
[
1626240000000,
0
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "bytesOutSecOneMin",
"graphName": "Bytes Out(/sec)",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
0
],
[
1626239940000,
0
],
[
1626240000000,
0
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "bytesOutSecFiveMin",
"graphName": "Bytes Out(/sec)",
"productName": "Cloud Data Streaming Service(VPC)"
},
{
"dps": [
[
1626239880000,
0
],
[
1626239940000,
0
],
[
1626240000000,
0
]
],
"aggregation": "AVG",
"dimensions": {
"instanceNo": "1773272"
},
"interval": "Min1",
"metric": "bytesOutSecFifteenMin",
"graphName": "Bytes Out(/sec)",
"productName": "Cloud Data Streaming Service(VPC)"
}
]
},
"requestId": "1eac9895-ea20-4cc1-8a09-cf4d116ccd7e"
}
이 문서가 도움이 되었습니까?