본문으로 건너뛰기
버전: 4.6.1

구간 제어 세그먼트

구간 제어 세그먼트는 고정된 수의 동시 사용자를 유지해야 하는 다단계 프로세스 및 애플리케이션 구간에 대한 트래픽 제어를 제공합니다. 이 가이드는 구간 제어 세그먼트를 이해하고 설정하는 데에 도움을 드립니다..

구간 제어 세그먼트란 무엇인가요?​

구간 제어 세그먼트는 다단계 프로세스 또는 전체 애플리케이션 구간에 대한 트래픽을 제어하는 작업 단위입니다. 보호된 구간 내에서 고정된 수의 동시 사용자를 유지하며, 전체 프로세스가 완료될 때까지 진입 키를 보유합니다.

주요 특징​

구간 제어 vs 기본 제어:

근본적인 차이점은 키 관리입니다. NetFUNNEL이 진입 키를 반환하는 방식과 시점에 차이를 둡니다:

제어 유형키 관리목적최적 용도
기본 제어작업 완료 후 키 빠르게 반환진입 속도 제어버튼 클릭, API 호출, 페이지 로드, 특정 URL/페이지
구간 제어전체 구간/프로세스 완료까지 키 보유고정된 동시 사용자 수 유지다단계 프로세스, 체크아웃 흐름, 결제 처리

구간 제어 - 절차 완료까지 키 보유:

  • 특정 구간에서 고정된 수의 동시 사용자 유지
  • 전체 다단계 프로세스 동안 키가 보유됨
  • 전체 구간/프로세스가 완료될 때만 키가 반환됨 (예: 체크아웃 완료, 결제 처리)
  • 사용자 여정: 시작 → 구간 진입 → 여러 단계 → 전체 프로세스 완료 → 키 반환
  • 최적 용도: 다단계 프로세스, 체크아웃 흐름, 고정된 동시 사용자 수 유지

기본 제어 - 빠른 키 반환:

  • 사용자가 서비스에 진입하는 속도를 제어
  • 작업이 완료되면 즉시 키가 반환됨 (예: 페이지 로드, API 호출 완료)
  • 예시: /checkout 페이지 로드, /payment 엔드포인트, /signup 버튼 클릭
  • 사용자 여정: 작업 → 필요 시 대기 → 즉시 진입 → 키 빠르게 반환
  • 최적 용도: 단일 작업, API 스로틀링, 페이지 보호, 타겟 급증 지점

구간 제어를 사용해야 하는 경우:

  • 다단계 프로세스가 있음 (체크아웃, 등록, 다중 페이지 흐름)
  • 구간에서 고정된 수의 동시 사용자를 유지해야 함
  • 개별 페이지가 아닌 전체 프로세스 흐름에 대한 트래픽 제어를 원함
  • 사용자가 여러 페이지/단계를 탐색하는 프로세스가 있음
  • 코드 기반 통합 (CBI)만 사용 (URL 트리거 통합은 지원되지 않음)

통합 방법:

  • 코드 기반 통합 (CBI): 코드에서 nfStartSection() 및 nfStopSection()을 사용해 수동으로 제어합니다. 보호된 구간이 시작되고 종료되는 시점을 정확히 지정합니다.

구성 개요​

구간 제어 세그먼트는 다음 주요 설정으로 구성됩니다:

1. 기본 설정​

기능: 세그먼트의 식별자 정의 - 이름 및 고유 키

  • 세그먼트 이름: 세그먼트의 사람이 읽을 수 있는 식별자
  • 세그먼트 키: NetFUNNEL 에이전트가 사용하는 고유 식별자 (생성 후 변경 불가)

자세히 알아보기 →

2. 진입 상태 설정​

기능: 제어된 영역에 진입할 때 사용자가 처리되는 방식 결정

  • 대기 상태: 사용자가 대기열에서 대기하고 진입 허용 수가 사용 가능할 때 진입
  • 차단 상태: 사용자의 진입이 차단됨 (차단실 메시지 표시)

