Azure Monitor OpenTelemetry Exporter ügyfélkódtár JavaScripthez – 1.0.0-beta.23-es verzió
Első lépések
Ez az exportőr csomag feltételezi, hogy az alkalmazás már az OpenTelemetry SDK-val van kialakítva . Miután készen áll az OpenTelemetry-adatok exportálására, hozzáadhatja ezt az exportőrt az alkalmazáshoz.
A csomag telepítése
npm install @azure/monitor-opentelemetry-exporter
Jelenleg támogatott környezetek
További részletekért tekintse meg támogatási szabályzatunkat .
Figyelmeztetés: Ez az SDK csak Node.js környezetekben működik. Használja az Application Insights JavaScript SDK-t böngészőkörnyezetekhez.
Előfeltételek
Elosztott nyomkövetés
Adja hozzá az exportőrt a meglévő OpenTelemetry Tracer-szolgáltatóhoz (NodeTracerProvider
/ BasicTracerProvider
)
const { AzureMonitorTraceExporter } = require("@azure/monitor-opentelemetry-exporter");
const { BatchSpanProcessor } = require("@opentelemetry/sdk-trace-base");
const { NodeTracerProvider } = require("@opentelemetry/sdk-trace-node");
const { Resource } = require("@opentelemetry/resources");
const { SemanticResourceAttributes } = require("@opentelemetry/semantic-conventions");
const tracerProvider = new NodeTracerProvider({
resource: new Resource({
[SemanticResourceAttributes.SERVICE_NAME]: "basic-service",
}),
});
// Register Tracer Provider as global
tracerProvider.register();
// Create an exporter instance
const exporter = new AzureMonitorTraceExporter({
connectionString:
process.env["APPLICATIONINSIGHTS_CONNECTION_STRING"] || "<your connection string>"
});
// Add the exporter to the Provider
tracerProvider.addSpanProcessor(
new BatchSpanProcessor(exporter, {
bufferTimeout: 15000,
bufferSize: 1000
})
);
Mérőszámok
Adja hozzá az exportőrt a meglévő OpenTelemetry Meter Providerhez (MeterProvider
)
const { metrics } = require("@opentelemetry/api");
const { MeterProvider, PeriodicExportingMetricReader } = require("@opentelemetry/sdk-metrics");
const { AzureMonitorMetricExporter } = require("@azure/monitor-opentelemetry-exporter");
// Add the exporter into the MetricReader and register it with the MeterProvider
const exporter = new AzureMonitorMetricExporter({
connectionString:
process.env["APPLICATIONINSIGHTS_CONNECTION_STRING"] || "<your connection string>",
});
const metricReaderOptions = {
exporter: exporter,
};
const metricReader = new PeriodicExportingMetricReader(metricReaderOptions);
const meterProvider = new MeterProvider();
meterProvider.addMetricReader(metricReader);
// Register Meter Provider as global
metrics.setGlobalMeterProvider(meterProvider);
Naplók
Adja hozzá a naplóexportálót a meglévő OpenTelemetry Logger-szolgáltatóhoz (LoggerProvider
)
const { logs } = require("@opentelemetry/api-logs");
const { LoggerProvider, BatchLogRecordProcessor } = require("@opentelemetry/sdk-logs");
const { AzureMonitorLogExporter } = require("@azure/monitor-opentelemetry-exporter");
// Add the Log exporter into the logRecordProcessor and register it with the LoggerProvider
const exporter = new AzureMonitorLogExporter({
connectionString:
process.env["APPLICATIONINSIGHTS_CONNECTION_STRING"] || "<your connection string>",
});
const logRecordProcessor = new BatchLogRecordProcessor(exporter);
const loggerProvider = new LoggerProvider();
loggerProvider.addLogRecordProcessor(logRecordProcessor);
// Register logger Provider as global
logs.setGlobalLoggerProvider(loggerProvider);
Mintavételezés
Engedélyezheti a mintavételezést a kapott telemetriai rekordok mennyiségének korlátozásához. A helyes mintavételezés az Application Insightsban való engedélyezéséhez használja az ApplicationInsightsSampler
alábbit.
const { ApplicationInsightsSampler } = require("@azure/monitor-opentelemetry-exporter");
const { BatchSpanProcessor } = require("@opentelemetry/sdk-trace-base");
const { NodeTracerProvider } = require("@opentelemetry/sdk-trace-node");
const { Resource } = require("@opentelemetry/resources");
const { SemanticResourceAttributes } = require("@opentelemetry/semantic-conventions");
// Sampler expects a sample rate of between 0 and 1 inclusive
// A rate of 0.75 means approximately 75 % of your traces will be sent
const aiSampler = new ApplicationInsightsSampler(0.75);
const provider = new NodeTracerProvider({
sampler: aiSampler,
resource: new Resource({
[SemanticResourceAttributes.SERVICE_NAME]: "basic-service",
}),
});
provider.register();
Példák
Néhány bajnoki forgatókönyv teljes mintáit a samples/
mappában találja.
Fő fogalmak
Az OpenTelemetry projektről további információt az OpenTelemetry specifications (OpenTelemetry-specifikációk) című témakörben talál.
Hibaelhárítás
Hibakeresési naplózás engedélyezése
A hibakeresési naplózást a szolgáltató naplózási szintjének módosításával engedélyezheti.
const { DiagConsoleLogger, DiagLogLevel, diag } = require("@opentelemetry/api");
const { NodeTracerProvider } = require("@opentelemetry/sdk-trace-node");
const provider = new NodeTracerProvider();
diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.ALL);
provider.register();
Következő lépések
Ezt az exportőrt az OpenTelemetry JS-hez kell használni.
Beépülő modul beállításjegyzéke
Ha tudni szeretné, hogy már készült-e beépülő modul az Ön által használt kódtárhoz, tekintse meg az OpenTelemetry Registryt.
Ha nem tudja a kódtárat a beállításjegyzékben, nyugodtan javasoljon egy új beépülő modulra vonatkozó kérést a következő címen: opentelemetry-js-contrib
.
Közreműködés
Ha hozzá szeretne járulni ehhez a kódtárhoz, olvassa el a közreműködői útmutatót , amelyből többet is megtudhat a kód buildeléséhez és teszteléséhez.
Azure SDK for JavaScript