Nâng cấp @opentelemetry/core từ 1.x lên 2.x

So sánh API công khai của @opentelemetry/core 1.30.1 và 2.11.0, được tính tự động từ kiểu TypeScript. Chữ ký thay đổi là thay đổi có thể không tương thích, không phải điều chắc chắn.

Tóm tắt

Đường dẫn import bị xóa	0
Export bị xóa	26
Chữ ký thay đổi	5
Thành viên lớp hoặc interface bị xóa	3
Thành viên lớp hoặc interface thay đổi	1
Mới bị ngừng hỗ trợ	4
Thay đổi yêu cầu (engines, phụ thuộc peer)	1
Export mới	7

Export bị xóa

import	export	kind	Trước
`@opentelemetry/core`	`getEnv`	function	`(): Required<ENVIRONMENT>`
`@opentelemetry/core`	`VERSION`	variable	`"1.30.1"`
`@opentelemetry/core`	`isWrapped`	function	`(func: unknown): func is ShimWrapped`
`@opentelemetry/core`	`ENVIRONMENT`	type	{ CONTAINER_NAME?: string \| undefined; ECS_CONTAINER_METADATA_URI_V4?: string \| undefined; ECS_CONTAINER_METADATA_URI?: string \| undefined; HOSTNAME?: string \| undefined; KUBERNETES_SERVICE_HOST?: string \| undefined; NAMESPACE?: string \| undefined; OTEL_EXPORTER_JAEGER_AGENT_HOST?: string \| undefined; OTEL_EXPORTER_JAEGER_ENDPOINT?: string \| undefined; OTEL_EXPORTER_JAEGER_PASSWORD?: string \| undefined; OTEL_EXPORTER_JAEGER_USER?: string \| undefined; OTEL_EXPORTER_OTLP_ENDPOINT?: string \| undefined; OTEL_EXPORTER_OTLP_TRACES_ENDPOINT?: string \| undefined; OTEL_EXPORTER_OTLP_METRICS_ENDPOINT?: …
`@opentelemetry/core`	`IdGenerator`	interface	`interface`
`@opentelemetry/core`	`ShimWrapped`	interface	`interface`
`@opentelemetry/core`	`hexToBase64`	function	`(hexStr: string): string`
`@opentelemetry/core`	`hexToBinary`	function	`(hexStr: string): Uint8Array<ArrayBufferLike>`
`@opentelemetry/core`	`baggageUtils`	variable	`{ getKeyPairs: (baggage: Baggage) => string[]; serializeKeyPairs: (keyPairs: string[]) => string; parseKeyPairsIntoRecord: (value?: string \| undefined) => Record<string, string>; parsePairKeyValue: (entry: string) => ParsedBaggageKeyValue \| undefined; }`
`@opentelemetry/core`	`isAttributeKey`	function	`(key: unknown): key is string`
`@opentelemetry/core`	`AlwaysOnSampler`	class	`class`
`@opentelemetry/core`	`RAW_ENVIRONMENT`	type	`{ [key: string]: string \| number \| string[] \| undefined; }`
`@opentelemetry/core`	`AlwaysOffSampler`	class	`class`
`@opentelemetry/core`	`TimeOriginLegacy`	interface	`interface`
`@opentelemetry/core`	`parseEnvironment`	function	`(values: RAW_ENVIRONMENT): ENVIRONMENT`
`@opentelemetry/core`	`RandomIdGenerator`	class	`class`
`@opentelemetry/core`	`ParentBasedSampler`	class	`class`
`@opentelemetry/core`	`DEFAULT_ENVIRONMENT`	variable	`Required<ENVIRONMENT>`
`@opentelemetry/core`	`TracesSamplerValues`	enum	`TracesSamplerValues`
`@opentelemetry/core`	`getEnvWithoutDefaults`	function	`(): ENVIRONMENT`
`@opentelemetry/core`	`InstrumentationLibrary`	interface	`interface`
`@opentelemetry/core`	`TraceIdRatioBasedSampler`	class	`class`
`@opentelemetry/core`	`DEFAULT_ATTRIBUTE_COUNT_LIMIT`	variable	`128`
`@opentelemetry/core`	`DEFAULT_ATTRIBUTE_VALUE_LENGTH_LIMIT`	variable	`number`
`@opentelemetry/core`	`DEFAULT_SPAN_ATTRIBUTE_PER_LINK_COUNT_LIMIT`	variable	`128`
`@opentelemetry/core`	`DEFAULT_SPAN_ATTRIBUTE_PER_EVENT_COUNT_LIMIT`	variable	`128`

Chữ ký thay đổi

export	Trước	Sau
`@opentelemetry/core · SDK_INFO`	`{ "telemetry.sdk.name": string; "process.runtime.name": string; "telemetry.sdk.language": string; "telemetry.sdk.version": string; }`	`{ "telemetry.sdk.name": string; "process.runtime.name": string; "telemetry.sdk.language": "nodejs"; "telemetry.sdk.version": string; }`
`@opentelemetry/core · unrefTimer`	`(timer: NodeJS.Timer): void`	`(timer: number \| { unref(): unknown; }): void`
`@opentelemetry/core · otperformance`	`any`	`{ now(): number; readonly timeOrigin: number; }`
`@opentelemetry/core · isAttributeValue`	`(val: unknown): val is SpanAttributeValue`	`(val: unknown): val is AttributeValue`
`@opentelemetry/core · sanitizeAttributes`	`(attributes: unknown): SpanAttributes`	`(attributes: unknown): Attributes`

Thành viên lớp hoặc interface bị xóa

member	import	Trước
`TraceState._keys`	`@opentelemetry/core`	`any`
`TraceState._clone`	`@opentelemetry/core`	`any`
`TraceState._parse`	`@opentelemetry/core`	`any`

Thành viên lớp hoặc interface thay đổi

member	Trước	Sau
`BindOnceFuture.constructor`	`<R, This = unknown, T extends (this: This, ...args: unknown[]) => R = () => R>(_callback: T, _that: This): BindOnceFuture<R, This, T>`	`<R, This = unknown, T extends (this: This, ...args: unknown[]) => R = () => R>(callback: T, that: This): BindOnceFuture<R, This, T>`

Mới bị ngừng hỗ trợ

export	@deprecated
`@opentelemetry/core · unrefTimer`	please copy this code to your implementation instead, this function will be removed in the next major version of this package.
`@opentelemetry/core · _globalThis`	Use globalThis directly instead.
`@opentelemetry/core · getTimeOrigin`	Use `performance.timeOrigin` directly.
`@opentelemetry/core · otperformance`	Use performance directly.

Thay đổi yêu cầu (engines, phụ thuộc peer)

	Trước	Sau
`engines.node`	`>=14`	`^18.19.0 \|\| >=20.6.0`

Export mới (7)

import	export	kind
`@opentelemetry/core`	`hrTimeToSeconds`	function
`@opentelemetry/core`	`getNumberFromEnv`	function
`@opentelemetry/core`	`getStringFromEnv`	function
`@opentelemetry/core`	`getBooleanFromEnv`	function
`@opentelemetry/core`	`getStringListFromEnv`	function
`@opentelemetry/core`	`diagLogLevelFromString`	function
`@opentelemetry/core`	`parseKeyPairsIntoRecord`	function

Câu hỏi thường gặp

Nâng cấp @opentelemetry/core từ 1 lên 2 có những thay đổi không tương thích nào?

Giữa @opentelemetry/core 1.30.1 và 2.11.0, Vigia tìm thấy 26 export bị xóa, 5 chữ ký thay đổi và 4 thành viên lớp hoặc interface bị xóa hay thay đổi.

Những gì bị ngừng hỗ trợ trong @opentelemetry/core 2?

4 export hoặc thành viên mới bị đánh dấu ngừng hỗ trợ trong @opentelemetry/core 2.11.0.

Dành cho tác tử

GET https://vigia.coredls.cloud/v1/packages/npm/@opentelemetry/core/upgrade?from=1.30.1&to=2.11.0