---
name: log-analyze
label: 로그 분석기
description: 로그 파일의 패턴을 분석하고 에러를 요약하며 타임라인을 시각화합니다.
icon: \uE9D9
allowed-tools:
  - file_read
  - grep
  - chart_create
  - html_create
  - data_pivot
  - text_summarize
tabs: cowork
---

로그 파일을 분석하여 패턴, 에러, 추세를 파악하고 보고서를 생성하세요.

## 워크플로우

1. **로그 파일 로드**: file_read로 로그 파일 읽기
2. **패턴 분석**:
   - grep으로 에러/경고/예외 패턴 검색
   - 시간대별 이벤트 빈도 파악
   - 반복되는 에러 패턴 식별
3. **통계 생성**: data_pivot으로 집계
4. **시각화**: chart_create로 타임라인 차트 생성
5. **보고서**: html_create로 분석 보고서 생성

## 분석 항목

### 에러 분석
- ERROR, WARN, FATAL, Exception 키워드 추출
- 에러 유형별 발생 빈도
- 최초 발생 시점 및 최근 발생 시점
- 에러 메시지 클러스터링 (유사 에러 그룹화)

### 시간대 분석
- 시간대별 로그 발생 빈도
- 피크 시간대 식별
- 에러 집중 시간대

### 패턴 분석
- 반복 패턴 (주기적 에러)
- 연쇄 에러 (A 에러 후 B 에러 발생 패턴)
- 비정상 패턴 (평소와 다른 로그량)

## 출력 형식

```
## 로그 분석 보고서
- 분석 기간: [시작] ~ [끝]
- 총 로그: N줄

### 에러 요약 (상위 10건)
| 순위 | 에러 유형 | 발생 횟수 | 최근 발생 |
|------|----------|----------|----------|

### 타임라인 차트
[시간대별 이벤트 빈도 차트]

### 상세 분석
[에러별 상세 내용 및 권장 조치]
```

## 지원 로그 형식
- 일반 텍스트 로그 (타임스탬프 자동 감지)
- JSON 로그 (각 줄이 JSON 객체)
- CSV 로그 (헤더 포함)
- syslog 형식