Aggiornare @opentelemetry/core da 1.x a 2.x

Confronto dell’API pubblica di @opentelemetry/core 1.30.1 e 2.11.0, calcolato automaticamente dai tipi TypeScript. Una firma modificata è una possibile modifica incompatibile, non una certezza.

Riepilogo

Percorsi di import rimossi	0
Export rimossi	26
Firme modificate	5
Membri di classi o interfacce rimossi	3
Membri di classi o interfacce modificati	1
Nuove deprecazioni	4
Requisiti cambiati (engines, dipendenze peer)	1
Nuovi export	7

Export rimossi

import	export	kind	Prima
`@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`

Firme modificate

export	Prima	Dopo
`@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`

Membri di classi o interfacce rimossi

member	import	Prima
`TraceState._keys`	`@opentelemetry/core`	`any`
`TraceState._clone`	`@opentelemetry/core`	`any`
`TraceState._parse`	`@opentelemetry/core`	`any`

Membri di classi o interfacce modificati

member	Prima	Dopo
`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>`

Nuove deprecazioni

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.

Requisiti cambiati (engines, dipendenze peer)

	Prima	Dopo
`engines.node`	`>=14`	`^18.19.0 \|\| >=20.6.0`

Nuovi export (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

Domande frequenti

Quali sono le modifiche incompatibili aggiornando @opentelemetry/core da 1 a 2?

Tra @opentelemetry/core 1.30.1 e 2.11.0, Vigia ha trovato 26 export rimossi, 5 firme modificate e 4 membri di classi o interfacce rimossi o modificati.

Cosa è stato deprecato in @opentelemetry/core 2?

4 export o membri risultano ora deprecati in @opentelemetry/core 2.11.0.

Per gli agenti

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