Perguntas frequentes sobre os protocolos com suporte por parte do CloudWatch
O CloudWatch agora é compatível com dois protocolos adicionais: AWS JSON 1.0
O que é o protocolo AWS JSON e como ele difere das solicitações e das respostas existentes da API do CloudWatch?
JSON é um dos métodos de conexão mais amplamente usados e aceitos para comunicação entre sistemas heterogêneos. O CloudWatch usa o formato JSON como meio de comunicação entre um cliente do AWS SDK (por exemplo, Java, Python, Golang e JavaScript) e o servidor do CloudWatch. Uma solicitação HTTP de uma operação da API do CloudWatch aceita entrada no formato JSON. A operação do CloudWatch é executada, e a resposta da execução é compartilhada de volta com o cliente do SDK no formato JSON. Comparado com a consulta da AWS, o JSON é mais eficiente para transportar dados entre o cliente e o servidor.
-
O protocolo AWS JSON do CloudWatch atua como um mediador entre o cliente e o servidor do CloudWatch.
-
O servidor não compreende a linguagem de programação na qual a operação do CloudWatch é criada, mas compreende o protocolo AWS JSON.
-
O protocolo AWS JSON do CloudWatch usa a serialização, que converte objeto para o formato JSON, e a desserialização, que converte o formato JSON para objeto, entre o cliente e o servidor do CloudWatch.
O que é o protocolo Smithy RPC v2 CBOR e como ele difere das solicitações e das respostas existentes da API do CloudWatch?
O Concise Binary Object Representation (CBOR) é um formato de dados com foco em eficiência e flexibilidade. Seus principais objetivos de projeto incluem tamanho de código extremamente pequeno, tamanho de mensagem compacto e extensibilidade independentemente da versão. O Smithy RPC v2 CBOR, um protocolo inventado pela Amazon, aproveita essas vantagens para possibilitar uma transmissão de dados mais eficiente. O RPC V2 CBOR implementa uma codificação binária em vez da codificação de texto em JSON, reduzindo o tamanho das cargas úteis e o tempo dedicado a serialização.
-
O protocolo RPC v2 CBOR do CloudWatch atua como um mediador entre o cliente e o servidor CloudWatch.
-
O servidor não compreende a linguagem de programação na qual a operação do CloudWatch é criada, mas compreende o protocolo RPC v2 CBOR.
-
O protocolo RPC v2 CBOR do CloudWatch usa a serialização, que converte objeto para o formato CBOR, e a desserialização, que converte o formato CBOR para objeto, entre o cliente e o servidor do CloudWatch.
Qual é o procedimento para começar a usar os protocolos mais recentes para o CloudWatch?
Os novos protocolos já estão disponíveis em uma versão de pré-visualização pública dos SDKs. É possível fazer o download dos SDKs seguindo as instruções apresentadas abaixo.
nota
Os problemas específicos apresentados a seguir estão presentes na versão de pré-visualização dos SDKs do CloudWatch listados abaixo. Usar este SDK em pré-visualização significa que esses problemas podem afetar sua integração. Planejamos resolver esses problemas antes da versão final.
Afetando todos os SDKs: a versão de pré-visualização remove os valores nulos finais das listas. Na versão final, esses valores serão serializados adequadamente.
Específico para SDK para Java v1: a versão de pré-visualização não realiza a serialização de listas vazias. Na versão final, as listas vazias serão serializadas adequadamente.
Quais são os riscos de habilitar esses novos protocolos para minhas workloads do CloudWatch?
Se você estiver usando uma implementação personalizada do AWS SDK ou uma combinação de clientes personalizados e o AWS SDK para interagir com o CloudWatch, gerando respostas baseadas no AWS Query (também conhecidas como XML), a implementação ou a combinação podem ser incompatíveis com o protocolo AWS JSON ou CBOR. Se você encontrar algum problema, entre em contato com o AWS Support.
Caso eu já esteja usando a versão mais recente do AWS SDK, mas minha solução de código aberto não é compatível com os formatos JSON ou CBOR, o que devo fazer?
Você precisa alterar a versão do seu SDK para uma versão anterior. Consulte Qual é o procedimento para começar a usar os protocolos mais recentes para o CloudWatch? para saber como começar a usar os protocolos mais recentes do CloudWatch e selecionar uma versão anterior à listada. Se você alterar o AWS SDK para a versão anterior, suas APIs do CloudWatch usarão o protocolo AWS Query.
Quais regiões são compatíveis com os protocolos AWS JSON e CBOR usados nas APIs do CloudWatch?
O CloudWatch fornece suporte aos protocolos AWS JSON e CBOR em todas as regiões da AWS nas quais o CloudWatch está disponível.
Quais melhorias relacionadas à latência posso esperar ao atualizar para as versões especificadas do AWS SDK para o CloudWatch usando os protocolos mais recentes?
Tanto o protocolo JSON quanto o protocolo CBOR oferecem uma melhoria de latência de 50% a 80% em comparação com o protocolo AWS Query. O protocolo CBOR é 50% mais rápido para o cliente. Ambos os protocolos são de 10% a 20% mais eficientes no uso da largura de banda da rede.
O protocolo de consulta da AWS está obsoleto?
O protocolo de consulta da AWS continuará compatível. Você pode continuar usando o protocolo AWS Query, desde que a versão do seu AWS SDK esteja definida como qualquer versão anterior, diferente da listada em “How do I get started with AWS JSON protocols for CloudWatch”.
Em qual local é possível encontrar mais informações sobre os protocolos AWS JSON e Smithy RPC v2 CBOR?
Você pode encontrar mais informações sobre o protocolo JSON em AWS JSON 1.0
Para obter mais informações sobre solicitações da API do CloudWatch, consulte Making API Requests no Guia de referência da API do CloudWatch.
