CloudWatch 지원 프로토콜에 대한 FAQ - Amazon CloudWatch

CloudWatch 지원 프로토콜에 대한 FAQ

이제 CloudWatch는 AWS JSON 1.0Smithy RPC v2 CBOR이라는 2개의 추가 프로토콜에 대해 지원됩니다. 이러한 프로토콜은 AWS SDK 및 CLI에서 현재 사용 중인 AWS 쿼리 프로토콜보다 더 나은 성능을 제공합니다. AWS SDK는 각 언어에 가장 적합한 프로토콜의 우선순위를 지정합니다.

AWS JSON 프로토콜이란 무엇이며, 기존 CloudWatch API 요청 및 응답과 어떻게 다른가요?

JSON은 이기종 시스템 간 통신에 가장 널리 사용되고 수용되는 연결 방법 중 하나입니다. CloudWatch는 JSON을 매체로 사용하여 AWS SDK 클라이언트(예: Java, Python, Golang, JavaScript)와 CloudWatch 서버 간에 통신합니다. CloudWatch API 작업의 HTTP 요청은 JSON 양식의 입력을 수락합니다. CloudWatch 작업이 실행되고 실행 응답이 JSON 양식으로 SDK 클라이언트에 다시 공유됩니다. JSON은 AWS 쿼리에 비해 클라이언트와 서버 간에 데이터를 전송하는 데 효율적입니다.

  • CloudWatch AWS JSON 프로토콜은 CloudWatch 클라이언트 및 서버 사이에서 중재자 역할을 합니다.

  • 서버는 CloudWatch 작업이 생성되는 프로그래밍 언어를 이해하지 못하지만 AWS JSON 프로토콜은 이해합니다.

  • CloudWatch AWS JSON 프로토콜은 CloudWatch 클라이언트 및 서버 사이에서 직렬화(객체를 JSON 형식으로 변환) 및 역직렬화(JSON 형식을 객체로 변환)를 사용합니다.

Smithy RPC v2 CBOR 프로토콜이란 무엇이며, 기존 CloudWatch API 요청 및 응답과 어떻게 다른가요?

Concise Binary Object Representation(CBOR)은 효율성과 유연성에 초점을 맞춘 데이터 형식입니다. 주요 설계 목표에는 매우 작은 코드 크기, 컴팩트한 메시지 크기, 버전 없는 확장성이 포함됩니다. Amazon에서 개발한 프로토콜인 Smithy RPC v2 CBOR은 이러한 이점을 기반으로 보다 효율적인 데이터 전송을 지원합니다. RPC V2 CBOR은 JSON의 텍스트 인코딩 대신 바이너리 인코딩을 구현하여 페이로드 크기와 직렬화에 소요되는 시간을 단축합니다.

  • CloudWatch RPC v2 CBOR 프로토콜은 CloudWatch 클라이언트 및 서버 사이에서 중재자 역할을 합니다.

  • 서버는 CloudWatch 작업이 생성되는 프로그래밍 언어를 이해하지 못하지만 RPC v2 CBOR 프로토콜은 이해합니다.

  • CloudWatch RPC v2 CBOR 프로토콜은 CloudWatch 클라이언트 및 서버 사이에서 직렬화(객체를 CBOR 형식으로 변환) 및 역직렬화(CBOR 형식을 객체로 변환)를 사용합니다.

CloudWatch의 최신 프로토콜을 시작하려면 어떻게 해야 하나요?

이제 SDK의 공개 미리 보기 버전에서 새 프로토콜을 사용할 수 있습니다. SDK는 아래 지침에 따라 다운로드할 수 있습니다.

참고

아래 나열된 CloudWatch SDK의 미리 보기 버전에는 다음과 같은 특정 문제가 있습니다. 이 미리 보기 SDK를 사용하면 이러한 문제가 통합에 영향을 줄 수 있습니다. 최종 릴리스 전에 이러한 문제를 해결할 계획입니다.

  • 모든 SDK에 영향 - 미리 보기 버전에서는 목록에서 후행 null 값이 제거됩니다. 최종 릴리스에서는 이러한 값이 올바르게 직렬화될 것입니다.

  • Java SDK v1에 특정 - 미리 보기 버전에서 빈 목록을 직렬화하지 않습니다. 최종 릴리스에서는 빈 목록이 제대로 직렬화될 것입니다.

