Agent 관찰 로거

Notification중급Hook 타입: notification

Agent 관찰 로거는 모든 도구 호출, 알림, 세션 이벤트를 구조화된 JSONL 로그 파일에 기록합니다. 각 항목에는 타임스탬프, 도구 이름, 입력 요약, 출력 상태, 토큰 사용량이 포함됩니다. 이를 통해 세션 중 Claude가 수행한 작업을 파악하고, 예상치 못한 동작을 디버깅하며, 시간 경과에 따른 패턴을 추적하고, 컴플라이언스 요구사항을 충족할 수 있는 완전한 감사 추적을 생성합니다. 로그는 매일 자동 순환되며 모든 관찰 플랫폼으로 전달할 수 있습니다.

로깅감사관찰디버깅컴플라이언스

Hook 코드

#!/bin/bash
# Agent Observability Logger Hook
# Logs all Claude Code actions to structured JSONL

LOG_DIR="${HOME}/.claude/logs"
LOG_FILE="$LOG_DIR/agent-$(date +%Y-%m-%d).jsonl"

mkdir -p "$LOG_DIR"

TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
SESSION_ID="${CLAUDE_SESSION_ID:-unknown}"

# Build structured log entry
LOG_ENTRY=$(jq -n   --arg ts "$TIMESTAMP"   --arg session "$SESSION_ID"   --arg tool "$TOOL_NAME"   --arg event "$EVENT_TYPE"   --arg input "$TOOL_INPUT"   --arg output "$TOOL_OUTPUT"   '{
    timestamp: $ts,
    session_id: $session,
    tool: $tool,
    event: $event,
    input_preview: ($input | if length > 200 then .[:200] + "..." else . end),
    output_preview: ($output | if length > 200 then .[:200] + "..." else . end)
  }')

echo "$LOG_ENTRY" >> "$LOG_FILE"

# Rotate logs older than 30 days
find "$LOG_DIR" -name "agent-*.jsonl" -mtime +30 -delete 2>/dev/null

exit 0

이 Hook을 Claude Code 설정 또는 .claude/settings.json에 추가하면 활성화됩니다.

실행 미리보기

Agent 관찰 로거

Agent 관찰 로거에 대해

Claude Code Hooks는 Claude 작업 중 특정 이벤트에 반응하여 커스텀 셸 명령을 자동으로 실행합니다. Agent 관찰 로거은(는) 중급 수준의 Notification Hook으로, 개발 워크플로우의 핵심 시점에서 작업을 자동화하여 수동 단계를 줄이고 팀 전체의 일관성을 유지합니다.

Agent 관찰 로거

Hook 코드

실행 미리보기

Agent 관찰 로거에 대해

관련 Hooks