게이트웨이 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 클릭하십시오.
새로 생성된 설정 버전을 저장하려면 Save draft [초안 저장] 을 클릭합니다.
변경 사항을 구현하다, 배포하다
규칙을 구성한 후 다음 단계에 따라 설정을 구현하고 배포하세요.
Create Deployment 을(를) 클릭합니다.
새 배포 페이지에서 미리 채워진 정보를 검토하십시오:
- 기본 이름과 설명이 제공됩니다. 변경 사항을 추적하는 데 도움이 되도록 이를 편집할 수 있습니다.
- 배포에는 현재 플릿과 연결된 에이전트가 자동으로 포함됩니다.
- 시스템은 사용자의 설정 버전을 기본값으로 사용합니다. 원하는 경우, 이 세부 정보를 변경할 수 있습니다.
설정을 적용하려면 Start deployment 클릭하십시오.
구현 및 배포를 시작할 것인지 다시 한번 확인해야 합니다. 확인하려면 Start deployment 다시 클릭하세요.
배포가 완료되는 데 몇 분 정도 소요됩니다.
OpenTelemetry 리소스
- OTTL 함수 참조 - 변환 및 필터링을 위한 부울 표현식에 대한 OTTL 함수의 전체 목록
- 변환 프로세서 - 공식 변환 프로세서 문서
- 필터 프로세서 - OTTL 부울 표현식 구문을 사용한 공식 필터 프로세서 문서
- 확률적 샘플러 프로세서 - 공식 샘플러 프로세서 문서