@opentelemetry/core を 1.x から 2.x へアップグレード

@opentelemetry/core 1.30.1 と 2.11.0 の公開 API を、TypeScript の型から自動的に比較したものです。シグネチャの変更は破壊的変更の候補であり、確定ではありません。

概要

削除されたインポートパス	0
削除されたエクスポート	26
変更されたシグネチャ	5
削除されたクラス／インターフェースのメンバー	3
変更されたクラス／インターフェースのメンバー	1
新たに非推奨	4
要件の変更（engines、peer 依存関係）	1
新しいエクスポート	7

削除されたエクスポート

import	export	kind	変更前
`@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`

変更されたシグネチャ

export	変更前	変更後
`@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`

削除されたクラス／インターフェースのメンバー

member	import	変更前
`TraceState._keys`	`@opentelemetry/core`	`any`
`TraceState._clone`	`@opentelemetry/core`	`any`
`TraceState._parse`	`@opentelemetry/core`	`any`

変更されたクラス／インターフェースのメンバー

member	変更前	変更後
`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>`

新たに非推奨

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.

要件の変更（engines、peer 依存関係）

	変更前	変更後
`engines.node`	`>=14`	`^18.19.0 \|\| >=20.6.0`

新しいエクスポート (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

よくある質問

@opentelemetry/core を 1 から 2 にアップグレードする際の破壊的変更は？

@opentelemetry/core 1.30.1 と 2.11.0 の間で、Vigia は削除されたエクスポートを 26 件、変更されたシグネチャを 5 件、削除または変更されたクラス／インターフェースのメンバーを 4 件検出しました。

@opentelemetry/core 2 で非推奨になったものは？

@opentelemetry/core 2.11.0 では 4 件のエクスポートまたはメンバーが新たに非推奨になりました。

エージェント向け

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