버셀 AI 게이트웨이, 세션 로그 추가

2분 버셀AI 게이트웨이세션 어피니티캐시
최근 30일 조회수 — 좋아요 —

핵심 요약

버셀이 AI 요청 흐름과 제공업체별 세션 어피니티, 캐시·비용 정보를 추적하는 세션 화면을 공개했다.

버셀 AI 게이트웨이, 세션 로그 추가 — 기사 주제를 표현한 AI 생성 개념 삽화
AI 생성 개념 삽화 · 실제 사건을 촬영한 사진이 아닙니다.

버셀(Vercel)이 AI 게이트웨이(AI Gateway) 로그에 요청을 대화 단위로 묶어 보여주는 ‘세션(Sessions)’ 화면을 추가했다. 새 화면에서는 세션 어피니티(session affinity)가 각 요청을 어느 제공업체로 보냈는지 추적할 수 있다. 코딩 에이전트나 앱이 여러 차례 호출한 모델의 흐름과 캐시 활용 상태를 한곳에서 확인하려는 기능이다.1

세션 목록의 각 행에는 Claude Code, Codex, Cursor처럼 세션을 실행한 클라이언트가 표시된다. 비용과 사용 모델, 제공업체뿐 아니라 전체 턴에서 입력 중 얼마가 캐시됐는지도 함께 나온다. 세션을 열면 캐시 적중률과 지속 시간, 요청 경로를 볼 수 있다. 요청 경로에는 턴마다 사용한 모델과 처리 시간이 기록되며, 현재 세션을 처리한 제공업체와 앞서 처리했던 제공업체도 표시된다.1

이 정보가 중요한 이유는 세션 어피니티의 동작 방식과 비용·성능의 관계를 로그에서 직접 살필 수 있기 때문이다. 버셀 설명에 따르면 세션 어피니티는 직전 턴을 처리한 제공업체로 다음 턴을 보내도록 작동한다. 같은 제공업체가 이미 프롬프트 대부분을 캐시에 보관하고 있을 가능성을 활용하는 방식이다. 따라서 한 세션이 한 제공업체에 계속 머물수록 각 프롬프트에서 캐시로 읽는 비중이 커진다.1

운영자는 턴 수, 클라이언트, 모델, 제공업체, 인증 방식, 비용을 기준으로 세션을 걸러낼 수 있다. 기본 최소 턴 필터를 해제하기 전에는 단일 턴 세션이 나타나지 않는다는 점은 확인이 필요하다.1

세션 어피니티는 텍스트와 채팅 요청에 기본 적용된다. 개발자가 요청을 직접 같은 세션으로 묶으려면 대화의 모든 요청에 providerOptions.gateway의 동일한 sessionId를 넣거나 같은 x-session-id 헤더를 보내면 된다. 두 값이 없는 요청은 대화 첫 부분의 지문을 바탕으로 자동 분류되며, 로그에는 지문 기반 세션으로 표시된다.1

Footnotes

  1. Vercel Blog, 「AI Gateway logs now show session affinity」 ↩ ↩2 ↩3 ↩4 ↩5

읽기 목록은 이 브라우저에 저장됩니다.

출처

  1. AI Gateway logs now show session affinity - Vercel — Vercel Blog

이 글은 위 출처를 근거로 자동 생성된 뒤 발행됐습니다. 원문을 함께 확인해 주세요. 교차 보도 없이 단독 출처로 작성됐습니다.