Biblioteca de clientes AMQP do Azure Core para JavaScript – versão 4.3.2

  • Artigo

O pacote @azure/core-amqp fornece uma funcionalidade comum para bibliotecas JavaScript do Azure que usam o protocolo AMQP como as do Barramento de Serviço do Azure e dos Hubs de Eventos do Azure.

Introdução

Instalação

Instale esta biblioteca usando o npm da seguinte maneira:

npm install @azure/core-amqp

Ambientes com suporte no momento

Consulte nossa política de suporte para obter mais detalhes.

Principais conceitos

Alguns dos principais recursos da biblioteca AMQP do Azure Core são:

  • de autorização baseada em declarações
  • Request-Response link para enviar solicitação e receber resposta por AMQP
  • Tradução de erro de códigos de erro AMQP, juntamente com erros específicos para o Barramento de Serviço do Azure e hubs de eventos do Azure.
  • RetryPolicy para tentar novamente uma determinada operação se um erro repetível foi encontrado.

Próximas etapas

Você pode compilar e executar os testes localmente executando rushx test. Explore a pasta test para ver o uso e o comportamento avançados das classes públicas.

Solucionando problemas

A biblioteca core-amqp depende da biblioteca rhea-promise para gerenciar conexões e para enviar e receber eventos pelo protocolo amqp .

Log

Você pode definir a variável de ambiente AZURE_LOG_LEVEL como um dos seguintes valores para habilitar o registro em log para stderr:

  • prolixo
  • informação
  • aviso
  • erro

Você também pode definir o nível de log programaticamente importando o pacote @azure/agente e chamando a função setLogLevel com um dos valores de nível de log. Por exemplo, quando você define o nível de log como info, os logs gravados para níveis warning e error também são emitidos. Esse SDK segue as diretrizes do SDK do Azure para TypeScript ao determinar em qual nível fazer logon.

Ao definir um nível de log programaticamente ou por meio da variável de ambiente AZURE_LOG_LEVEL, todos os logs gravados usando um nível de log igual ou menor que o escolhido serão emitidos.

Como alternativa, você pode definir a variável de ambiente DEBUG para obter logs ao usar essa biblioteca. Isso pode ser útil se você também quiser emitir logs das dependências rhea-promise e rhea também.

Observação: AZURE_LOG_LEVEL, se definido, tem precedência sobre DEBUG. Não especifique nenhuma biblioteca de azure por meio de DEBUG ao especificar também AZURE_LOG_LEVEL ou chamar setLogLevel.

  • Obtendo apenas logs de depuração no nível de informações da biblioteca core-amqp.
export DEBUG=azure:core-amqp:info
  • Obtendo logs de depuração do core-amqp e da biblioteca de nível de protocolo.
export DEBUG=azure:core-amqp:*,rhea*
  • Se você não estiver interessado em exibir os dados brutos do evento (que consome uma grande quantidade de espaço em console/disco), você poderá definir a variável de ambiente DEBUG da seguinte maneira:
export DEBUG=azure:core-amqp:*,rhea*,-rhea:raw,-rhea:message
  • Se você estiver interessado apenas em erros e avisos de do SDK, poderá definir a variável de ambiente DEBUG da seguinte maneira:
export DEBUG=azure:core-amqp:(error|warning),rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

Fazer logon em um arquivo

  • Defina a variável de ambiente DEBUG conforme mostrado acima e execute o script de teste da seguinte maneira:
    • As instruções de log de seu script de teste vão para out.log e a instrução de registro em log do sdk vá para debug.log. 
      node your-test-script.js > out.log 2>debug.log
    • As instruções de registro em log do script de teste e do sdk vão para o mesmo arquivo out.log redirecionando stderr para stdout (&1) e, em seguida, redirecione stdout para um arquivo: 
      node your-test-script.js >out.log 2>&1
    • As instruções de registro em log do script de teste e do sdk vão para o mesmo arquivo out.log. 
      node your-test-script.js &> out.log

Contribuindo

Este projeto recebe contribuições e sugestões. A maioria das contribuições exige que você concorde com um CLA (Contrato de Licença de Colaborador) declarando que você tem o direito de, e realmente fazer, conceder-nos os direitos de usar sua contribuição. Para obter detalhes, visite https://cla.microsoft.com.

Ao enviar uma solicitação de pull, um CLA-bot determinará automaticamente se você precisa fornecer um CLA e decorar a PR adequadamente (por exemplo, rótulo, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios usando nosso CLA.

Se você quiser contribuir com essa biblioteca, leia o guia de contribuição para saber mais sobre como criar e testar o código.

Este projeto adotou oCódigo de Conduta de Software Livre da Microsoft. Para obter mais informações, consulte as perguntas frequentes sobre o Código de Conduta ou entre em contato com opencode@microsoft.com com perguntas ou comentários adicionais.

impressões