본문으로 건너뛰기
Localtonet Localtonet 대시보드

로그 및 요청 검사

이 페이지 도움받기
이 페이지의 내용 섹션 8개
  1. 어디서 무엇을 쓸 수 있나요
  2. HTTP 터널용 요청 인스펙터
  3. 인스펙터 열기
  4. 요청 목록
  5. 요청과 응답 상세
  6. 요청 재전송
  7. 요청 로깅 끄기와 켜기
  8. 다른 터널의 연결 로그
  9. 로그를 CSV로 다운로드
  10. 활동 로그
  11. 터널 상태 점검
  12. 터널이 멈췄을 때
  13. 문제 해결
  14. 관련 페이지

터널에서 무슨 일이 일어나는지 확인하세요. 터널이 받는 HTTP 요청을 검사하고 다시 보낼 수 있으며, 터널에 들어온 연결 목록, 시작과 중지와 설정 변경 로그, 하루 동안의 상태 점검 결과를 볼 수 있습니다. 터널이 멈췄을 때 어디를 확인해야 하는지도 이 페이지에서 안내합니다.

어디서 무엇을 쓸 수 있나요 #

이 항목은 모두 터널 설정 패널의 행입니다. 내 터널에서 해당 터널 유형의 페이지를 열고, 터널 행에서 설정을 선택하세요.

행열리는 내용터널 유형
요청 로그기록된 요청과 응답을 보여 주는 요청 인스펙터입니다.HTTP, MCP 게이트웨이
요청 로그연결 로그입니다. 누가 언제 어디로 연결했는지 보여 줍니다.TCP - UDP, TLS, 파일 서버, 프록시 서버
활동 로그터널의 시작, 중지, 설정 변경 기록입니다.모든 터널 유형
터널 상태 점검정기 상태 점검의 결과입니다.파일 서버를 제외한 모든 터널 유형
대역폭 트래픽터널을 통과한 데이터입니다. 한도 및 만료를 참고하세요.모든 터널 유형

로테이팅 프록시는 클라이언트별로 요청 로그를 보관합니다. 클라이언트의 요청 로그 버튼을 사용하세요. 로테이팅 프록시를 참고하세요.

HTTP 터널용 요청 인스펙터 #

인스펙터는 HTTP 또는 MCP 게이트웨이 터널에 도달하는 HTTP 요청을 헤더와 본문, 그리고 서비스가 보낸 응답과 함께 보여 줍니다. 자체 코드에 로깅을 추가하지 않고도 웹훅과 API 호출을 디버깅할 수 있습니다. 요청은 아래 설명대로 로깅을 켠 뒤에만 기록됩니다.

기록은 바이트 단위로 완전히 같은 사본이 아닙니다. 본문은 최대 16 KB까지만 저장되며, JSON, XML, HTML, 일반 텍스트, URL 인코딩된 폼 데이터 같은 텍스트 형식에 한합니다. Authorization, Cookie, X-Api-Key 같은 민감한 헤더의 값은 [MASKED]로 저장됩니다.

인스펙터 열기 #

  • 터널 설정에서 요청 로그 › 표시를 선택하거나,
  • 터널 목록에서 툴팁이 요청 및 응답 로그 보기인 버튼을 선택하세요. 터널이 중지되어 있으면 이 버튼은 먼저 터널을 시작하라고 안내합니다. 서버 열에 로컬 또는 VPN이 표시된 터널에서는 버튼이 비활성화되며 "Client Relay에서는 사용할 수 없습니다"라는 툴팁이 표시됩니다.

인스펙터 페이지가 새 탭에서 열립니다.

요청 목록 #

HTTP 요청 카드에는 요청이 최신순으로 나열되며, 스크롤하면 더 불러옵니다. 배지에 실시간이 표시되는 동안 목록은 3초마다 새로 고쳐집니다.

열표시 내용
메서드GET이나 POST 같은 HTTP 메서드입니다.
엔드포인트요청된 경로입니다.
국가, IP요청이 어디에서 왔는지 보여 줍니다.
일시요청이 도착한 시각이며, 브라우저의 시간대로 표시됩니다.
상태서비스가 응답한 HTTP 상태 코드입니다.
소요 시간응답에 걸린 시간이며, 단위는 초입니다.

필터가 없으면 목록은 최근 24시간을 다룹니다. 날짜로 필터링에는 오늘, 어제, 최근 7일, 사용자 지정 기간이 있으며, 오늘과 그 이전 6일까지 조회할 수 있습니다. 날짜 필터를 적용하면 실시간 목록이 일시 중지되며, 실시간 보기를 선택하면 다시 돌아갑니다. 검사 로그는 최대 7일 동안 보관됩니다.

