TCP 신서틱 테스트 생성¶
TCP 신서틱 테스트는 대상 포트의 연결 상태, 응답 시간, 라우팅 상황을 확인하는 데 사용됩니다. "수립됨", "거부됨" 또는 "시간 초과"를 기대 연결 상태로 설정하고 다른 판정 조건과 조합하여 포트가 기대에 부합하는지 확인할 수 있습니다. 응답 시간과 경로 추적 결과를 통해 연결 성능 및 네트워크 경로도 분석할 수 있습니다.
TCP 연결 성공은 연결이 수립되었음을 의미할 뿐 애플리케이션 계층 서비스의 정상 여부를 나타내지는 않습니다. 연결 시간 초과만으로 특정 방화벽 규칙이 적용되었거나 포트가 확실히 닫혀 있다고 단정할 수도 없습니다.
사전 요구 사항¶
선택한 실행 노드는 연결 상태 판정을 지원해야 합니다. 자체 호스팅 노드를 사용하는 경우 노드 버전이 해당 기능을 지원하는지 확인해야 합니다. 노드 설치 및 업데이트는 자체 호스팅 노드 관리 및 DataKit 업그레이드를 참조하세요.
생성 시작¶
생성 > API 테스트를 클릭하고 TCP 프로토콜을 선택합니다.
1단계: 요청 형식 정의¶
- Host: 호스트 주소와 포트를 입력할 수 있습니다. 호스트 주소는 도메인(예:
www.example.com) 또는 IP 주소(예:192.168.0.1)가 될 수 있으며 포트 기본값은443입니다. - 시간 초과: DNS 해석과 TCP 연결 수립을 기다리는 총 제한 시간을 설정합니다. 단위는 초이며 기본값은
10,1–60사이의 정수를 지원합니다. 입력이 비어 있거나 정수가 아니거나 범위를 벗어나면 테스트하거나 저장할 수 없습니다. - 이름: TCP 신서틱 테스트 이름을 직접 지정합니다. 현재 워크스페이스 내에서는 중복될 수 없습니다.
- 경로 추적: 활성화하면 경로 추적 프로브(
traceroute)가 시작되어 대상 호스트까지의 경로에 있는 모든 게이트웨이를 발견합니다(❗️경로 추적의 홉별 시간 초과 기본값은 500ms입니다).
DNS 해석과 연결 수립은 설정된 시간 초과를 공유합니다. 대상이 IP인 경우 연결 시도 시작 시점부터 시간을 측정합니다. 대기, 경로 추적, 연결 후 메시지 읽기/쓰기는 이 제한 시간에 포함되지 않습니다. 연결이 조기에 수립되거나 명시적으로 거부되면 시간 초과를 기다리지 않고 바로 후속 판정으로 진행합니다.
"시간 초과"는 대기 상한을 제어하고, "응답 시간" 판정 조건은 실제 소요 시간이 기준을 충족하는지 판단합니다. 두 항목은 각각 적용됩니다. 경로 추적의 홉별 시간 초과도 이 설정과 별개로 적용됩니다.
기존 작업을 편집할 때 시간 초과를 수정하지 않으면 원래 구성이 유지되며 10초로 자동 덮어쓰지 않습니다. 기존 구성이 새 입력 양식의 범위를 벗어나더라도 다른 필드를 편집하면 기존 값이 유지됩니다. 시간 초과를 직접 수정하는 경우 1–60초 정수로 검증합니다. 시간 초과가 명시적으로 구성되지 않은 기존 작업은 기존 기본 동작을 계속 사용합니다.
2단계: 가용성 판정¶
판정 조건을 추가하고 필터 조건에 따라 데이터를 매칭할 수 있습니다. 여러 판정 조건을 선택할 때 "모두" 또는 "임의"로 AND 또는 OR 논리 관계를 정의할 수 있습니다.
"연결 상태"를 선택하면 연산자는 "같음"이며 다음 기대 값을 지원합니다.
| 기대 상태 | 값 | 의미 |
|---|---|---|
| 수립됨 | established |
TCP 연결이 성공적으로 수립됨 |
| 거부됨 | refused |
연결 수립 시 명시적 거부를 수신함 |
| 시간 초과 | timeout |
TCP 연결 수립 단계가 제한 시간 내에 완료되지 않음 |
실제 연결 상태가 기대 상태와 일치하면 해당 판정이 통과합니다. 예를 들어 기대 상태가 "거부됨"이고 실제 연결이 거부된 경우 연결 상태 판정이 통과합니다. 최종 신서틱 테스트 결과는 전체 조건을 "모두" 또는 "임의"로 조합한 방식에 따라 결정됩니다.
연결 상태는 단독으로 사용하거나 응답 시간, 네트워크 홉 수와 조합할 수 있습니다. 예를 들어 시간 초과가 10초이고 조건이 "연결 상태가 수립됨과 같음", "응답 시간이 1000ms 미만"이며 "모두"를 선택한 경우: 5초에 연결이 수립되면 연결 상태 조건은 통과하지만 응답 시간 조건은 통과하지 않아 최종 신서틱 테스트는 실패합니다.
DNS 실패, DNS 시간 초과, 경로 없음, 노드 장애, 사용자 취소, 플랫폼 실행 시간 초과 등의 예외는 연결 상태 timeout에 해당하지 않으며 "연결 상태가 시간 초과와 같음" 판정을 통과할 수 없습니다. 연결 수립 후 읽기/쓰기 시간 초과도 연결 단계 시간 초과에 해당하지 않습니다.
테스트 및 결과¶
요청 및 조건 구성을 완료한 후 테스트를 클릭하면 실제 연결 상태, 기대 상태 및 판정 결과를 확인할 수 있습니다. 경로 추적 또는 네트워크 홉 수 조건을 구성한 경우 경로 추적 결과도 함께 반환됩니다.
"연결 상태가 거부됨과 같음"만 구성한 경우 실제로 거부되면 신서틱 테스트 성공으로 판정할 수 있습니다. "연결 상태가 시간 초과와 같음"만 구성한 경우 실제 연결 단계에서 시간 초과가 발생해도 성공으로 판정할 수 있습니다. 여러 조건을 구성할 때 각 조건의 결과와 조합 논리를 함께 확인해야 합니다.
정기 실행과 즉시 테스트는 동일한 시간 초과 및 판정 규칙을 사용합니다. 실행 상세에는 실제 연결 상태, 유효 시간 초과, 실행 측 진단 정보 및 최종 신서틱 테스트 결과가 표시되며, 작업에 구성된 기대 상태와 함께 결과를 분석할 수 있습니다. 과거 기록에 연결 상태 필드가 없으면 "—"로 표시되며, 과거의 성공 또는 실패 상태를 기준으로 유추하지 않습니다. 연결 상태 조건이 구성되지 않은 기존 작업은 기존 판정 동작을 유지합니다.
주의
- "네트워크 홉 수"를 판정 조건으로 선택하면 Traceroute 기능을 켠 것과 유사하게 경로 추적 데이터가 반환됩니다.
- 테스트 결과는 선택한 신서틱 테스트 노드와 관계없습니다.
3단계: 신서틱 테스트 노드 선택¶
현재 Guance는 전 세계 14개의 신서틱 테스트 노드를 제공합니다. 중국 지역 또는 해외 지역(상용 플랜 이상 사용자 전용)의 노드를 하나 이상 선택하여 사이트 서비스 품질 모니터링을 빠르게 시작할 수 있습니다.
4단계: 테스트 빈도 선택¶
신서틱 테스트 작업의 실행 빈도를 선택합니다. 다음 옵션을 지원합니다.
- 1분(상용 플랜 이상 사용자 전용)
- 5분(상용 플랜 이상 사용자 전용)
- 15분(상용 플랜 이상 사용자 전용)
- 30분
- 1시간
- 6시간
- 12시간
- 24시간
시스템에서 제공하는 위 옵션 외에도 사용자 정의 crontab 작업을 입력하여 분, 시간, 일, 월, 주 등의 주기로 예약 작업 실행을 구성할 수 있습니다.

