/cc-inspector:network — 앱 통신 기록 살펴보기#

한마디로#

앱이 서버와 주고받은 통신을 CCTV 녹화처럼 모아두고 다시 돌려보는 도구입니다. "화면이 안 뜬다", "로그인이 안 된다" 같은 문제가 생겼을 때 어디서 막혔는지 통신 기록으로 확인합니다.

누가·언제 쓰나요#

앱을 만들고 점검하는 개발자가, 앱과 서버 사이 통신이 의심될 때 사용합니다.

• API 호출이 실패할 때
• 화면이 너무 느리게 뜨거나 응답이 지연될 때(타임아웃)
• 서버에서 받아온 데이터가 이상할 때

무엇을 해주나요#

실행 중인 앱이 서버와 주고받은 HTTP 통신 기록을 보여줍니다.

• 최근 통신 목록 — 언제, 어떤 주소로, 얼마나 걸려서, 성공/실패했는지
• 실패한 통신만 따로 — 권한 오류(401), 서버 오류(500), 타임아웃 등 문제 건만 추려서
• 통신 통계 — 전체적인 통신 현황 요약
• 기록 비우기 — 쌓인 기록을 지우고 새로 보기

어떻게 쓰나요#

# 최근 API 호출 기록 보기
/inspector/network logs

# 특정 주소(예: /users)만 걸러서 보기
/inspector/network logs --path /users

# 실패한 요청만 보기
/inspector/network errors

# 통신 통계 보기
/inspector/network stats

--path 뒤에 보고 싶은 주소 일부를 적으면 그 부분만 골라서 보여줍니다.

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

문제 유형에 따라 기록을 꺼내 단계별로 원인을 좁혀갑니다.

• 응답이 느릴 때 — 기록에서 걸린 시간을 확인해 느린 요청을 찾고, 서버 문제인지 네트워크 문제인지 가립니다.
• 권한 오류(401) — 실패 기록에서 인증 정보를 확인하고, 토큰 상태는 /inspector/auth로 점검합니다.
• 서버 오류(500) — 실패 기록의 응답 내용에서 오류 메시지를 확인하고 보낸 값을 다시 살핍니다.
• 타임아웃 — 네트워크 연결 상태와 제한 시간 설정값을 점검합니다.

{
   " logs " : [
    {
       " id " :  " req_001 " ,
       " timestamp " :  " 2024-01-01T10:00:00Z " ,
       " method " :  " GET " ,
       " url " :  " https://api.example.com/users/123 " ,
       " statusCode " : 200,
       " duration " : 245,
       " responseSize " : 1024
    }
  ]
}

1. network_get_logs - >   Check duration
2. Identify slow requests
3. Determine server performance or network issue

1. network_get_errors - >   Check 401 errors
2. Check Authorization in requestHeaders
3. Check token status with /inspector/auth

1. network_get_errors - >   Check details
2. Check error message in responseBody
3. Review request parameters

1. network_get_errors - >   Check timeout errors
2. Check network connection status
3. Review timeout configuration values

/inspector/network logs

/inspector/network logs --path /users

/inspector/network errors

/inspector/network stats