네트워크 그래프

app.jamjet.dev/projects/<id>/graph의 네트워크 그래프는 시스템 내 에이전트들 간의 관계를 실시간으로 보여주는 캔버스입니다. 로그로는 답할 수 없는 질문들에 답합니다: 어떤 에이전트가 다른 어떤 에이전트에게 작업을 넘겼는지, 요청이 몇 번의 홉을 거쳤는지, 체인의 어느 지점에서 정책이 도구 호출을 차단했는지, 그리고 어떤 에이전트가 가장 많이 연결되어 있는지.

그래프 읽기

캔버스의 모든 노드는 명명된 에이전트를 나타냅니다 — agent()로 선언한 고유한 식별자입니다. 모든 엣지는 상호작용을 나타냅니다: 한 에이전트에서 다른 에이전트로의 도구 호출, 한 에이전트가 다른 에이전트의 범위 내에서 실행되는 동안 발생한 스팬, 또는 멀티 에이전트 워크플로우에서의 명시적 핸드오프.

노드 크기는 스팬 볼륨에 비례합니다. 더 두꺼운 엣지는 선택한 시간 창에서 두 에이전트 간 더 많은 상호작용을 의미합니다. 나가는 엣지가 없는 노드는 리프 에이전트입니다 — 컨텍스트를 소비하지만 더 이상 위임하지 않습니다.

노드를 클릭하면 에이전트 상세 패널이 열립니다: 현재 시간 창에서 해당 에이전트가 발생시킨 모든 스팬의 시간순 목록으로, 각각의 비용, 모델, 지연시간, 정책 결과를 포함합니다. 엣지를 클릭하면 엣지 상세 패널이 열립니다: 특정 에이전트 간 경계를 넘은 스팬의 하위 집합을 시간순으로 정렬한 것입니다.

시간 범위 설정

그래프 우측 상단의 시간 범위 선택기는 어떤 스팬을 포함할지 제어합니다. 사용 가능한 시간 창:

• 최근 1시간 — 기본값. 활발한 개발 중이거나 인시던트 분류 시 유용합니다.
• 최근 24시간 — 하루 트래픽의 광범위한 뷰.
• 최근 7일 — 아키텍처 검토 및 장기 실행 인시던트 분석.
• 사용자 지정 범위 — 원하는 시작 및 종료 시간을 선택. 그래프가 해당 창에 맞춰 재계산됩니다.

시간 범위를 좁히는 것은 인시던트를 격리하는 가장 효과적인 방법입니다: 비정상적인 동작이 발생한 정확한 간격으로 창을 설정한 다음, 어떤 에이전트가 활성화되었고 어떤 엣지가 활발했는지 검사하세요.

필터

캔버스 위에 세 가지 필터 컨트롤이 있습니다:

• 에이전트 필터 — 선택한 에이전트와 직접 연결된 이웃만 표시합니다. 많은 에이전트가 있고 하나의 서비스 경계에 집중하고 싶을 때 유용합니다.
• 사용자 필터 — 특정 최종 사용자에게 제공된 호출 체인만 표시합니다. SDK에서 사용자 컨텍스트가 설정되어 있어야 합니다. 사용자 필터가 활성화되면 해당 사용자와 연결된 스팬이 없는 엣지와 노드는 회색으로 표시됩니다.
• 환경 필터 — 프로세스 컨텍스트를 통해 스팬에 environment 태그를 지정한 경우, 그래프를 production, staging 또는 사용하는 다른 값으로 제한할 수 있습니다.

필터는 조합 가능합니다: 최근 24시간 동안 production 환경의 사용자 u_123을 동시에 표시할 수 있습니다.

코디네이터 스코어링 주석

호출 체인에 JamJet 오픈소스 코디네이터 노드가 포함되어 있으면, 대시보드는 이를 통과하는 엣지에 추가 주석을 렌더링합니다. 이 주석은 코디네이터가 어떤 다운스트림 에이전트에 위임할지 선택할 때 계산한 스코어링 델타, 즉 최상위 에이전트와 차선책 간의 수치 차이를 보여줍니다.

큰 델타는 코디네이터가 라우팅 결정에 높은 확신을 가졌음을 나타냅니다. 작은 델타는 근소한 차이였음을 의미하며, 다운스트림 에이전트가 저조한 성능을 보였다면 검토할 가치가 있습니다. 주석은 코디네이터가 구조화된 스코어링 스팬을 발행할 때만 표시되며, 순수한 휴리스틱 라우팅은 이를 생성하지 않습니다.

사용 사례

인시던트 사후 분석. 시간 범위를 인시던트 구간으로 설정하고 프로덕션 환경 필터를 적용하세요. 그래프는 어떤 에이전트가 관련되었고 어떤 엣지가 가장 많은 트래픽을 처리했는지 즉시 보여줍니다. 핫 엣지를 클릭하여 레이턴시가 급증하거나 정책이 도구 호출을 차단한 정확한 스팬을 찾을 수 있습니다.

아키텍처 검토. 프로덕션에서 7일 구간으로 전환하세요. 그래프는 설계한 것이 아니라 실제로 나타난 에이전트 토폴로지를 보여줍니다. 예상보다 높은 연결성을 가진 노드, 에이전트 간 순환, 활성 서브 오케스트레이터가 되어야 하는 리프 에이전트 등이 모두 드러납니다.

에이전트 간 의존성 추적. 시스템에 새 에이전트를 추가할 때, 처음 24시간 동안 그래프를 관찰하여 의도한 에이전트에 연결되고 연결되지 말아야 할 에이전트에 예기치 않게 도달하지 않는지 확인하세요.

사용자별 지원 티켓. 보고한 사용자의 ID로 사용자 필터를 적용하세요. 그래프는 해당 사용자의 요청을 처리한 호출 체인만 표시하여 무슨 일이 일어났는지, 어떤 순서로, 어디서 문제가 발생했는지 추적하기 쉽게 만듭니다.

다음 단계