기본 설정
"기본 설정"은 구간 제어 세그먼트의 기본 구성 섹션으로, 세그먼트 생성, 이름 지정 및 필수 설정 매개변수를 다룹니다. 이 가이드는 세그먼트 생성 프로세스, 세그먼트 이름 지정 모범 사례 및 세그먼트 키 구성에 대해 다룹니다.
개요
기본 설정은 구간 제어 세그먼트를 생성하고 구성하는 곳입니다. 트래픽 제어 시스템의 기반을 설정하는 것과 같습니다. 여기서 세그먼트의 수명 주기 동안 세그먼트를 식별하고 관리할 필수 매개변수를 정의합니다.
구성할 항목
- 세그먼트 이름: 쉽게 관리할 수 있는 사람이 읽을 수 있는 이름
- 세그먼트 키: NetFUNNEL 에이전트가 사용하는 고유 식별자
세그먼트 생성
첫 번째 세그먼트 생성하기
새 구간 제어 세그먼트를 생성하려면:
- 세그먼트 목록 액세스: NetFUNNEL 콘솔의 세그먼트 관리 섹션으로 이동
- 생성 버튼 클릭: 세그먼트 목록의 오른쪽 상단에 있는 '+' 버튼 클릭
- 제어 유형 선택: 제어 유형에서 '구간 제어' 선택
- 구성 진행: 자세한 구성을 위해 다음 단계로 진행
세그먼트 생성 프로세스
세그먼트 생성 프로세스는 간단하며 필수 설정 단계를 안내하도록 설계되었습니다. 구간 제어를 선택하면 세그먼트의 기본 설정을 정의할 수 있는 구성 화면으로 이동합니다.
구성 프로세스
세그먼트 이름
목록에서 쉽게 구분할 수 있는 이름을 입력하세요. 이것은 순전히 관리 편의를 위한 것입니다.
이름 지정 모범 사례
무엇을 제어하는지 알려주는 좋은 이름:
"체크아웃 프로세스""등록 흐름""예약 구간""결제 처리"
이런 이름은 피하세요:
"세그먼트 1","테스트","새 세그먼트"- 세그먼트가 실제로 무엇을 제어하는지 알려주지 않는 이름
- 너무 일반적이거나 추상적인 이름
팁: 여러 환경이 있는 경우 이름에 포함하세요:
"체크아웃 프로세스 - 프로덕션""체크아웃 프로세스 - 스테이징"
구간 제어 이름 지정 가이드:
- 제어되는 다단계 프로세스 또는 구간에 집중
- 동시 사용자 수 관리 측면 표시 (예: "결제 흐름"은 제어된 동시 사용자를 의미)
세그먼트 키
세그먼트 키는 자동으로 할당되며 생성 시까지 수정 가능합니다 (생성 후 수정 불가).
세그먼트 키란 무엇인가요?
세그먼트 키는 세그먼트의 신분증과 같습니다. NetFUNNEL 에이전트가 NetFUNNEL 서버와 통신할 때 이 키를 사용하여 특정 구간에서 동시에 얼마나 많은 사용자가 있을 수 있는지 제어합니다.
구간 제어의 경우: 키는 다단계 프로세스 전체(예: 체크아웃, 등록) 동안 보유되며, 전체 구간이 완료될 때만 반환됩니다. 이것은 해당 구간 내에서 제어된 동시 사용자 수를 유지합니다.
세그먼트 키 작동 방식
웹/JavaScript 통합:
nfStartSection({
projectKey: "your_project_key",
segmentKey: "your_segment_key" // 이것이 세그먼트 키입니다
}, function(response) {
// 응답 처리
if (response.status === 'Success') {
// 사용자가 구간에 진입함
}
});
Android 통합:
Netfunnel.nfStartSection(
projectKey = "your_project_key",
segmentKey = "your_segment_key", // 이것이 세그먼트 키입니다
callback = yourCallback,
activity = this
)
iOS 통합:
Netfunnel.shared.nfStartSection(
projectKey: "your_project_key",
segmentKey: "your_segment_key" // 이것이 세그먼트 키입니다
)
세그먼트 키 특징
- 고유 식별자: 모든 세그먼트에서 중복 허용 안 됨
- API 사용: API 호출(트래픽 제어 코드)에 사용됨
- 불변: 세그먼트 생성 후 변경 불가
- 대소문자 구분: 세그먼트 키는 대소문자를 구분합니다
기본 키 형식
새 세그먼트를 생성하면 NetFUNNEL이 다음 형식으로 키를 자동 생성합니다:
segKey_XXXX
여기서 XXXX는 4자리 난수입니다 (예: segKey_1234, segKey_5678).
세그먼트 키 사용자 정의
생성 중에 세그먼트 키를 사용자 정의하여 더 의미 있게 만들 수 있습니다:
좋은 사용자 정의 키:
"checkout_process""payment_flow""registration_section""booking_control"
이런 키는 피하세요:
- 공백이나 특수 문자가 있는 키
- 너무 길거나 너무 짧은 키
- 명명 규칙을 따르지 않는 키
세그먼트 키를 변경할 수 없는 이유
세그먼트가 생성되면 키는 수정할 수 없습니다. 이것은 기존 통합에 문제가 발생하지 않도록 의도적으로 설계된 결정입니다.
키 변경의 문제점: 세그먼트 키를 생성 후 변경할 수 있다면 기존 통합에 문제가 발생합니다:
- 코드 종속성: 애플리케이션 코드가 세그먼트 키를 참조함
- 통합 중단: 키를 변경하면 기존 통합이 중단됨
- 예기치 않은 동작: 에이전트가 작동을 중지하거나 예기치 않게 동작할 수 있음
다른 키가 필요한 경우 수행할 작업: 세그먼트 키를 변경해야 하는 경우 다음을 따르세요:
- 새 세그먼트 생성: 원하는 키로 새 세그먼트 생성
- 코드 업데이트: 새 세그먼트 키를 사용하도록 애플리케이션 코드 업데이트
- 철저한 테스트: 새 통합이 올바르게 작동하는지 확인
- 기존 세그먼트 삭제: 새 세그먼트가 작동하는 것을 확인한 후에만 기존 세그먼트 삭제
생성하기 전에 항상 세그먼트 키를 신중하게 계획하세요. 명명 규칙과 전체 트래픽 제어 전략에 어떻게 맞을지 고려하세요.