Skip to main content

확장 대상

  • SpanBase

접근자

모델

조회 시그니처

get model(): string
string

name

조회 시그니처

get name(): string
string

메서드

addEvent()

사용 중단. 이 데이터는 setAttributes를 통해 기록하세요. OpenTelemetry는 Span Event API(Span.addEvent)를 단계적으로 중단하고 있습니다. 이 방법은 여전히 작동하며 기존 span-event 데이터는 유효합니다. See https://opentelemetry.io/blog/2026/deprecating-span-events/
addEvent(name, attributes?, startTime?): this
span에 이름이 지정된 이벤트를 추가합니다. context compaction, tool-loop detection 또는 가드레일 trips와 같은 non-span 순간을 표시하는 데 유용합니다. end() 이후에는 경고하고 아무 작업도 수행하지 않습니다. OTel Span.addEvent를 미러링합니다.

매개변수

string
필수
Attributes
TimeInput

반환값

this

예시

상속됨

SpanBase.addEvent

end()

end(opts?): void
현재 필드 값을 조회하고(start 이후 record()를 통해 이루어진 변경 사항을 반영하기 위해) span을 종료합니다. 멱등성을 보장합니다. 실패로 표시하려면 error를 전달하고, 종료 시간을 과거로 지정하려면 endTime을 전달하세요.

매개변수

object

반환값

void

record()

record(opts): this
변경 가능한 필드 중 원하는 필드를 일괄 설정합니다. 기존 값과 병합하지 않고 대체합니다. 입력 및 출력 메시지는 span이 종료될 때 직렬화됩니다.

매개변수

object
필수

반환값

this

setAttributes()

setAttributes(attributes): this
span에 여러 속성을 한 번에 설정합니다. end() 이후에는 경고를 표시하고 아무 작업도 수행하지 않습니다. OTel Span.setAttributes(및 Python SDK의 set_attributes)와 동일하게 동작합니다.

매개변수

Attributes
필수

반환값

this

예시

상속됨

SpanBase.setAttributes

startLLM()

startLLM(opts): LLM
이 서브에이전트 아래에 중첩되는 자식 LLM span을 시작합니다.

매개변수

LLMInit
필수
LLMInit를 참조하세요.

반환값

LLM

startSubagent()

startSubagent(opts): SubAgent
이 서브에이전트 아래에 중첩된 서브에이전트 span을 시작합니다.

매개변수

SubAgentInit
필수
SubAgentInit를 참조하세요.

반환값

SubAgent

startTool()

startTool(opts): Tool
이 서브에이전트 아래에 중첩된 자식 도구 span을 시작합니다.

매개변수

ToolInit
필수
ToolInit를 참조하세요.

반환값

Tool
마지막 수정일 2026년 9월 30일