Partilhar via

Biblioteca de cliente do Azure Core AMQP para JavaScript - versão 4.3.2

  • Artigo

O pacote @azure/core-amqp fornece 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.

Primeiros passos

Instalação

Instale esta biblioteca usando npm da seguinte maneira:

npm install @azure/core-amqp

Ambientes atualmente suportados

Consulte o nosso de política de suporte para obter mais detalhes.

Conceitos-chave

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

Próximos passos

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

Solução de problemas

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

Registo

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

  • Verborrágico
  • informação
  • Advertência
  • erro

Você também pode definir o nível de log programaticamente importando o pacote de @azure/logger e chamando a função com um dos valores de nível de log. Por exemplo, quando você define o nível de log como info, os logs que são gravados para os níveis warning e error também são emitidos. Este SDK segue as diretrizes de 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 inferior ao 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.

Nota: AZURE_LOG_LEVEL, se definido, tem precedência sobre DEBUG. Não especifique nenhuma azure bibliotecas via DEBUG ao especificar também AZURE_LOG_LEVEL ou chamar setLogLevel.

  • Obter apenas logs de depuração de nível de informação da biblioteca core-amqp.
export DEBUG=azure:core-amqp:info
  • Obter 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 no console/disco), 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 de e avisos de SDK, então você pode 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

Registrando em um arquivo

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

Contribuição

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

Quando você envia uma solicitação pull, um CLA-bot determinará automaticamente se você precisa fornecer um CLA e decorar o 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 para esta biblioteca, leia o guia de contribuição para saber mais sobre como criar e testar o código.

Este projeto adotou o Microsoft Open Source Code of Conduct. Para obter mais informações, consulte o de perguntas frequentes sobre o Código de Conduta ou entre em contato com para obter perguntas ou comentários adicionais.

Impressões