FAQs sur les protocoles CloudWatch pris en charge - Amazon CloudWatch

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

FAQs sur les protocoles CloudWatch pris en charge

CloudWatch SDKs a commencé à utiliser deux protocoles supplémentaires : AWS JSON 1.1 et Smithy RPC v2 CBOR. Ces protocoles sont plus performants que AWS Query qui était auparavant utilisé par le CloudWatch SDKs et CLIs. AWS SDKs priorisera le protocole le plus performant pour chaque langue.

Qu'est-ce que le protocole AWS JSON et en quoi diffère-t-il des demandes et réponses d' CloudWatch API existantes ?

Le JSON est l'un des formats de données les plus utilisés et les plus acceptés pour la communication entre des systèmes hétérogènes. CloudWatch utilise le JSON comme moyen de communication entre un client AWS SDK (par exemple, Java, Python, Golang JavaScript) et CloudWatch un serveur. Une requête HTTP d'une opération d' CloudWatch API accepte une entrée sous forme de JSON. L' CloudWatch opération est exécutée et la réponse d'exécution est partagée avec le client du SDK sous forme de JSON. Comparé à AWS Query, le format JSON est plus efficace pour transporter les données entre le client et le serveur.

  • CloudWatch AWS Le protocole JSON joue le rôle de médiateur entre CloudWatch le client et le serveur.

  • Le CloudWatch AWS SDK gère la sérialisation (conversion de l'objet au format JSON) et la désérialisation (conversion du format JSON en objet) entre le client et le CloudWatch serveur.

Qu'est-ce que le protocole CBOR Smithy RPC v2 et en quoi diffère-t-il des demandes et réponses d' CloudWatch API existantes ?

Smithy RPC v2 CBOR (Concise Binary Object Representation) est un protocole développé par Amazon pour une transmission de données plus efficace. Il s'agit d'un format de données conçu pour réduire la taille des messages et permettre au format d'évoluer sans nécessiter de négociation de version entre les systèmes. La principale différence avec le codage JSON est que le JSON utilise du texte lisible par l'homme (comme « name » : « John »), tandis que CBOR utilise un format binaire (séquences de 1 et de 0). Cette approche binaire crée des paquets de données plus petits qui voyagent plus rapidement sur le réseau et réduit le temps de sérialisation puisque les ordinateurs traitent directement les données binaires.

  • CloudWatch Le protocole RPC v2 CBOR agit comme un médiateur entre le CloudWatch client et le serveur.

  • Le CloudWatch SDK gère la sérialisation (conversion de l'objet au format CBOR) et la désérialisation (conversion du format CBOR en objet) entre le client et le serveur. CloudWatch

Comment puis-je commencer à utiliser les nouveaux protocoles pour CloudWatch ?

Pour commencer, utilisez la dernière version du AWS SDK/CLI afin d'utiliser le dernier protocole pris en charge pour. CloudWatch Mettez à niveau votre AWS SDK vers la version spécifiée ou vers une version ultérieure.

Prise en charge du protocole client du kit SDK
Language Protocole Versions SDK
C++ RPC v2 CBOR 1,11,708
Golang 2.x RPC v2 CBOR 1,53,0
Java 1.x AWS JSON 1.1 1,12,795
Java 2.x RPC v2 CBOR 2,40,6
JavaScript v3.x AWS JSON 1.1 3,949,0
.NET v3 AWS JSON 1.1 3,7,1182,0
.NET version 4 RPC v2 CBOR 4,0.150.0
PHP AWS JSON 1.1 3,367,0
Python-boto3 AWS JSON 1.1 1,42,7
Python-botocore AWS JSON 1.1 1,42,7
AWS CLI v1 AWS JSON 1.1 1,43,13
AWS CLI v2 AWS JSON 1.1 2,32,14
Ruby AWS JSON 1.1 1,126,0
Powershell AWS JSON 1.1 5,0,114
Rust RPC v2 CBOR 1,100,0
Swift RPC v2 CBOR 1.6,14
Kotlin RPC v2 CBOR 1,5,100

Quels sont les risques liés à l'activation de ces nouveaux protocoles pour mes CloudWatch charges de travail ?

La migration vers ces nouvelles versions du SDK devrait être totalement transparente et sans effort pour les clients. Il existe un changement de comportement connu entre les protocoles lié à la façon dont null les valeurs sont traitées dans les listes : les appels d' CloudWatch API avec des entrées de liste susceptibles de contenir des null valeurs seront traités différemment dans les protocoles AWS JSON et Smithy RPC v2 CBOR par rapport au protocole AWS Query précédent : dans le protocole AWS Query, les valeurs nulles des listes sont supprimées, tandis que dans les JSON/CBOR protocoles seront propagées via les appels d'API.

De plus, si vous utilisez une implémentation personnalisée du AWS SDK ou une combinaison de clients personnalisés et de AWS SDK avec lesquels interagir et CloudWatch qui génère des réponses basées sur des AWS requêtes (également appelées XML), cela peut être incompatible avec AWS le protocole JSON ou CBOR. Si vous rencontrez des problèmes, contactez le AWS Support.

Et si j'utilise déjà la dernière version du AWS SDK, mais que ma solution open source ne prend pas en charge le JSON ou le CBOR ?

Vous devez changer votre version du kit SDK pour une version antérieure. Consultez la Comment puis-je commencer à utiliser les nouveaux protocoles pour CloudWatch ? section et sélectionnez une version inférieure à celle répertoriée. Si vous remplacez votre AWS SDK par la version précédente, vous CloudWatch APIs utiliserez le protocole AWS Query.

Quelles sont les régions prises en charge pour les protocoles AWS JSON et CBOR utilisés dans CloudWatch APIs

CloudWatch prend en charge les protocoles AWS JSON et CBOR dans toutes les AWS régions où il CloudWatch est disponible.

À quelles améliorations de latence puis-je m'attendre lors de la mise à niveau vers les versions du AWS SDK spécifiées pour CloudWatch utiliser les nouveaux protocoles ?

Le JSON et le CBOR réduisent jusqu'à 80 % la latence et l'utilisation du processeur par rapport à la AWS requête. Les deux protocoles sont jusqu'à 20 % plus efficaces en termes d'utilisation de la bande passante du réseau.

Le protocole AWS Query sera-t-il obsolète ?

AWS Le protocole de requête continuera d'être pris en charge. Vous pouvez continuer à utiliser le protocole AWS Query tant que la version de votre AWS SDK est définie avant celle répertoriée dansComment puis-je commencer à utiliser les nouveaux protocoles pour CloudWatch ?.

Où puis-je trouver plus d'informations sur les protocoles CBOR AWS JSON et Smithy RPC v2 ?

Vous trouverez plus d'informations sur le protocole JSON au protocole AWS JSON 1.1 dans la documentation Smithy, et sur le protocole CBOR at AWS RPC v2 CBOR dans la documentation Smithy.

Pour en savoir plus sur les demandes d' CloudWatch API, consultez la section Création de demandes d' CloudWatch API dans le Guide de référence des API.