서버에서 측정할 항목
지연 시간, 오류, 도구 사용량을 추적합니다.
서버에서 측정할 항목은(는) CoddyKit의 무료 MCP Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 MCP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
왜 측정할까요
MCP 서버가 실제 환경에서 실행되기 시작하면 보이지 않는 문제는 해결할 수 없습니다. 관측 가능성은 추측을 서버 동작에 관한 명확한 신호로 바꿔 줍니다. 🔍
세 가지 핵심 요소
관측 가능성은 로그, 메트릭, 추적이라는 세 가지 신호를 기반으로 합니다. 이번에는 상태를 한눈에 요약하는 숫자인 메트릭에 집중합니다.
지연 시간: 얼마나 느린가요
가장 먼저 추적할 것은 지연 시간입니다. 각 도구 호출이 요청부터 응답까지 얼마나 오래 걸리는지 측정하세요. 느린 도구는 모델과 사용자 모두를 답답하게 만듭니다.
평균을 그대로 믿지 마세요
느린 호출 하나가 좋은 평균값 뒤에 숨을 수 있습니다. p95와 p99 같은 백분위수를 확인해 실제 호출자가 겪는 최악의 경험을 포착하세요.
오류율: 얼마나 자주 고장 나나요
오류율을 추적하세요. 이는 실패한 도구 호출의 비율입니다. 오류율이 높아지는 것은 상위 시스템에서 무언가 고장 났다는 가장 이른 경고입니다. ⚠️
처리량: 얼마나 바쁜가요
시간에 따른 호출 수를 세어 처리량을 확인하세요. 분당 요청 수를 알면 부하가 언제 급증하는지, 서버가 이를 감당할 수 있는지 알 수 있습니다.
도구별 사용량
메트릭을 도구 이름별로 나누세요. 어떤 도구가 많이 사용되거나 느리거나 실패하는지 알면 추측하지 않고 문제가 있는 정확한 부분을 고칠 수 있습니다.
카운터와 게이지
카운터는 총 호출 수처럼 올라가기만 합니다. 게이지는 현재 활성 세션 수처럼 양방향으로 변합니다. 측정 대상에 맞는 유형을 선택하세요.
Python으로 간단한 타이머 만들기
도구 본문 주변에 타이머를 두는 것만으로 지연 시간을 측정한 다음, 경과한 초를 기록할 수 있습니다.
import time
start = time.perf_counter()
result = do_work()
elapsed = time.perf_counter() - start
print("latency_seconds", elapsed)메트릭에 라벨을 지정하세요
모든 메트릭에 도구 이름과 상태 같은 라벨을 추가하세요. 라벨을 사용하면 하나의 숫자를 실제 질문에 답하는 여러 관점으로 나눌 수 있습니다.
골든 시그널
유용한 점검 목록으로는 골든 시그널이 있습니다. 지연 시간, 트래픽, 오류, 포화도를 말합니다. 이 네 가지를 확인하면 사용자가 문제를 알아차리기 전에 대부분의 문제를 발견할 수 있습니다.
빠른 확인
지연 시간이라는 개념을 제대로 이해했는지 확인해 보겠습니다.
복습
이제 무엇을 측정해야 하는지 알게 되었습니다. 지연 시간, 오류, 처리량, 도구별 사용량입니다. 이 수치들은 상태를 알기 어려운 서버를 실제로 신뢰할 수 있는 서버로 바꿔 줍니다. 🎯
AI 튜터와 함께 Python을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 30
- 레슨
- 120
자주 묻는 질문
“서버에서 측정할 항목” 강의는 무료인가요?
네 — “서버에서 측정할 항목” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 MCP Academy 강의 전체를 잠금 해제할 수 있습니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“서버에서 측정할 항목”에서 뭘 배우나요?
지연 시간, 오류, 도구 사용량을 추적합니다. 브라우저에서 직접 실행하는 실습 코드로 MCP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
MCP Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 MCP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“서버에서 측정할 항목” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 MCP Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 MCP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 서버에서 측정할 항목
- 검색 가능한 구조화된 로그
- 도구 호출 처음부터 끝까지 추적하기
- 실패와 악용 알림