BaggageBuilder class

OpenTelemetry 컨텍스트 전파에 대한 요청별 수하물 작성기.

이 클래스는 OpenTelemetry 컨텍스트에서 전파될 수하물 값을 설정하기 위한 흐름 API를 제공합니다.

예시

const scope = new BaggageBuilder()
  .tenantId("tenant-123")
  .agentId("agent-456")
  .build();

scope.enter();
// Baggage is set in this context
// ... do work ...
scope.exit();
// Baggage is restored after exiting the context

메서드

agentAuid(undefined | null | string)

에이전트 AUID 수하물 값을 설정합니다.

agentBlueprintId(undefined | null | string)

에이전트 청사진 ID 수하물 값을 설정합니다.

agentDescription(undefined | null | string)

에이전트 설명 수하물 값을 설정합니다.

agentEmail(undefined | null | string)

에이전트 전자 메일 수하물 값을 설정합니다.

agentId(undefined | null | string)

에이전트 ID 수하물 값을 설정합니다.

agentName(undefined | null | string)

에이전트 이름 수하물 값을 설정합니다.

agentPlatformId(undefined | null | string)

에이전트 플랫폼 ID 수하물 값을 설정합니다.

agentVersion(undefined | null | string)

에이전트 버전 수하물 값을 설정합니다.

build()

수집된 수하물을 현재 컨텍스트에 적용합니다.

callerAgentPlatformId(undefined | null | string)

발신자 에이전트 플랫폼 ID 수하물 값을 설정합니다.

callerClientIp(undefined | null | string)

호출자 클라이언트 IP 수하물 값을 설정합니다. OpenTelemetry 수하물을 통해 전파할 수 있도록 요청에 대한 원래 클라이언트 IP를 캡처하는 데 사용됩니다.

channelLink(undefined | null | string)

채널 링크/URL을 설정합니다.

channelName(undefined | null | string)

채널 이름(예: Teams, Slack)을 설정합니다.

conversationId(undefined | null | string)

대화 ID 수하물 값을 설정합니다.

conversationItemLink(undefined | null | string)

대화 항목 링크 수하물 값을 설정합니다.

invokeAgentServer(undefined | null | string, number)

호출 에이전트 서버 주소 및 포트 수하물 값을 설정합니다.

operationSource(undefined | null | string)

작업 원본 수하물 값을 설정합니다. 서비스(예: ATG, ACF)를 식별하는 데 서버 범위에 사용됩니다.

sessionDescription(undefined | null | string)

세션 설명 수하물 값을 설정합니다.

sessionId(string)

세션 ID 수하물 값을 설정합니다.

setPairs(undefined | null | Record<string, any> | Iterable<[string, any]>)

사전 또는 반복에서 여러 수하물 쌍을 설정합니다.

setRequestContext(null | string, null | string)

공통 필드가 있는 요청 수하물 범위를 시작하는 편리한 방법입니다.

tenantId(undefined | null | string)

테넌트 ID 수하물 값을 설정합니다.

userEmail(undefined | null | string)

사용자 전자 메일 수하물 값을 설정합니다.

userId(undefined | null | string)

사용자 ID 수하물 값을 설정합니다.

userName(undefined | null | string)

사용자 이름 수하물 값을 설정합니다.

메서드 세부 정보

agentAuid(undefined | null | string)

에이전트 AUID 수하물 값을 설정합니다.

