게이트웨이 UI YAML을 직접 작성하지 않고도 게이트웨이 규칙을 생성하고 관리할 수 있는 폼 기반 인터페이스를 제공합니다. UI 처리 로직을 샘플링 속도, 필터 및 변환이라는 세 가지 규칙 범주로 구성합니다. 각 범주는 안내형 모달 대화 상자를 통해 구성할 수 있습니다.
UI 조직
게이트웨이 UI 크게 세 부분으로 구성됩니다.
샘플링 속도
스프레드시트 데이터가 뉴렐릭에 도달하는 비율을 제어하기 위해 조건부 규칙을 사용하여 확률적 샘플링을 구성합니다. 지원 항목:
- 기본 샘플링 비율(0-100%)
- 속성 일치를 기반으로 한 조건부 샘플링 시나리오
일반적인 사용 사례:
- "B 서비스 로그의 90%, A 서비스 로그의 83%를 샘플링했습니다."
- "오류는 100% 유지하고, 1000ms 이상 지속되는 트레이스는 100% 유지하며, 나머지 중 10%만 샘플링합니다."
필터
OTTL 기반 필터 규칙을 생성하여 전체 텔레메트리 레코드 또는 특정 속성을 조건부로 필터링할 수 있습니다. 지원 항목:
- 정규 표현식에서
matches연산자를 사용한 패턴 매칭 - 속성 기반 필터링(환경, 메트릭 이름, 로그 레벨)
and/or논리를 사용한 결합 조건- 비교 연산자(
==,!=,>,<,>=,<=)
일반적인 사용 사례:
- "테스트 환경 데이터 삭제"
- "프로덕션 환경에서 디버그 레벨 로그를 삭제하세요"
- "건강 상태 점검 기간 제거"
- "테스트 접두사가 포함된 메트릭을 삭제하세요"
변환
OTTL 기반 변환 규칙을 정의하여 스프레드시트 데이터를 수정, 보강 또는 구문 분석합니다. 지원 항목:
- OTTL 함수를 사용한 속성 추가 및 수정
- 정규 표현식 패턴을 이용한 문자열 파싱
- 일치 규칙을 사용한 조건부 변환
- 변환당 여러 개의 OTTL 문
일반적인 사용 사례:
- "모든 메트릭에 환경 및 지역 태그를 추가합니다."
- "NGINX 로그 형식을 구조화된 속성으로 파싱"
- "환경 전반에 걸쳐 서비스 이름을 표준화합니다."
- "로그 메시지에서 HTTP 상태 코드 추출"
UI에서 규칙을 생성하세요
샘플링 속도 규칙 생성
게이트웨이 UI의 샘플링 속도 블록에서 톱니바퀴/설정 아이콘을 클릭하여 새 샘플링 구성을 생성합니다.
전역 샘플링을 구성합니다.
- 전체 샘플링 비율(0-100%)을 설정합니다.
- 슬라이더를 사용하거나 숫자 값을 입력하세요. 이는 조건부 규칙과 일치하지 않는 모든 데이터에 적용됩니다.
조건부 시나리오를 추가합니다(선택 사항):
- 플러스 아이콘을 클릭하여 조건별 샘플링 비율을 설정하세요.
- 각 시나리오에 대해 다음을 구성하십시오. 기술 이름(예: "
B service sample"), 설명(예: "B service description"), 속성 일치 표현식(예:attributes["appName"]=="TelemetryApp-ServiceB"), 슬라이더를 사용한 샘플링 백분율 또는 숫자 값(0-100%) 입력
샘플링 규칙을 적용하려면 Save sample criteria 클릭하십시오.
필터 규칙을 만드세요
게이트웨이 UI에서 필터 블록의 더하기 아이콘을 클릭하여 새 필터 규칙을 생성합니다.
기본 정보 설정:
- Rule name: 기술명을 입력하세요.
- Description규칙이 어떤 역할을 하는지 설명하세요.
데이터와 일치하는 조건을 정의하고 Create rule 클릭하세요.
필요에 따라 조건을 추가하려면 1-3단계를 반복하십시오.
변환 규칙을 생성합니다.
게이트웨이 UI에서 변환 블록의 더하기 아이콘을 클릭하여 새 변환 규칙을 생성합니다.
기본 정보 설정:
- Rule name: 기술 이름을 입력합니다(예: "
parse-nginx-logs"). - Description변환이 어떤 역할을 하는지 설명하세요.
- Rule name: 기술 이름을 입력합니다(예: "
데이터와 일치하는 조건을 정의하세요.
- 개구리, 목표별 텔레메트리 기록에 조건을 추가합니다.
- 여러 조건을 추가하려면 Add condition 클릭하세요.
여러 조건은 OR 논리로 평가됩니다(조건 중 하나라도 일치하면 변환이 적용됩니다). 예시 조건:
body == "request failed",severity.text == "ERROR",severity.text == "FATAL_ERROR"모든 레코드에 변환을 적용하려면 비워 두십시오. 각 조건은OR연산자로 구분된 별도의 입력 필드에 표시됩니다.OTTL 문을 정의하십시오:
- 하나 이상의 OTTL 변환문을 추가합니다.
- 여러 변환을 추가하려면 Add statement 클릭하세요.
- 각 명령은 순서대로 실행됩니다. 각 문장의 왼쪽에 있는 핸들을 드래그하여 순서를 변경하세요.
- OTTL 함수를 사용한 예시 문장:
set(severity_text, "FAIL"),set(attributes["processors"], true),set(attributes["environment"], "staging")
Preview rule 클릭하여 변환이 샘플 데이터를 어떻게 변경하는지 확인하세요.
변화가 만족스러울 때까지 수정하세요.
게이트웨이에 변환을 추가하려면 Create rule 클릭하십시오.
변경 사항을 구현하다, 배포하다
규칙을 구성한 후 다음 단계에 따라 설정을 구현하고 배포하세요.
Create Deployment 을(를) 클릭합니다.
새로운 구현, 배포 페이지에서:
- 구현, 배포에 대한 이름과 설명을 입력합니다.
- 구현하고, 배포하려는 파이프라인 제어 게이트웨이 에이전트를 식별합니다.
- 오른쪽의 점 메뉴를 열고 Change version 클릭하세요.
버전 목록에서 방금 생성한 설정에 해당하는 버전을 선택하십시오. (설정이 변경될 때마다 버전 번호가 자동으로 증가하므로 최신 버전일 것입니다.)
설정을 적용하려면 Add to deployment 클릭하십시오.
Save draft 클릭한 다음 Start deployment 클릭합니다.
구현 및 배포를 시작할 것인지 다시 한번 확인해야 합니다. 확인하려면 Start deployment 다시 클릭하세요.
OpenTelemetry 리소스
- OTTL 함수 참조 - 변환 및 필터링을 위한 부울 표현식에 대한 OTTL 함수의 전체 목록
- 변환 프로세서 - 공식 변환 프로세서 문서
- 필터 프로세서 - OTTL 부울 표현식 구문을 사용한 공식 필터 프로세서 문서
- 확률적 샘플러 프로세서 - 공식 샘플러 프로세서 문서