다음을 통해 공유

추적 및 관찰 가능성

DevUI는 에이전트 프레임워크에서 내보낸 OTel(OpenTelemetry) 추적을 캡처하고 표시하기 위한 기본 제공 지원을 제공합니다. DevUI는 자체 범위를 만들지 않습니다. 에이전트 및 워크플로 실행 중에 에이전트 프레임워크에서 내보내는 범위를 수집한 다음 디버그 패널에 표시합니다. 이렇게 하면 에이전트 동작을 디버그하고, 실행 흐름을 이해하고, 성능 문제를 식별할 수 있습니다.

준비 중

C#용 DevUI 설명서는 곧 제공될 예정입니다. 나중에 다시 확인하거나 개념 지침은 Python 설명서를 참조하세요.

추적 활성화

DevUI를 --tracing 플래그로 시작하여 추적 기능을 활성화합니다.

devui ./agents --tracing

이렇게 하면 에이전트 프레임워크 작업에 대해 OpenTelemetry 추적이 가능합니다.

DevUI에서 추적 보기

추적을 사용하도록 설정하면 DevUI 웹 인터페이스에 추적 정보가 표시됩니다.

  1. UI를 통해 에이전트 또는 워크플로 실행
  2. 디버그 패널 열기(개발자 모드에서 사용 가능)
  3. 다음을 보여 주는 추적 타임라인 보기:
    • 범위 계층 구조
    • 타이밍 정보
    • 에이전트/워크플로 이벤트
    • 도구 호출 및 결과

추적 구조체

에이전트 프레임워크는 GenAI에 대한 OpenTelemetry 의미 체계 규칙에 따라 추적을 내보낸다. 일반적인 추적에는 다음이 포함됩니다.

Agent Execution
    LLM Call
        Prompt
        Response
    Tool Call
        Tool Execution
        Tool Result
    LLM Call
        Prompt
        Response

워크플로의 경우 추적은 실행기를 통한 실행 경로를 표시합니다.

Workflow Execution
    Executor A
        Agent Execution
            ...
    Executor B
        Agent Execution
            ...

프로그래매틱 추적

DevUI를 serve()프로그래밍 방식으로 사용하는 경우 추적을 사용하도록 설정할 수 있습니다.

from agent_framework.devui import serve

serve(
    entities=[agent],
    tracing_enabled=True
)

외부 도구와 통합

DevUI는 에이전트 프레임워크에서 내보낸 추적을 캡처하고 표시하며 자체 범위를 만들지 않습니다. 다음은 다음과 같은 외부 관찰 도구로 내보낼 수 있는 표준 OpenTelemetry 추적입니다.

  • Jaeger
  • Zipkin
  • Azure Monitor
  • Datadog

외부 수집기로 추적을 내보내려면 환경 변수를 OTLP_ENDPOINT 설정합니다.

export OTLP_ENDPOINT="http://localhost:4317"
devui ./agents --tracing

OTLP 엔드포인트가 없으면 추적이 로컬로 캡처되고 DevUI 디버그 패널에만 표시됩니다.

에이전트 프레임워크의 관찰 가능성에 대한 자세한 내용은 다음을 참조하십시오.

다음 단계

  • Last updated on