요청과 응답 상세 #

요청을 선택하면 상세 정보가 열립니다.

부분탭표시 내용
요청요약요청 ID, 요청 IP, 메서드, 호스트, 경로, 전체 URL, 타임스탬프, URL 길이, 헤더 수입니다.
요청헤더모든 요청 헤더와 그 값입니다.
요청본문요청 본문입니다. JSON은 읽기 쉽게 서식이 적용됩니다. 복사를 선택하면 본문을 복사합니다.
요청IP 정보방문자 IP 주소의 시간대, 대륙, 국가, 도시, 우편번호, 지역, 좌표입니다.
응답요약응답 ID, 상태, 응답 시간, 헤더 수입니다.
응답헤더, 본문서비스가 돌려보낸 내용입니다.

요청 재전송 #

요청을 재전송하면 발신자 쪽에서 같은 웹훅을 다시 발생시키지 않아도 됩니다.

  • 재전송은 선택한 요청을 기록에서 다시 보냅니다. 재전송이 요청되는 즉시 페이지에 "요청을 성공적으로 재전송했습니다."가 표시되며, 결과를 기다리지는 않습니다.
  • 수정을 선택하면 요청 수정이 열립니다. 여기서 재전송을 선택하기 전에 메서드(GET, POST, PUT, DELETE, PATCH), 경로, 헤더(헤더 추가), 본문을 바꿀 수 있습니다.

재전송된 요청은 터널이 있는 기기의 Localtonet 앱이 보내므로 앱이 연결되어 있어야 합니다.

요청 로깅 끄기와 켜기 #

요청은 로깅이 켜져 있는 동안에만 수집되며, 터널은 로깅이 꺼진 상태로 시작합니다. 꺼져 있는 동안 페이지에는 "요청 로깅이 꺼져 있습니다. 새 요청은 수집되지 않습니다."라는 안내와 함께 로깅 켜기 버튼이 표시됩니다. 로깅 끄기를 선택하면 새 요청 수집이 다시 중지됩니다. 요청 본문에 비밀번호나 개인 정보처럼 저장하고 싶지 않은 데이터가 오가는 터널에서는 로깅을 끄세요. 이 변경은 활동 로그에 "HTTP 웹훅 설정을 변경했습니다."로 기록됩니다.

다른 터널의 연결 로그 #

TCP - UDP, TLS, 파일 서버, 프록시 서버 터널에서는 요청 로그 › 표시를 선택하면 요청 로그 대화 상자가 열립니다. 터널에 들어온 연결이 최신순으로 한 페이지에 30개씩 나열됩니다.

열표시 내용
방문자 IP터널에 연결한 주소입니다.
클라이언트 IP해당 연결에 기록된 클라이언트 주소입니다.
대상연결이 향한 곳입니다. 프록시 터널에서는 방문한 호스트와 포트입니다.
날짜발생한 시각이며, 계정의 시간대로 표시됩니다.

이 로그에는 연결 메타데이터만 들어 있으며, 연결을 통해 전송된 내용은 포함되지 않습니다.

로그를 CSV로 다운로드 #

CSV로 다운로드에서 최대 30일의 날짜 범위를 선택하고 다운로드를 선택하세요. 파일 이름은 RequestLogs-로 시작하고 터널의 내부 식별자가 이어지며 .csv로 끝납니다. 열은 날짜 및 시간, 요청 IP, 클라이언트 IP, 대상, 토큰, 프로토콜입니다. 더 긴 기간이 필요하면 범위를 나누어 차례로 다운로드하세요. 다운로드는 분당 한 번으로 제한되므로 다음 다운로드 전에 1분 기다려야 합니다.

활동 로그 #

활동 로그 › 표시에는 터널 자체에 일어난 일이 최신순으로 나열됩니다. 각 항목에는 계정 시간대의 날짜와 시간, 작업이 시작된 채널, 무엇이 바뀌었는지 설명하는 문장이 있습니다.

채널작업의 출처
웹대시보드입니다.
APIAPI입니다.
CLI명령줄입니다.
시스템Localtonet 자체입니다. 예를 들어 한도에 도달했을 때입니다.

대표적인 항목:

  • 터널을 시작했습니다.
  • 터널을 중지했습니다.
  • 로컬 포트를 "3000"에서 "8080"(으)로 변경했습니다.
  • IP 제한을 추가했습니다: "203.0.113.10"
  • 대역폭 제한을 변경했습니다: "10.00 GB"
  • 만료일을 껐습니다.