function agentAuid(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

에이전트 AUID

반품

메서드 체인에 대한 자체

agentBlueprintId(undefined | null | string)

에이전트 청사진 ID 수하물 값을 설정합니다.

function agentBlueprintId(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

에이전트 청사진 ID

반품

메서드 체인에 대한 자체

agentDescription(undefined | null | string)

에이전트 설명 수하물 값을 설정합니다.

function agentDescription(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

에이전트 설명

반품

메서드 체인에 대한 자체

agentEmail(undefined | null | string)

에이전트 전자 메일 수하물 값을 설정합니다.

function agentEmail(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

에이전트 이메일

반품

메서드 체인에 대한 자체

agentId(undefined | null | string)

에이전트 ID 수하물 값을 설정합니다.

function agentId(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

에이전트 ID

반품

메서드 체인에 대한 자체

agentName(undefined | null | string)

에이전트 이름 수하물 값을 설정합니다.

function agentName(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

에이전트 이름

반품

메서드 체인에 대한 자체

agentPlatformId(undefined | null | string)

에이전트 플랫폼 ID 수하물 값을 설정합니다.

function agentPlatformId(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

에이전트 플랫폼 ID

반품

메서드 체인에 대한 자체

agentVersion(undefined | null | string)

에이전트 버전 수하물 값을 설정합니다.

function agentVersion(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

에이전트 버전(예: '1.0.0', '2025-05-01')

반품

메서드 체인에 대한 자체

build()

수집된 수하물을 현재 컨텍스트에 적용합니다.

function build(): BaggageScope

반품

출구에서 이전 수하물을 복원하는 컨텍스트 관리자

callerAgentPlatformId(undefined | null | string)

발신자 에이전트 플랫폼 ID 수하물 값을 설정합니다.

function callerAgentPlatformId(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

호출자 에이전트 플랫폼 식별자

반품

메서드 체인에 대한 자체

callerClientIp(undefined | null | string)

호출자 클라이언트 IP 수하물 값을 설정합니다. OpenTelemetry 수하물을 통해 전파할 수 있도록 요청에 대한 원래 클라이언트 IP를 캡처하는 데 사용됩니다.

function callerClientIp(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

호출자 클라이언트 IP 주소

반품

메서드 체인에 대한 자체

채널 링크/URL을 설정합니다.

function channelLink(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

채널 링크

반품

메서드 체인에 대한 자체

channelName(undefined | null | string)

채널 이름(예: Teams, Slack)을 설정합니다.

function channelName(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

채널 이름

반품

메서드 체인에 대한 자체

conversationId(undefined | null | string)

대화 ID 수하물 값을 설정합니다.

function conversationId(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

대화 ID

반품

메서드 체인에 대한 자체

대화 항목 링크 수하물 값을 설정합니다.

function conversationItemLink(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

대화 항목 링크

반품

메서드 체인에 대한 자체

invokeAgentServer(undefined | null | string, number)

호출 에이전트 서버 주소 및 포트 수하물 값을 설정합니다.

function invokeAgentServer(address: undefined | null | string, port?: number): BaggageBuilder

매개 변수

address

undefined | null | string

대상 에이전트 서비스의 서버 주소(호스트 이름)입니다.

port

number

선택적 서버 포트입니다. 443과 다른 경우에만 기록됩니다.

반품

메서드 체인에 대한 현재 작성기 인스턴스입니다.

operationSource(undefined | null | string)

작업 원본 수하물 값을 설정합니다. 서비스(예: ATG, ACF)를 식별하는 데 서버 범위에 사용됩니다.

function operationSource(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

작업 원본

반품

메서드 체인에 대한 자체

sessionDescription(undefined | null | string)

세션 설명 수하물 값을 설정합니다.

function sessionDescription(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

세션 설명

반품

메서드 체인에 대한 자체

sessionId(string)

세션 ID 수하물 값을 설정합니다.

function sessionId(value: string): BaggageBuilder

매개 변수

value

string

세션 ID

반품

메서드 체인에 대한 자체

setPairs(undefined | null | Record<string, any> | Iterable<[string, any]>)

사전 또는 반복에서 여러 수하물 쌍을 설정합니다.

function setPairs(pairs: undefined | null | Record<string, any> | Iterable<[string, any]>): BaggageBuilder

매개 변수

pairs

undefined | null | Record<string, any> | Iterable<[string, any]>

키-값 쌍의 사전 또는 반복 가능

반품

메서드 체인에 대한 자체

setRequestContext(null | string, null | string)

공통 필드가 있는 요청 수하물 범위를 시작하는 편리한 방법입니다.

static function setRequestContext(tenantId?: null | string, agentId?: null | string): BaggageScope

매개 변수

tenantId

null | string

테넌트 ID

agentId

null | string

에이전트 ID

반품

출구에서 이전 수하물을 복원하는 컨텍스트 관리자

tenantId(undefined | null | string)

테넌트 ID 수하물 값을 설정합니다.

function tenantId(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

테넌트 ID

반품

메서드 체인에 대한 자체

userEmail(undefined | null | string)

사용자 전자 메일 수하물 값을 설정합니다.

function userEmail(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

사용자 전자 메일

반품

메서드 체인에 대한 자체

userId(undefined | null | string)

사용자 ID 수하물 값을 설정합니다.

function userId(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

사용자 ID

반품

메서드 체인에 대한 자체

userName(undefined | null | string)

사용자 이름 수하물 값을 설정합니다.

function userName(value: undefined | null | string): BaggageBuilder

매개 변수

value

undefined | null | string

사용자 이름입니다.

반품

메서드 체인에 대한 자체