자세히 알아보기 →

3. 진입 제어 모델 설정​

기능: 세그먼트에 대한 트래픽 진입 제어 모델 선택

  • 변동 진입형: 실시간 트래픽에 따른 유연한 대기열 관리

구간 제어는 변동 진입형만 지원합니다. 고정 진입형은 사용할 수 없습니다.

자세히 알아보기 →

4. 대기실 적용​

기능: 대기 중이거나 차단된 사용자가 보는 UI 구성

  • 대기실: 대기열 사용자에게 표시되는 템플릿
  • 차단실: 차단된 사용자에게 표시되는 템플릿
  • 라이브 메시지: 실시간 텍스트 업데이트 (최대 20자)

참고: 구간 제어 대기실은 다단계 프로세스에서 사용자 체류 시간이 가변적이기 때문에 "예상 대기 시간"을 표시하지 않습니다.

자세히 알아보기 →

5. 진입 허용 수 설정​

기능: 동시에 액세스할 수 있는 사용자 수 제어

  • 고정형: 일정한 진입 허용 수 (예: 항상 100명의 사용자)

구간 제어는 고정형만 지원합니다. 구간 제어에서 처리 시간은 서버 부하가 아닌 사용자 체류 시간을 반영하기 때문에 변동형은 지원되지 않습니다.

0으로 설정하면 모든 사용자가 대기실로 이동합니다 (테스트 유용).

자세히 알아보기 →

6. 대기 알림 설정​

기능: 관리자를 위한 알림 구성

  • 관리자 대기 알림: 대기열 발생 시 이메일 알림

구간 제어는 관리자 대기 알림만 지원합니다. 고객 대기 알림(진입 알림)은 사용할 수 없습니다.

자세히 알아보기 →

7. 고급 기능​

고급 타이밍:

  • 재요청 주기: 클라이언트가 진입 가용성을 확인하는 빈도 (1-60초)
  • Alive Notice 재요청 주기: 에이전트가 "여전히 활성 상태" 신호를 보내는 빈도 (1-60초)
  • Alive Notice 기간 만료: 사용자가 활성 상태로 유지될 수 있는 최대 기간 (1-3600초)
  • 타임아웃: 사용되지 않은 슬롯에 대한 자동 키 반환 메커니즘 (6-60초)

자세히 알아보기 →

대기 순번 유지: 연결 끊김 후 대기 순번 복원 (1초 ~ 2시간).

자세히 알아보기 →

진입 키 무효화: 사용자 범위 지정(진입한 사용자만 또는 대기중 사용자부터)을 통한 특정 기간에 대한 강제 재대기.

자세히 알아보기 →

담당자 지정: 세그먼트 관리에 대한 책임 실무자 지정.

자세히 알아보기 →

첫 번째 세그먼트 생성하기​

빠른 시작​

  1. 세그먼트 목록으로 이동: 프로젝트의 세그먼트 관리로 이동
  2. 생성 클릭: 세그먼트 목록의 오른쪽 상단에 있는 '+' 버튼 클릭
  3. 유형 선택: 제어 유형에서 '구간 제어' 선택
  4. 구성: 필요에 따라 각 섹션 설정
  5. 테스트: 실시간 지표 모니터링 및 다단계 프로세스 동작 확인

기본 워크플로우​

세그먼트 생성
    ↓
기본 설정 (이름, 키)
    ↓
진입 상태 (대기/차단)
    ↓
진입 제어 모델 (변동 진입형)
    ↓
대기실 적용 (템플릿 선택)
    ↓
진입 허용 수 설정 (고정형)
    ↓
대기 알림 (선택 사항)
    ↓
고급 기능 (선택 사항)
    ↓
nfStartSection() 및 nfStopSection() 구현
    ↓
테스트 및 배포