/inspector:log — 앱 로그 들여다보기#

한마디로#

실행 중인 앱이 남기는 "기록(로그)" 을 꺼내 보고, 그중 문제(에러)만 골라내거나 특정 단어로 검색하는 도구입니다. 앱이 매 순간 적어 두는 일기장을 펼쳐, 어디서 무슨 일이 있었는지 되짚어 보는 것과 같아요.

누가·언제 쓰나요#

• 앱에서 에러가 났는데 무엇이 잘못됐는지 원인을 확인하고 싶을 때
• 특정 동작(예: 로그인, 인증)과 관련된 메시지를 찾아보고 싶을 때
• 같은 에러가 반복해서 나는 패턴을 분석하거나, 앱이 갑자기 꺼지는(크래시) 원인을 추적할 때

무엇을 해주나요#

실행 중인 앱의 로그를 다음과 같이 다뤄 줍니다.

• 최근 로그 보기 — 방금 일어난 일들을 시간순으로 꺼내 줍니다.
• 에러만 골라 보기 — 문제가 된 기록만 추려, 필요하면 자세한 추적 정보(스택 트레이스)까지 보여 줍니다.
• 검색 — auth 같은 키워드로 원하는 기록만 찾아 줍니다.
• 통계 — 로그가 얼마나, 어떤 종류로 쌓였는지 요약해 줍니다.
• 정리(비우기) — 쌓인 로그를 깨끗이 지웁니다.

어떻게 쓰나요#

# 최근 로그 확인
/inspector/log recent

# 에러 로그만 확인
/inspector/log errors

# 특정 키워드 검색 (예: auth)
/inspector/log search auth

# 로그 통계 보기
/inspector/log stats

recent(최근), errors(에러만), search(검색), stats(통계) 뒤에 원하는 항목을 붙여 쓰면 됩니다.

안에서 무슨 일이 벌어지나요#

자주 쓰는 진단 흐름은 다음과 같습니다.

1. 반복되는 에러 찾기 — 에러 로그를 먼저 확인하고, 같은 위치(태그)에서 반복되는지 보고, 그 맥락을 분석합니다.
2. 성능 문제 추적 — slow(느림)나 timeout(시간 초과) 같은 단어로 검색해, 해당 시점 주변 로그를 살펴 병목 지점을 찾습니다.
3. 앱이 꺼진 원인 찾기 — 마지막 에러를 확인하고, 추적 정보를 분석한 뒤, 에러 직전의 기록까지 거슬러 올라가 원인을 짚습니다.

{
   " logs " : [
    {
       " timestamp " :  " 2024-01-01T10:00:00Z " ,
       " level " :  " info " ,
       " tag " :  " AuthBloc " ,
       " message " :  " User logged in successfully " ,
       " data " : { " userId " : 123}
    }
  ]
}

1. log_get_errors - >   Check error patterns
2. Confirm repeated occurrences from same tag
3. Analyze error context

1. log_search query= " slow "   or  " timeout " 
 2. Analyze logs around relevant timeframes
3. Identify bottleneck points

1. log_get_errors - >   Check last error
2. Analyze stack trace
3. Trace logs immediately before the error

/inspector/log recent

/inspector/log errors

/inspector/log search auth

/inspector/log stats