트리거 규칙 설정 가이드

트리거 규칙은 NetFUNNEL 대기열이 언제 적용될지를 결정하는 핵심 설정입니다. NetFUNNEL 콘솔의 세그먼트에서 트리거 규칙을 설정하여 특정 조건에 해당하는 요청에만 대기열을 적용할 수 있습니다.

1. 트리거 규칙 동작 원리

사용자가 접속한 페이지의 URL과 설정된 트리거 규칙을 비교하여 일치하는 경우에만 대기열이 적용됩니다.

1.1 기본 흐름

1. 사용자 요청 발생
2. URL 분석: 요청된 URL의 구성 요소를 파싱
3. 규칙 매칭: 설정된 트리거 규칙과 비교
4. 결과 처리: 매칭되면 대기열 적용, 그렇지 않으면 통과

---

2. 설정 옵션

2.1 Logical Operator (논리 연산자)

두 개 이상의 트리거 규칙을 생성할 때 규칙들 간의 관계를 정의합니다.

• AND: 모든 조건이 만족해야 트리거 실행
• OR: 하나 이상의 조건이 만족하면 트리거 실행

2.2 Validator (검증 대상)

트리거 규칙이 적용될 대상의 최상위 범위를 정의합니다.

• URL: 현재 지원되는 유일한 옵션

향후 Header, Cookie 등 추가 예정

2.3 Component (구성 요소)

Validator 내에서 더 세부적으로 규칙을 적용할 대상을 지정합니다.

Component	설명	예시
URL	전체 URL	https://example.com/page?id=123
Domain	도메인명	example.com, www.example.com
Path	경로	/page, /api/users

2.4 Negate (부정)

설정한 조건의 적용 방식을 결정합니다.

• Does: 조건이 참일 때 트리거 실행 (기본값)
• Does not: 조건이 거짓일 때 트리거 실행 (부정)

2.5 Match (매칭 방식)

조건 판별 방식을 정의합니다.

Match 유형	설명	사용 가능 Component	예시
Exists	해당 요소가 존재하는지 확인	Path만 가능	Path가 존재하는가?
Equals	완전히 일치하는지 확인	URL, Domain, Path	Path가 `/event`와 정확히 일치
Contains	포함되어 있는지 확인	URL, Domain, Path	Domain에 `api`가 포함
StartsWith	특정 값으로 시작하는지 확인	URL, Domain, Path	Path가 `/mobile`로 시작
EndsWith	특정 값으로 끝나는지 확인	URL, Domain, Path	Path가 `.html`로 끝남

2.6 Value (비교값)

Match 조건과 함께 사용할 구체적인 값을 지정합니다.

2.7 Aa (대소문자 구분)

Value와 비교할 때 대소문자를 구분할지 결정합니다.

• 체크 안함: 대소문자 구분 안함 (`Event` = `event`)
• 체크함: 대소문자 구분함 (`Event` ≠ `event`)

---

3. 실제 사용 예시

3.1 특정 페이지에만 적용

티켓 예매 페이지에만 대기열 적용

Validator    : URL
Component    : Path
Match        : Equals
Value        : /ticket-booking
Negate       : Does (기본값)
Aa           : 체크 안함 (대소문자 구분 안함)

https://example.com/ticket-booking → 대기열 적용

https://example.com/ticket-booking/123 → 대기열 미적용

https://example.com/TICKET-BOOKING → 대기열 미적용 (대소문자 다름)

3.2 이벤트 관련 페이지들에 적용

/event로 시작하는 모든 페이지에 대기열 적용

Validator    : URL
Component    : Path
Match        : StartsWith
Value        : /event
Negate       : Does (기본값)
Aa           : 체크 안함 (대소문자 구분 안함)

https://example.com/event → 대기열 적용

https://example.com/event/concert → 대기열 적용

https://example.com/event/sale?id=123 → 대기열 적용

https://example.com/product/event → 대기열 미적용

3.3 관리자 페이지 제외

관리자 페이지가 아닌 모든 페이지에 대기열 적용

Validator    : URL
Component    : Path
Match        : StartsWith
Value        : /admin
Negate       : Does not (부정 조건)
Aa           : 체크 안함 (대소문자 구분 안함)