새 비밀번호나 변경된 비밀번호는 로그에 기록되지 않습니다. "비밀번호를 설정했습니다." 또는 "비밀번호를 변경했습니다."로만 표시됩니다.

터널 상태 점검 #

터널 상태 점검 › 표시를 선택하면 상태 점검 대화 상자가 열립니다. Localtonet은 10분마다 터널을 점검합니다. 사각형 하나가 점검 한 번이며, 당일의 시간대별로 표시됩니다.

값의미
정상점검 시점에 터널이 연결되어 있었습니다.
비정상점검 시점에 터널이 연결되어 있지 않았습니다.
알 수 없음해당 시간에도, 그 이전 시간에도 결과가 없습니다.
데이터 없음오늘 아직 그 시간이 되지 않았습니다.
가동률정상 점검과 비정상 점검 중 정상 점검이 차지하는 비율입니다.

표시할 사각형이 없으면 대화 상자에 "아직 기록된 점검이 없습니다. 터널이 한동안 실행되면 결과가 여기에 표시됩니다."라고 표시됩니다.

터널이 멈췄을 때 #

먼저 터널의 활동 로그를 여세요. 가장 최근의 "중지" 항목에 이유가 나와 있습니다.

활동 로그 항목무슨 일이 일어났나요해결 방법
"터널을 중지했습니다."누군가 터널을 중지했습니다. 채널에 작업의 출처가 표시됩니다. 예를 들어 대시보드는 웹, API는 API입니다.시작을 선택하세요.
"터널 대역폭 한도에 도달하여 터널을 중지했습니다."터널 자체의 대역폭 제한에 도달했습니다.한도를 늘리거나 사용량을 초기화하세요. 한도 및 만료를 참고하세요.
"만료일에 도달하여 터널을 중지했습니다."터널의 만료일이 지났습니다.더 늦은 날짜로 설정하거나 끄세요. 한도 및 만료를 참고하세요.
"무료 사용 한도에 도달하여 터널을 중지했습니다."무료 플랜의 세션 한도에 도달했습니다.시작을 선택해 새 세션을 시작하거나 잔액을 충전하세요. 플랜 및 잔액을 참고하세요.
"총 대역폭 한도를 초과하여 터널을 중지했습니다."계정의 대역폭을 모두 사용했습니다.플랜 및 잔액을 참고하세요.
"비활성 상태이고 연결이 없어 터널을 중지했습니다."Localtonet이 시작되었지만 연결되지 않은 터널을 중지했습니다.Localtonet 앱을 연결된 상태로 유지하고, 터널이 다시 필요할 때 시작을 선택하세요.

로그에 중지 기록이 없는데 주소가 응답하지 않으면 터널 목록의 연결 열을 확인하세요. 꺼짐은 터널이 연결되지 않았다는 뜻이므로 기기에서 Localtonet 앱을 시작하세요. 앱이 오프라인일 때 시작을 선택하면 대시보드에 "NAME 오프라인"이라는 제목의 대화 상자가 열리고 "앱 연결을 기다리는 중…"이라고 표시됩니다. 앱이 연결되는 즉시 터널이 자동으로 시작됩니다. 그래도 시작을 선택하면 터널이 지금 켜지고, 앱이 연결되면 활성화됩니다.

터널이 다운되면 알림을 받으세요. 대시보드의 웹훅 페이지에서 터널이 연결되거나 연결이 끊어질 때 지정한 URL로 JSON POST 요청을 보낼 수 있습니다. 웹훅을 참고하세요.

문제 해결 #

"먼저 터널을 시작하세요."

터널 목록의 인스펙터 버튼은 실행 중인 터널에서만 열립니다. 터널을 시작하거나, 터널 설정에서 요청 로그 › 표시로 인스펙터를 여세요.

인스펙터가 비어 있습니다

세 가지를 확인하세요. "요청 로깅이 꺼져 있습니다" 배너가 표시되지 않아야 하고, 날짜 필터가 적용되어 있지 않아야 하며(실시간 보기를 선택), 요청이 서비스의 다른 주소가 아니라 터널 주소로 실제로 들어와야 합니다.

"아직 기록된 요청이 없습니다." 또는 "데이터를 찾을 수 없습니다!"

연결 로그에 터널의 항목이 없거나, CSV용으로 선택한 날짜 범위에 항목이 없습니다. 다른 범위를 선택하세요.

"이 터널의 로그가 없습니다."

활동 로그에 아직 항목이 없습니다. 터널을 시작하고 중지하고 변경하면 채워집니다.

이 페이지에 도움이 필요하신가요? 커뮤니티에 질문하거나 지원 티켓을 만들어 주세요.

지원