Condividi tramite


Libreria di traccia di Azure Core per JavaScript

Si tratta della libreria di traccia di base che fornisce interfacce di basso livello e metodi di supporto per l'analisi nelle librerie JavaScript di Azure SDK che funzionano nel browser e Node.js.

Introduttiva

Installazione

Questo pacchetto viene usato principalmente nelle librerie client di Azure e non deve essere usato direttamente dai consumer degli SDK di Azure.

Concetti chiave

  • TracingClient è l'interfaccia principale che fornisce funzionalità di traccia alle librerie client. Le librerie client devono essere a conoscenza e interagire solo con un'istanza TracingClient .
    • Un'implementazione TracingClient può essere creata utilizzando la createTracingClient funzione factory.
  • Instrumenter Fornisce un'astrazione su una strumentazione e funge da punto di interoperabilità per l'uso di librerie di terze parti come OpenTelemetry. Per impostazione predefinita, viene utilizzato un no-op Instrumenter . I clienti che desiderano abilitare OpenTelemetry la traccia basata possono installare e registrare il pacchetto @azure/opentelemetry-instrumentation-azure-sdk .
  • TracingContext è un contenitore di dati non modificabile , utilizzato per passare informazioni specifiche dell'operazione (ad esempio le informazioni sull'elemento padre span).
  • TracingSpan è un'astrazione di a Span che può essere utilizzata per registrare eventi, attributi ed eccezioni.

Esempi

Gli esempi possono essere trovati nella samples cartella.

Passaggi successivi

È possibile compilare ed eseguire i test in locale eseguendo npm run test. Esplorare la cartella per visualizzare l'utilizzo e il test comportamento avanzati delle classi pubbliche.

Risoluzione dei problemi

Se riscontri problemi durante l'utilizzo di questa libreria, non esitare a segnalare un problema.

Contribuire

Per contribuire a questa libreria, leggere la guida contribuire per altre informazioni su come compilare e testare il codice.