https://example.com/admin → 대기열 미적용 (관리자 페이지)

https://example.com/admin/users → 대기열 미적용 (관리자 페이지)

https://example.com/main → 대기열 적용

https://example.com/product/123 → 대기열 적용

이 설정은 `/admin`으로 시작하는 모든 경로를 대기열에서 제외하여, 관리자들이 시스템 관리 업무를 원활하게 수행할 수 있도록 합니다.

3.4 복합 조건 (AND 사용)

특정 도메인의 프리미엄 페이지에만 대기열 적용

Rule 1
├─ Validator : URL
├─ Component : Domain
├─ Match     : Equals
├─ Value     : premium.example.com
└─ Negate    : Does

Logical Operator: AND

Rule 2
├─ Validator : URL
├─ Component : Path
├─ Match     : StartsWith
├─ Value     : /vip
└─ Negate    : Does

https://premium.example.com/vip/products → 대기열 적용 (두 조건 모두 만족)

https://premium.example.com/regular/products → 대기열 미적용 (경로 조건 불만족)

https://main.example.com/vip/products → 대기열 미적용 (도메인 조건 불만족)

3.5 복합 조건 (OR 사용)

핫딜 또는 플래시 세일 페이지에 대기열 적용

Rule 1
├─ Validator : URL
├─ Component : Path
├─ Match     : StartsWith
├─ Value     : /hot-deal
└─ Negate    : Does

Logical Operator: OR

Rule 2
├─ Validator : URL
├─ Component : Path
├─ Match     : StartsWith
├─ Value     : /flash-sale
└─ Negate    : Does

https://example.com/hot-deal → 대기열 적용 (규칙 1 만족)

https://example.com/hot-deal/summer → 대기열 적용 (규칙 1 만족)

https://example.com/flash-sale → 대기열 적용 (규칙 2 만족)

https://example.com/flash-sale/electronics → 대기열 적용 (규칙 2 만족)

https://example.com/regular-sale → 대기열 미적용 (두 조건 모두 불만족)

---

4. 트리거 규칙 테스트

4.1 테스트 기능 사용

NetFUNNEL 콘솔에서 제공하는 테스트 기능을 통해 설정한 규칙이 올바르게 동작하는지 미리 확인할 수 있습니다.

1. 콘솔 접속 → 세그먼트 관리 → 트리거 규칙
2. 테스트 URL 입력: 확인하고 싶은 URL 입력
3. 결과 확인: 규칙 적용 여부 즉시 확인

4.2 테스트 시 주의사항

• 실제 운영 환경과 동일한 URL 구조로 테스트
• 대소문자 설정에 따른 결과 차이 확인

---

5. 모범 사례

5.1 성능 최적화

• 구체적인 규칙 우선: 너무 포괄적인 규칙보다는 구체적인 규칙 사용
• 최소한의 규칙: 복잡한 다중 조건보다는 단순하고 명확한 규칙 권장

5.2 운영 안정성

• 점진적 적용: 처음에는 제한적으로 적용한 후 점차 확대
• 예외 케이스 고려: 관리자 페이지등은 제외 규칙 설정
• 정기적 검토: 서비스 변경에 따른 규칙 업데이트

5.3 사용자 경험

• 핵심 페이지 우선: 트래픽이 집중되는 주요 페이지에 먼저 적용

---

6. 문제 해결

6.1 규칙이 적용되지 않는 경우

1. URL 형식 확인: 실제 요청 URL과 설정된 규칙 비교
2. 대소문자 설정 확인: Aa 옵션 설정 재확인
3. Negate 설정 확인: Does/Does not 설정이 의도와 일치하는지 확인

6.2 예상과 다르게 동작하는 경우

1. 논리 연산자 확인: AND/OR 설정이 의도와 일치하는지 확인
2. Component 선택 확인: 올바른 URL 구성 요소를 선택했는지 확인
3. 테스트 기능 활용: 콘솔의 테스트 기능으로 단계별 확인

규칙 설정에 대한 더 자세한 도움이 필요하시면 기술 지원팀에 문의해 주세요.