로컬 LLM과 n8n으로 구축하는 에러 분석 자동화

// 중복 판정 기준 시간 (5초)
const RECENT_ERROR_TTL = 5000
 
// errorKey -> 마지막 발생 타임스탬프
const recentErrors = new Map()
 
/** 동일 에러가 TTL 내에 재발생하면 true 반환 */
function isDuplicate(errorKey) {
  const now = Date.now()
  const lastTimestamp = recentErrors.get(errorKey)
 
  // TTL 이내 동일 키 재진입 시, 중복으로 판정
  if (lastTimestamp && now - lastTimestamp < RECENT_ERROR_TTL) {
    return true
  }
 
  recentErrors.set(errorKey, now)
 
  // TTL 만료 후 해당 키만 제거해 Map이 무한히 커지는 것을 방지
  setTimeout(() => recentErrors.delete(errorKey), RECENT_ERROR_TTL)
 
  return false
}

function createPayload(error, callSiteStack) {
  return {
    // 에러 객체: 메시지, 스택, cause 체인을 구조화해 담음
    error: {
      message: error.message,
      name: error.name,
      stack: error.stack || '',
      traces: parseStackTrace(error.stack),
      causes: collectCauseChain(error),
    },
    // 호출 지점: 에러 발생 위치와 별도로 실제 호출한 스택을 함께 기록
    callSite: {
      stack: callSiteStack,
      traces: parseStackTrace(callSiteStack),
    },
    // 부가 정보: 발생 페이지, 브라우저, 환경을 리포트에서 바로 파악할 수 있도록 담음
    meta: {
      url: window.location.href,
      userAgent: navigator.userAgent.slice(0, 500),
      timestamp: new Date().toISOString(),
      environment: isDev ? 'development' : 'production',
    },
  }
}

// n8n 웹훅으로 페이로드 전송
fetch(N8N_WEBHOOK_URL, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(payload),
  keepalive: true, // 페이지 언로드 중에도 요청이 완료될 때까지 유지
}).catch((err) => {
  // 개발 환경에서만 콘솔 출력 — 프로덕션에서는 조용히 실패
  if (isDev) console.warn('[logger] Webhook 전송 실패', err.message)
})

// 모든 트레이스 합치기 (에러 발생 지점이 앞서도록 순서 유지)
const allTraces = [...(error.traces || []), ...(callSite.traces || [])].slice(0, 3)
 
const seen = new Set()
const srcFiles = []
 
for (const trace of allTraces) {
  if (!trace.file) continue
 
  // 'src/' 경로 포함 여부 확인 후 추출
  const match = trace.file.match(/(src\/.*)$/)
  if (!match) continue
 
  // 중복 제거: 동일한 파일 경로는 한 번만 기록
  const filePath = match[1]
  if (seen.has(filePath)) continue
  seen.add(filePath)
 
  srcFiles.push({
    file: filePath,
    fn: trace.function,
    location: `${trace.line}:${trace.column}`,
    full: `${filePath}:${trace.line}:${trace.column}`,
  })
}

return [
  {
    json: {
      // 노션 페이지 제목 및 Ollama 프롬프트 상단에 사용
      title: `[${error.name || 'Error'}] ${error.message}`,
      // 호출 지점 원본 스택 — 프롬프트의 호출 흐름 섹션에 주입
      callSiteStack: callSite.stack,
      // 에러 상세 — srcFiles, primaryLocation, stackSummary는 파싱 단계에서 추가된 필드
      error: {
        ...error,
        srcFiles, // 분석 대상 파일 목록 (최대 3개)
        primaryLocation, // 에러 발생 주요 위치 (file:line:column)
        stackSummary, // 스택 트레이스 한 줄 요약
      },
      // 발생 환경 — 프롬프트의 환경 섹션 및 노션 속성에 사용
      context: {
        url: meta.url,
        path: getUrlPath(meta.url), // 쿼리스트링 제거한 경로만 추출
        browser: uaInfo.browser,
        os: uaInfo.os,
        userAgent: meta.userAgent,
        env: meta.environment,
      },
      timestamp: meta.timestamp || new Date().toISOString(),
    },
  },
]

if (file.location) {
  // "22:15" 형식에서 라인 번호만 추출
  const targetLine = parseInt(file.location.split(':')[0])
  const lines = sourceCode.split('\n')
 
  // 에러 발생 라인 기준 상하 20줄 — 파일 경계를 벗어나지 않도록 clamp
  const start = Math.max(0, targetLine - 21)
  const end = Math.min(lines.length, targetLine + 20)
 
  codeSnippet = lines
    .slice(start, end)
    .map((line, index) => {
      const currLineNum = start + index + 1
      // 에러 발생 지점에 시각적 마커 추가 — AI가 해당 라인에 집중하도록 유도
      const marker = currLineNum === targetLine ? ' > ' : '   '
      return `${marker}${currLineNum} | ${line}`
    })
    .join('\n')
}

당신은 시니어 프론트엔드 개발자이자 디버깅 전문가입니다.
제공된 에러 맥락과 소스 코드를 교차 분석하여 근본 원인을 찾고, 노션(Notion) 리포트용 JSON 응답을 생성하세요.
 
