Partager via


Bibliothèque de suivi Azure Core pour JavaScript

Il s’agit de la bibliothèque de suivi principale qui fournit des interfaces de bas niveau et des méthodes d’assistance pour le suivi dans les bibliothèques JavaScript du SDK Azure qui fonctionnent dans le navigateur et Node.js.

Commencer

Installation

Ce package est principalement utilisé dans les bibliothèques clientes Azure et n’est pas destiné à être utilisé directement par les consommateurs de Kits de développement logiciel (SDK) Azure.

Concepts clés

  • TracingClient est l’interface principale fournissant une fonctionnalité de suivi aux bibliothèques clientes. Les bibliothèques clientes ne doivent connaître une instance et interagir qu’avec elle TracingClient .
    • Une TracingClient implémentation peut être créée à l’aide de la createTracingClient fonction factory.
  • Instrumenter fournit une abstraction sur une instrumentation et agit comme point d’interopérabilité pour l’utilisation de bibliothèques tierces telles qu’OpenTelemetry. Par défaut, un no-op Instrumenter est utilisé. Les clients qui souhaitent activer OpenTelemetry le traçage basé le feront en installant et en inscrivant le package @azure/opentelemetry-instrumentation-azure-sdk .
  • TracingContext est un conteneur de données immuable , utilisé pour transmettre des informations spécifiques à une opération (telles que les informations de parenté span).
  • TracingSpan est une abstraction de a Span qui peut être utilisée pour enregistrer des événements, des attributs et des exceptions.

Exemples

Vous trouverez des exemples dans le samples dossier.

Étapes suivantes

Vous pouvez générer et exécuter les tests localement en exécutant npm run test. Explorez le test dossier pour voir l’utilisation et le comportement avancés des classes publiques.

Dépannage

Si vous rencontrez des problèmes lors de l’utilisation de cette bibliothèque, n’hésitez pas à le signaler.

Contribuant

Si vous souhaitez contribuer à cette bibliothèque, lisez le guide de contribution pour en savoir plus sur la génération et le test du code.