본문으로 건너뛰기
버전: 4.6.2-saas

기본 설정

"기본 설정"은 구간 제어 세그먼트의 기본 구성 섹션으로, 세그먼트 생성, 이름 지정 및 필수 설정 매개변수를 다룹니다. 이 가이드는 세그먼트 생성 프로세스, 세그먼트 이름 지정 모범 사례 및 세그먼트 키 구성에 대해 다룹니다.

Basic Settings Console

개요​

기본 설정은 구간 제어 세그먼트를 생성하고 구성하는 곳입니다. 트래픽 제어 시스템의 기반을 설정하는 것과 같습니다. 여기서 세그먼트의 수명 주기 동안 세그먼트를 식별하고 관리할 필수 매개변수를 정의합니다.

구성할 항목​

  • 세그먼트 이름: 쉽게 관리할 수 있는 사람이 읽을 수 있는 이름
  • 세그먼트 키: NetFUNNEL 에이전트가 사용하는 고유 식별자

세그먼트 생성​

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

새 구간 제어 세그먼트를 생성하려면:

  1. 세그먼트 목록 액세스: NetFUNNEL 콘솔의 세그먼트 관리 섹션으로 이동
  2. 생성 버튼 클릭: 세그먼트 목록의 오른쪽 상단에 있는 '+' 버튼 클릭
  3. 제어 유형 선택: 제어 유형에서 '구간 제어' 선택
  4. 구성 진행: 자세한 구성을 위해 다음 단계로 진행

세그먼트 생성 프로세스​

세그먼트 생성 프로세스는 간단하며 필수 설정 단계를 안내하도록 설계되었습니다. 구간 제어를 선택하면 세그먼트의 기본 설정을 정의할 수 있는 구성 화면으로 이동합니다.

구성 프로세스​

세그먼트 이름​

목록에서 쉽게 구분할 수 있는 이름을 입력하세요. 이것은 순전히 관리 편의를 위한 것입니다.

이름 지정 모범 사례​

무엇을 제어하는지 알려주는 좋은 이름:

  • "체크아웃 프로세스"
  • "등록 흐름"
  • "예약 구간"
  • "결제 처리"

이런 이름은 피하세요:

  • "세그먼트 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"

이런 키는 피하세요:

  • 공백이나 특수 문자가 있는 키
  • 너무 길거나 너무 짧은 키
  • 명명 규칙을 따르지 않는 키

세그먼트 키를 변경할 수 없는 이유​

중요: 세그먼트 키 불변성

세그먼트가 생성되면 키는 수정할 수 없습니다. 이것은 기존 통합에 문제가 발생하지 않도록 의도적으로 설계된 결정입니다.

키 변경의 문제점: 세그먼트 키를 생성 후 변경할 수 있다면 기존 통합에 문제가 발생합니다:

  1. 코드 종속성: 애플리케이션 코드가 세그먼트 키를 참조함
  2. 통합 중단: 키를 변경하면 기존 통합이 중단됨
  3. 예기치 않은 동작: 에이전트가 작동을 중지하거나 예기치 않게 동작할 수 있음

다른 키가 필요한 경우 수행할 작업: 세그먼트 키를 변경해야 하는 경우 다음을 따르세요:

  1. 새 세그먼트 생성: 원하는 키로 새 세그먼트 생성
  2. 코드 업데이트: 새 세그먼트 키를 사용하도록 애플리케이션 코드 업데이트
  3. 철저한 테스트: 새 통합이 올바르게 작동하는지 확인
  4. 기존 세그먼트 삭제: 새 세그먼트가 작동하는 것을 확인한 후에만 기존 세그먼트 삭제
모범 사례

생성하기 전에 항상 세그먼트 키를 신중하게 계획하세요. 명명 규칙과 전체 트래픽 제어 전략에 어떻게 맞을지 고려하세요.