실행 중 로그 수준 설정하기
클라이언트가 로그 상세도를 높이거나 낮출 수 있게 합니다.
실행 중 로그 수준 설정하기은(는) CoddyKit의 무료 MCP Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 MCP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
필요할 때만 자세히 보기
어떤 때는 조용한 로그가 필요하고, 어떤 때는 깊이 있는 세부 정보가 필요합니다. MCP를 사용하면 서버를 다시 시작하지 않고도 클라이언트가 실행 중에 로그 수준을 설정할 수 있습니다.
setLevel 요청
클라이언트는 원하는 최저 수준을 지정하는 logging/setLevel 요청을 보냅니다. 요청이므로 서버는 확인 응답을 보냅니다.
{"method": "logging/setLevel",
"params": {"level": "warning"}}기능 선언하기
서버가 초기화 핸드셰이크 중 logging 기능을 알린 경우에만 setLevel을 받을 수 있습니다. FastMCP가 이 작업을 대신 활성화합니다.
목록이 아닌 하한선
선택한 수준은 임계값입니다. warning으로 설정하면 warning과 그보다 심각한 모든 메시지가 전달되고, 더 낮은 메시지는 제외됩니다.
필터링 작동 방식
setLevel 이후 서버는 각 로그의 심각도를 하한선과 비교합니다. 임계값보다 낮은 항목은 해당 클라이언트에 전혀 전송하지 않습니다.
# floor = warning -> info and debug are dropped수준 높이기
까다로운 실행을 디버깅하려면 클라이언트가 수준을 debug로 설정할 수 있습니다. 그러면 시끄러운 추적 정보까지 모든 메시지가 검사를 위해 다시 스트리밍됩니다.
{"method": "logging/setLevel",
"params": {"level": "debug"}}수준 낮추기
차분한 운영 화면을 원한다면 error로 설정하십시오. 실패만 도착하므로 사용자의 화면에 일반적인 잡음이 표시되지 않습니다.
{"method": "logging/setLevel",
"params": {"level": "error"}}세션별 설정
수준은 해당 클라이언트의 세션에 적용됩니다. 나중에 변경하면 하한선만 이동하며 새 연결이나 다시 로드가 필요하지 않습니다.
합리적인 기본값
setLevel이 도착하기 전에는 서버가 자체 기본값 하한선을 사용하며, 보통 info입니다. 항상 풍부하게 로그를 기록하고 클라이언트가 보관할 내용을 선택하게 하십시오.
도움이 되는 이유
실행 중 수준을 바꿀 수 있으면 기본적으로는 조용하지만 사용자가 찾기 어려운 버그를 보고하는 순간 상세한 로그를 내보낼 수 있는 빌드 하나만 제공하면 됩니다.
로그와 함께 작동하기
이 조절 기능은 작성한 동일한 ctx.info 및 ctx.debug 호출을 제어합니다. 하한선은 클라이언트가 선택하고, 코드는 적절한 수준으로 로그를 기록하기만 하면 됩니다.
await ctx.debug("seen only when floor is debug")빠른 확인
선택한 로그 수준이 실제로 무엇을 필터링하는지 생각해 보십시오.
복습: 로그 수준
logging/setLevel이 실행 중 하한선을 설정하는 방식, 필터링으로 더 낮은 메시지가 제외되는 방식, 그리고 이 기능이 하나의 빌드를 유연하게 유지하는 이유를 배웠습니다. 훌륭합니다!
자주 묻는 질문
“실행 중 로그 수준 설정하기” 강의는 무료인가요?
네 — “실행 중 로그 수준 설정하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 MCP Academy 강의 전체를 잠금 해제할 수 있습니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“실행 중 로그 수준 설정하기”에서 뭘 배우나요?
클라이언트가 로그 상세도를 높이거나 낮출 수 있게 합니다. 브라우저에서 직접 실행하는 실습 코드로 MCP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
MCP Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 MCP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“실행 중 로그 수준 설정하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 MCP Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 MCP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 긴 작업의 진행 상황 보내기
- 취소 요청 처리하기
- 클라이언트에 구조화된 로깅 보내기
- 실행 중 로그 수준 설정하기