서버 로그에 HTTP 헤더 포함하기

기본적으로 Agent Server는 개인정보 보호를 위해 서버 로그에서 HTTP 헤더를 생략해요. 하지만 요청 ID와 상관관계 ID(correlation ID)를 기록하면 분산 시스템에서 문제를 디버깅하고 요청을 추적하는 데 큰 도움이 됩니다. langgraph.json 파일의 logging_headers 섹션을 수정해서 모든 API 호출에 대해 헤더 로깅을 선택(opt-in)할 수 있어요.

출처: 문서

본문

기본적으로 Agent Server는 개인정보 보호를 이유로 서버 로그에서 HTTP 헤더를 생략합니다. 그러나 요청 ID와 상관관계 ID를 기록하면 문제를 디버깅하고 분산 시스템 전반에서 요청을 추적하는 데 도움이 될 수 있습니다. langgraph.json 파일의 logging_headers 섹션을 수정하여 모든 API 호출에 대해 헤더 로깅을 선택할 수 있습니다.

{
  "$schema": "https://langgra.ph/schema.json",
  "http": {
    "logging_headers": {
      "includes": ["request-id", "x-purchase-id", "*-trace-*"],
      "excludes": ["authorization", "x-api-key", "x-organization-id", "x-user-id"]
    }
  }
}

includes와 excludes 목록은 정확한 헤더 이름 또는 *를 와일드카드로 사용한 glob 패턴(임의 개수의 문자와 일치, 대소문자 구분 없음)을 허용합니다. 보안을 위해 다른 패턴 유형은 지원되지 않습니다.

제외(excludes)가 포함(includes)보다 우선한다는 점에 유의하세요. 예를 들어 *-id를 포함하고 x-user-id를 제외하면, x-user-id 헤더는 로그에 기록되지 않습니다.

더 알아보기

langgraph.json 구성 파일에 대한 자세한 내용은 Application structure 문서를 참고하세요.
Agent Server에 대한 더 자세한 내용은 Agent Server 문서를 확인해 보세요.