알리바바 클라우드 API 게이트웨이
알리바바 클라우드 API 게이트웨이 모니터링 데이터 수집
설정¶
Func 설치¶
추천으로는 Guance 통합 - 확장 - 관리형 Func를 사용하세요
직접 Func를 배포하는 경우 Func를 자체 배포를 참고하세요
개통 스크립트¶
참고: 사전에 요구 사항을 만족하는 알리바바 클라우드 AK를 준비하세요. 간단히 하려면 전역 읽기 전용 권한
ReadOnlyAccess를 직접 부여해도 됩니다.
관리형 버전 개통 스크립트¶
- Guance 콘솔에 로그인합니다
- [통합] 메뉴를 클릭하고 [클라우드 계정 관리]를 선택합니다
- [클라우드 계정 추가]를 클릭하고 [알리바바 클라우드]를 선택한 뒤 화면에 필요한 정보를 입력합니다. 이전에 클라우드 계정 정보를 이미 구성했다면 이 단계는 건너뜁니다
- [테스트]를 클릭합니다. 테스트에 성공하면 [저장]을 클릭하고, 실패하면 관련 구성 정보가 올바른지 확인한 뒤 다시 테스트합니다
- [클라우드 계정 관리] 목록에서 추가된 클라우드 계정을 확인할 수 있습니다. 해당 클라우드 계정을 클릭해 상세 페이지로 들어갑니다
- 클라우드 계정 상세 페이지의 [통합] 버튼을 클릭한 뒤
설치되지 않음목록에서알리바바 클라우드 API 게이트웨이를 찾아 [설치] 버튼을 클릭하면 설치 화면이 나타나며 설치할 수 있습니다
수동 개통 스크립트¶
-
Func 콘솔에 로그인하고 [스크립트 마켓]을 클릭하여 Guance 스크립트 마켓으로 들어간 뒤
integration_alibabacloud_apigateway를 검색합니다 -
[설치]를 클릭한 뒤 알리바바 클라우드 AK ID, AK Secret 및 계정명을 입력합니다
-
[시작 스크립트 배포]를 클릭하면 시스템이 자동으로
Startup스크립트 세트를 생성하고 해당 시작 스크립트를 자동으로 구성합니다 -
활성화한 뒤에는 「관리 / 자동 트리거 설정」에서 해당 자동 트리거 설정을 볼 수 있습니다. [실행]을 클릭하면 주기 시간을 기다리지 않고 즉시 한 번 실행할 수 있습니다. 잠시 후 실행 작업 기록과 해당 로그를 확인할 수 있습니다
검증¶
- 「관리 / 자동 트리거 설정」에서 해당 작업의 자동 트리거 설정이 존재하는지 확인하고, 작업 기록과 로그를 확인해 이상 여부를 점검합니다
- Guance의 「인프라 / 사용자 정의」에서 자산 정보가 있는지 확인합니다
- Guance의 「지표」에서 해당 모니터링 데이터가 있는지 확인합니다
지표¶
알리바바 클라우드 - 클라우드 모니터링 구성을 완료하면 기본 지표 집합은 다음과 같습니다. 구성 방식으로 더 많은 지표를 수집할 수 있습니다 알리바바 클라우드 모니터링 지표 상세
API 게이트웨이¶
| MetricName | 지표 유형 | MetricDescribe | Dimensions | Statistics | Unit |
|---|---|---|---|---|---|
| Latency | 인스턴스 차원 | 응답 시간 | userId,region,apiUid | Average | ms |
| SumQPS | 인스턴스 차원 | 총 요청 수 | userId,region,apiUid | Count | count |
| TrafficRX | 인스턴스 차원 | 유입 트래픽 | userId,region,apiUid | Sum | B |
| TrafficTX | 인스턴스 차원 | 유출 트래픽 | userId,region,apiUid | Sum | B |
| code2XX | 인스턴스 차원 | 2XX 응답 코드 수 | userId,region,apiUid | Value | count |
| code429 | 인스턴스 차원 | 429 응답 코드 수 | userId,region,apiUid | Value | count |
| code4XX | 인스턴스 차원 | 4XX 응답 코드 수 | userId,region,apiUid | Value | count |
| code5XX | 인스턴스 차원 | 5XX 응답 코드 수 | userId,region,apiUid | Value | count |
| error_count_instance | apigateway | 인스턴스 요청 오류 수 | userId,region,apiUid | Sum | count |
| instance_lost | apigateway | 인스턴스 노드 손실 비율 | userId,region,instanceId | Average | % |
| request_count_instance | apigateway | 인스턴스 총 요청 수 | userId,region,instanceId | Sum | count |
API 그룹¶
| MetricName | 지표 유형 | MetricDescribe | Dimensions | Statistics | Unit |
|---|---|---|---|---|---|
| Latency_group | apiGroupUid | 응답 시간 | userId,region,apiGroupUid | Average | ms |
| SumQPS_group | apiGroupUid | 총 요청 수 | userId,region,apiGroupUid | Count | count |
| TrafficRX_group | apiGroupUid | 유입 트래픽 | userId,region,apiGroupUid | Sum | B |
| TrafficTX_group | apiGroupUid | 유출 트래픽 | userId,region,apiGroupUid | Sum | B |
| code2XX_group | apiGroupUid | 2XX 응답 코드 수 | userId,region,apiGroupUid | Value | count |
| code429_group | apiGroupUid | 429 응답 코드 수 | userId,region,apiGroupUid | Value | count |
| code4XX_group | apiGroupUid | 4XX 응답 코드 수 | userId,region,apiGroupUid | Value | count |
| code5XX_group | apiGroupUid | 5XX 응답 코드 수 | userId,region,apiGroupUid | Value | count |
API 인스턴스¶
| MetricName | 지표 유형 | MetricDescribe | Dimensions | Statistics | Unit |
|---|---|---|---|---|---|
| Latency_instance | 인스턴스 차원 | 응답 시간 | userId,region,instanceId | Average | ms |
| SumQPS_instance | 인스턴스 차원 | 총 요청 수 | userId,region,instanceId | Count | count |
| TrafficRX_instance | 인스턴스 차원 | 유입 트래픽 | userId,region,instanceId | Sum | B |
| TrafficTX_instance | 인스턴스 차원 | 유출 트래픽 | userId,region,instanceId | Sum | B |
| code2XX_instance | 인스턴스 차원 | 2XX 응답 코드 수 | userId,region,instanceId | Value | count |
| code429_instance | 인스턴스 차원 | 429 응답 코드 수 | userId,region,instanceId | Value | count |
| code4XX_instance | 인스턴스 차원 | 4XX 응답 코드 수 | userId,region,instanceId | Value | count |
| code5XX_instance | 인스턴스 차원 | 5XX 응답 코드 수 | userId,region,instanceId | Value | count |
객체¶
수집된 알리바바 클라우드 API 게이트웨이 객체 데이터 구조는 「인프라-사용자 정의」에서 확인할 수 있습니다
{
"measurement": "aliyun_apigateway",
"tags": {
"instance_spec" : "api.s1.small",
"instance_name" : "xxxx-test",
"instance_id" : "i-xxxxx",
"region_id" : "cn-hangzhou"
},
"fields": {
"zone_local_name" : "xxxxx",
"internet_egress_address" : "114.55.1xx.xxx",
"created_time" : "2025/09/01 16:10:09",
"vpc_egress_address" : "100.xxx.xxx.0/xx",
"instance_spec_attributes" : "xxxxx",
"instance_charge_type" : "PayAsYouGo",
"vpc_slb_intranet_enable" : "False",
"instance_type" : "VPC_SHARED",
"status" : "RUNNING",
"zone_id" : "cn-hangzhou",
"instance_cidr_block" : "172.16.xx.xx/xx",
"ipv_6_acl_status" : "off",
"egress_ipv_6_enable" : "False",
"maintain_start_time" : "18:00Z",
"maintain_end_time" : "22:00Z"
}
}
참고:
tags와fields의 필드는 이후 업데이트에 따라 변경될 수 있습니다