## 1. 에러 맥락
 
- 에러명: ${data.title}
- 메시지: ${data.error.message}
- 발생 위치: ${data.error.primaryLocation}
- 호출 흐름: ${data.error.stackSummary}
- 환경: ${data.context.os} / ${data.context.browser} (${data.context.env})
 
## 2. 원인 체인 (error.cause)
 
${causesSection}
 
## 3. 관련 소스 코드 (에러 지점 주변부)
 
${codeContextSection}
 
## 4. 상세 분석 및 응답 요구사항 (중요)
 
- **problemAnalysis**: 단순 현상이 아닌 '왜' 발생했는지 분석하세요. 핵심 키워드에 **볼드**를 사용하세요.
- **fixStrategy**: 어떤 방향으로 고칠지 1~2문장으로 요약하세요.
- **fixContent**: 구체적인 변경 사항을 **반드시 한 줄에 하나씩 글머리 기호('-')를 사용하여 리스트 형태로** 작성하세요. 각 줄 사이에는 줄바꿈을 포함하세요.
- **fixCode**: 수정이 필요한 부분만 **작업 단위(함수 또는 블록)**별로 작성하세요. 전체 파일을 작성하지 마세요. 반드시 변경 전/후의 맥락을 알 수 있는 주석을 포함하세요. 줄 번호는 반드시 포함하지 마세요.
- **riskLevel**: LOW, MEDIUM, HIGH 중 하나를 선택하세요.
- **testSteps**: 검증을 위해 필요한 단계를 배열 형태로 작성하세요.
 
## 5. 응답 형식 (JSON만 출력, 코드 블록 기호 \`\`\`json 금지)
 
{
"summary": "한 줄 요약",
"problemAnalysis": "근본 원인 상세 분석",
"fixStrategy": "해결을 위한 접근 방식",
"fixContent": "- 변경 사항 1\\n- 변경 사항 2\\n- 변경 사항 3",
"fixFilePath": "${primaryFile?.file || "src/..."}",
"fixCode": "// [수정된 함수/블록명]\\nfunction example() {\\n // ... 기존 코드\\n // FIXED: 에러 방지를 위해 null 체크 추가\\n if (data) { \\n // ... 수정된 로직\\n }\\n}",
"testSteps": ["테스트 단계 1", "단계 2"],
"riskLevel": "LOW | MEDIUM | HIGH",
}

// 정확성과 재현성 우선 — 코딩 태스크에는 0에 가까운 값 권장
const AI_TEMPERATURE = 0.1
 
// 낮은 temperature 보완 — 제한된 범위 내에서 다양성 유지
const AI_TOP_P = 0.9
 
// 코드 스니펫 3개 + 스택 트레이스가 잘리지 않을 충분한 컨텍스트 크기
const AI_NUM_CTX = 8192
 
const body = {
  model: 'deepseek-coder-v2:16b',
  prompt,
  stream: false, // 응답 완료 후 한 번에 수신
  format: 'json', // JSON 형식 강제 — 파싱 실패 방지
  options: {
    temperature: AI_TEMPERATURE,
    top_p: AI_TOP_P,
    num_ctx: AI_NUM_CTX,
  },
}

"options": {
  "timeout": 300000
}

analysis = {
  summary: parsed.summary,
  problemAnalysis: parsed.problemAnalysis ?? '',
  fixStrategy: parsed.fixStrategy ?? '',
  fixContent: parsed.fixContent ?? '',
  fixCode: parsed.fixCode,
  fixFilePath: parsed.fixFilePath ?? promptData.error?.primaryLocation?.split(':')[0] ?? 'unknown',
  testSteps: Array.isArray(parsed.testSteps) ? parsed.testSteps : [],
  riskLevel: parsed.riskLevel,
}

// 노션 페이지 생성용 JSON 구조
const notionBody = {
  properties: {
    Name: {
      title: [{ text: { content: pageTitle } }],
    },
    Status: {
      select: { name: 'Open' },
    },
    'Risk Level': {
      select: { name: data.riskLevel || 'MEDIUM' },
    },
    Environment: {
      select: { name: data.context?.env || 'unknown' },
    },
    // ...
  },
  // ...
}

{
  "parameters": {
    "method": "POST",
    "url": "https://api.notion.com/v1/pages",
 
    // n8n Credential에 등록된 Notion API 키를 참조 — 토큰 직접 노출 없음
    "authentication": "predefinedCredentialType",
    "genericAuthType": "notionApi",
    "sendHeaders": true,
    "headerParameters": {
      "parameters": [ ... ] // Notion-Version 헤더 등 추가 설정
    },
    "sendBody": true,
    "specifyBody": "json",
 
    // 이전 단계에서 구성한 Notion 블록 구조를 JSON 직렬화해 전달
    "jsonBody": "={{ JSON.stringify($json.notionBody) }}",
    "options": {}
  },
  "name": "Create Notion Issue",
  "type": "n8n-nodes-base.httpRequest",
  "typeVersion": 4.2,
}