# Connection Log (연결 로그)

> Proxyman Connection Log로 요청마다 DNS 조회, TCP 연결, TLS 핸드셰이크, 인증서, HTTP 헤더를 확인하세요.

## 1. 기능 소개 {#1-whats-it}

Connection Log는 Proxyman이 서버에 연결하고 요청을 전송하는 과정을 보여줍니다. `curl -v`와 비슷한 텍스트 형식을 사용하며, 색상으로 주요 정보를 쉽게 찾을 수 있습니다.

* DNS 조회부터 HTTP 응답까지 연결 과정을 따라갈 수 있습니다.
* Proxyman이 요청을 처리하면서 캡처한 단계를 확인할 수 있습니다.
* Proxyman과 업스트림 서버 사이의 연결을 살펴볼 수 있습니다.
* Request 패널의 Summary 옆에서 로그를 읽을 수 있습니다.

![Request 패널의 Connection Log 화면. DNS 결과, TLS 핸드셰이크, 인증서 세부 정보, 요청 헤더가 표시됨](https://proxyman.com/docs/assets/connection-log.png)

_HTTPS 요청의 단계를 보여주는 Connection Log_

## 2. 장점 {#2-benefits}

* 연결 실패 지점 찾기: DNS 조회, TCP 연결, TLS 핸드셰이크
* Proxyman이 연결한 호스트와 IP 주소 확인
* 서버가 수락한 TLS 버전과 HTTP 프로토콜 확인
* 서버 인증서의 이름, 발급자, 만료일 확인
* 요청이 기존 연결을 재사용했는지 확인
* 캡처한 정보를 저장해 나중에 확인하거나 팀과 공유

## 3. 사용 방법 {#3-how-to-use-it}

1. Proxyman for macOS를 실행하고 요청을 캡처합니다.
2. 메인 목록에서 요청을 선택합니다.
3. Request 패널에서 **Summary** 바로 뒤의 **Connection Log**를 클릭합니다.

이 탭은 신규 사용자와 업그레이드한 기존 사용자 모두 기본으로 켜져 있습니다. 선택한 연결이 활성 상태인 동안 로그가 업데이트됩니다.

표시하거나 숨기려면 다음을 따르세요:

* Request 탭 바의 **+** 버튼을 클릭해 [Custom Previewer Tab](https://proxyman.com/docs/ko/basic-features/custom-previewer-tab)을 엽니다.
* Request 아래에서 **Connection Log**를 체크하거나 체크 해제합니다.
* Proxyman은 재시작 후에도 설정을 기억합니다.

HTTPS 요청 및 응답 내용을 보려면 Proxyman 인증서를 설정하고 해당 도메인의 [SSL Proxying](https://proxyman.com/docs/ko/basic-features/ssl-proxying)을 활성화하세요. SSL Proxying 없이는 암호화된 내용이 가려지고 연결 정보도 적게 표시됩니다.

## 4. 표시되는 정보 {#4-what-does-it-show}

로그에는 선택한 요청에서 확인할 수 있는 세부 정보가 나열됩니다.

### DNS 및 TCP 연결 {#dns-and-tcp-connection}

* 호스트 이름과 포트
* DNS 조회로 얻은 IPv4 및 IPv6 주소
* 각 연결 시도와 실패한 시도
* 연결된 서버의 IP 주소와 포트
* 사용하는 경우 업스트림 프록시
* 연결이 재사용되었는지, 열린 상태인지, 닫혔는지 여부

### TLS 핸드셰이크 및 인증서 {#tls-handshake-and-certificate}

* `h2` 또는 `http/1.1`처럼 ALPN으로 제시된 프로토콜. ALPN을 통해 Proxyman과 서버가 애플리케이션 프로토콜을 선택합니다.
* `Client hello`, `Server hello`, `Certificate`, `Finished` 등 핸드셰이크 단계
* `SSL connection using` 줄에 표시되는 협상된 TLS 버전과 암호 스위트
* 서버가 수락한 프로토콜
* 인증서 주체, 발급자, DNS/IP 이름, 유효 기간
* 인증서 및 호스트 이름 검증 결과와 TLS 경고 또는 실패

### HTTP 요청 및 응답 {#http-request-and-response}

* 요청 메서드, 경로, HTTP 버전, 헤더
* 응답 상태와 헤더
* 가능한 경우 텍스트 응답 본문 미리보기
* 본문이 디코딩, 수정 또는 표시를 위해 축약되었을 때 이를 설명하는 메시지

DNS, TCP, TLS 소요 시간을 비교하려면 **Timing** 탭을 사용하세요.

## 5. 로그 읽는 방법 {#5-how-to-read-it}

* `*`는 연결 이벤트 또는 진단 메시지를 나타냅니다.
* `>`는 서버로 보낸 요청 헤더를 나타냅니다.
* `<`는 서버에서 받은 응답 헤더를 나타냅니다.
* `OUT`과 `IN`은 Proxyman 기준으로 본 TLS 메시지의 방향을 나타냅니다.

색상을 보면 로그를 빠르게 훑어볼 수 있습니다:

* 청록색: 호스트 이름과 IP 주소
* 보라색: TLS 버전과 ALPN 프로토콜
* 파란색: 핸드셰이크 단계. HTTP 헤더 이름은 Raw 탭과 같은 스타일로 표시됩니다.
* 녹색: 성공한 핸드셰이크 단계와 검증 결과
* 앰버: 인증서 검증 비활성화 등 경고
* 빨간색: 인증서 거부나 연결 시간 초과 등 실패

`Certificate verification disabled`는 해당 연결에서 Proxyman이 서버 인증서를 검증하지 않았다는 뜻입니다. 인증서가 유효하지 않다는 의미는 아닙니다. 마찬가지로 `Hostname verification: not performed`는 해당 검사를 건너뛰었다는 뜻입니다.

재사용된 연결은 요청마다 새로운 DNS 조회나 TLS 핸드셰이크를 보여주지 않을 수 있습니다.

## 6. 로그 저장 및 다시 열기 {#6-save-and-reopen-the-log}

* [플로우 내보내기](https://proxyman.com/docs/ko/basic-features/import-export)로 Proxyman Log(`.proxymanlogv2`)를 저장하거나, [세션 저장](https://proxyman.com/docs/ko/advanced-features/save-session)을 이용하세요.
* 파일을 다시 열고 **Connection Log**를 선택하면 저장된 연결 정보를 볼 수 있습니다.
* Proxyman은 기록된 이벤트를 저장하고, 탭을 열 때 표시할 로그를 생성합니다.
* 인증서 세부 정보는 텍스트 필드로 저장됩니다. 전체 인증서, 인증서 체인, 개인 키는 연결 정보와 함께 저장되지 않습니다.
* 연결 정보가 없는 이전 캡처도 계속 열 수 있습니다. 이 경우 로그에는 저장된 HTTP 데이터가 표시되고, 연결 정보가 기록되지 않았다는 안내가 나타납니다.

## 더 알아보기 {#learn-more}

* [Proxyman v26.0.0에서 드디어 지원하는 HTTP/2](https://proxyman.com/posts/2026-09-19-http2-is-finally-here)