SDK 클라이언트 프로토콜 지원
Language SDK 클라이언트 리포지토리 SDK 다운로드 링크 SDK 설치 지침 프로토콜
C++ aws/aws-sdk-cpp 다운로드 링크 설치 지침 AWS JSON 1.0
Golang 2.x aws/aws-sdk-go-v2 다운로드 링크 설치 지침 RPC v2 CBOR
Java 1.x aws/aws-sdk-java 다운로드 링크 설치 지침 AWS JSON 1.0
Java 2.x aws/aws-sdk-java-v2 다운로드 링크 설치 지침 RPC v2 CBOR
JavaScript v3.x aws/aws-sdk-js-v3 다운로드 링크 설치 지침 AWS JSON 1.0
.NET aws/aws-sdk-net 다운로드 링크 설치 지침 AWS JSON 1.0
PHP aws/aws-sdk-php 다운로드 링크 설치 지침 AWS JSON 1.0
Python-boto3 boto/boto3 다운로드 링크 설치 지침 AWS JSON 1.0
awscli AWS CLI v1 아티팩트 다운로드 링크 설치 지침 AWS JSON 1.0
AWS CLI v2 소스 배포 다운로드 링크 설치 지침 AWS JSON 1.0
AWS CLI v2 소스 배포 분리됨 다운로드 링크 설치 지침 AWS JSON 1.0
AWS CLI v2 Windows MSI 다운로드 링크 설치 지침 AWS JSON 1.0
AWS CLI v2 Linux X86 Docker 다운로드 링크 설치 지침 AWS JSON 1.0
AWS CLI v2 Linux X86 다운로드 링크 설치 지침 AWS JSON 1.0
AWS CLI v2 Linux X86 설치 관리자 분리됨 다운로드 링크 설치 지침 AWS JSON 1.0
AWS CLI v2 Linux ARM Docker 다운로드 링크 설치 지침 AWS JSON 1.0
AWS CLI v2 Linux ARM 다운로드 링크 설치 지침 AWS JSON 1.0
AWS CLI v2 Linux ARM 설치 관리자 분리됨 다운로드 링크 설치 지침 AWS JSON 1.0
Ruby aws/aws-sdk-ruby 다운로드 링크 설치 지침 AWS JSON 1.0
Powershell 다운로드 링크 설치 지침 AWS JSON 1.0
Rust awslabs/aws-sdk-rust 다운로드 링크 설치 지침 RPC v2 CBOR
Swift awslabs/aws-sdk-swift 다운로드 링크 설치 지침 RPC v2 CBOR
Kotlin awslabs/aws-sdk-kotlin 다운로드 링크 설치 지침 RPC v2 CBOR

CloudWatch 워크로드에 대해 이러한 새 프로토콜을 활성화할 경우 어떤 위험이 있나요?

AWS 쿼리 기반(XML 기반) 응답을 생성하는 CloudWatch와 상호 작용하기 위해 SDK의 AWS 사용자 지정 구현 또는 사용자 지정 클라이언트와 AWS SDK의 조합을 사용하는 경우 AWS JSON 또는 CBOR 프로토콜과 호환되지 않을 수 있습니다. 다른 문제가 발생하면 AWS Support에 문의하세요.

이미 최신 AWS SDK 버전을 사용하고 있는데 오픈소스 솔루션이 JSON 또는 CBOR을 지원하지 않으면 어떻게 되나요?

SDK 버전을 이전 버전으로 변경해야 합니다. CloudWatch의 최신 프로토콜을 시작하고 나열된 것보다 낮은 버전을 선택하는 방법은 CloudWatch의 최신 프로토콜을 시작하려면 어떻게 해야 하나요? 섹션을 참조하세요. AWS SDK를 이전 버전으로 변경하면 CloudWatch API가 AWS 쿼리 프로토콜을 사용합니다.

CloudWatch API에서 사용되는 AWS JSON 및 CBOR 프로토콜이 지원되는 리전

CloudWatch는 CloudWatch를 사용할 수 있는 모든 AWS 리전에서 AWS JSON 및 CBOR 프로토콜을 지원합니다.

최신 프로토콜을 사용하여 CloudWatch용 특정 AWS SDK 버전으로 업그레이드할 때 어떤 지연 시간 개선을 기대할 수 있나요?

JSON 및 CBOR 모두 AWS 쿼리에 비해 지연 시간을 50~80% 개선합니다. 클라이언트의 경우 CBOR이 50% 더 빠릅니다. 두 프로토콜 모두 네트워크 대역폭 사용 측면에서 10~20% 더 효율적입니다.

AWS 쿼리 프로토콜은 더 이상 사용되지 않을 예정인가요?

AWS 쿼리 프로토콜은 계속 지원될 예정입니다. CloudWatch용 AWS JSON 프로토콜을 시작하려면 어떻게 해야 하나요?에 나열된 버전 이외의 이전 버전으로 AWS SDK 버전이 설정되어 있는 한 AWS 쿼리 프로토콜을 계속 사용할 수 있습니다.

AWS JSON 및 Smithy RPC v2 CBOR 프로토콜에 대한 자세한 내용은 어디에서 찾을 수 있나요?

Smithy 설명서의 AWS JSON 1.0 프로토콜에서 JSON 프로토콜에 대한 자세한 내용을 확인할 수 있습니다.

CloudWatch API 요청에 대한 자세한 내용은 CloudWatch API 참조 안내서의 Making API Requests를 참조하세요.