감지 규칙¶

시스템에 풍부한 내장 감지 규칙이 있어 다양한 데이터의 모니터링 요구를 정확하게 매칭하고, 잘못된 알람과 누락된 알람을 효과적으로 방지할 수 있습니다.

구성 절차¶

모니터를 생성하려면 다음 순서에 따라 구성을 완료해야 합니다:

1. 규칙 유형 선택: 감지 구성의 데이터 범위와 알고리즘 로직을 결정합니다.
2. 감지 구성: 유형에 따라 다른 설정 항목이 제공됩니다.
3. 이벤트 알림: 이벤트 제목, 내용, 관련 정보 및 데이터 누락 처리를 정의합니다.
4. 알림 구성: 알림 정책과 음소거 주기를 설정합니다.
5. 연결: 대시보드를 연결합니다.
6. 권한: 작업 권한을 설정합니다.

"감지 구성"은 규칙 유형에 따라 달라지지만, 이벤트 알림, 알림 구성, 연결 및 권한은 모든 규칙 유형에서 설정 로직이 동일합니다.

규칙 유형¶

모니터링 대상에 따라 적합한 감지 로직을 선택할 수 있습니다:

규칙 유형을 선택하면 "감지 구성" 모듈의 선택 가능한 매개변수가 변경됩니다. 이벤트 알림 및 이후 구성은 모든 유형에서 동일하게 유지됩니다.

감지 구성¶

각 감지 규칙 유형에 따라 해당 감지 빈도, 감지 구간 및 감지 메트릭을 각각 구성할 수 있습니다.

감지 구성은 규칙 유형별로 차이가 크므로, 해당 유형의 상세 구성 문서를 참조하십시오.

데이터 대기 창¶

데이터 대기 창은 모든 모니터 유형에 적용됩니다. 예정된 실행 시간이 도달하면 모니터가 먼저 지정된 시간 동안 기다린 후 모니터링 판단을 실행하여 데이터 지연으로 인한 오탐 가능성을 줄입니다.

• 기본값은 대기하지 않음입니다.
• 선택 가능한 대기 시간은 1분, 2분, 3분, 5분, 10분, 15분, 30분입니다.
• 대기 시간은 인접한 두 번의 예정 실행 시간 간격보다 짧아야 합니다. 그렇지 않으면 모니터를 저장할 수 없으며 "데이터 대기 창은 모니터 실행 간격보다 작아야 합니다"라는 메시지가 표시됩니다. Crontab 모드에서도 인접한 두 번의 예정 실행 시간을 기준으로 검증합니다.

예를 들어, 모니터가 10:00에 실행되도록 예정되고 데이터 대기 창이 5분으로 설정된 경우, 작업은 약 10:05에 실행을 시작합니다. 대기는 실행 시간만 지연시킬 뿐, 쿼리 시간 범위는 변경하지 않습니다. 감지 구간이 최근 1시간인 경우에도 09:00 ~ 10:00의 데이터를 계속 쿼리합니다.

자세한 실행 로직은 모니터 내부 원리를 참조하십시오.

이벤트 알림¶

모니터가 트리거될 때 생성되는 이벤트 제목, 내용, 알림 대상 및 연결 처리 등을 정의합니다.

이벤트 제목¶

알림 트리거 조건의 이벤트 이름을 정의합니다. 사전 정의된 템플릿 변수를 사용할 수 있습니다.

이벤트 내용¶

이벤트 알림 내용을 작성합니다. 트리거 조건이 충족되면 시스템이 이 부분의 내용을 외부로 전송합니다. 일반적으로 다음 정보를 포함합니다:

• Markdown 형식의 본문
• 관련 링크 및 템플릿 변수 삽입 가능
• 고급 구성을 기반으로 관련 로그 또는 오류 정보 추가
• 이벤트 내용을 전송할 대상 알림 멤버

관련 링크¶

+ 링크를 클릭하면 시스템이 현재 감지 메트릭을 기반으로 자동으로 이동 링크를 생성합니다. 링크 주소는 현재 도메인, 워크스페이스 ID, 감지 시간 범위({{df_check_range_start}} ~ {{df_check_range_end}}) 및 동적 필터 조건을 포함합니다.

링크 형식 예시:

로그 탐색기: [관련 로그 보기](<{{STUDIO_CONSOLE_BASE_URL}}/logIndi/log/all?time={{df_check_range_start}},{{df_check_range_end}}&w={{df_workspace_uuid}}>)

트레이스 탐색기: [관련 트레이스 보기](<{{STUDIO_CONSOLE_BASE_URL}}/tracing/link/all?time={{df_check_range_start}},{{df_check_range_end}}&w={{df_workspace_uuid}}>)

템플릿 변수¶

+ 변수를 클릭하여 사전 정의된 템플릿 변수를 삽입합니다. 변수는 이벤트 트리거 시 실제 값으로 동적으로 대체됩니다:

지원되는 전체 템플릿 변수를 보려면 클릭하십시오.

고급 구성¶

"고급 구성"을 통해 DQL을 사용하여 이벤트에 관련 데이터 컨텍스트를 포함시킬 수 있습니다.

1. 관련 로그 추가

클릭 시 자동으로 템플릿이 생성됩니다:

{% set dql_data = DQL("L::RE(`.*`):(`message`) { `index` = 'default' } LIMIT 1") %}
{{ dql_data.message | limit_lines(10) }}

구성 포인트:

• {index= 'default' }를 실제 인덱스 이름으로 변경해야 합니다.

• RE(``.*``)는 정규식 매칭을 지원합니다(예: RE(``error\|exception``)).

• limit_lines(10)는 출력 줄 수를 제한하여 알림이 너무 길어지는 것을 방지합니다.

2. 관련 오류 스택 추가

클릭 시 자동으로 템플릿이 생성됩니다:

{% set dql_data = DQL("T::re(`.*`):(`error_message`,`error_stack`){ (`source` NOT IN ['service_map', 'tracing_stat', 'service_list_1m', 'service_list_1d', 'service_list_1h', 'profile']) AND (`error_stack` = exists()) } LIMIT 1") %}
{{ dql_data.error_message | limit_lines(10) }}
{{ dql_data.error_stack | limit_lines(10) }}

구성 포인트:

• source NOT IN [...]는 통계 집계 데이터를 제외하고 원본 트레이스만 유지합니다.

• (error_stack= exists())는 스택 정보가 포함된 오류가 반환되도록 보장합니다.

알림 멤버 (@)¶

워크스페이스 멤버를 선택합니다.

적용 로직:

1. 연결된 인시던트가 활성화된 경우에만 @ 멤버 구성이 적용되어 지정된 멤버에게 이벤트 내용을 전송합니다.
2. 이 구성은 알림 구성의 알림 대상과는 독립적이며, 알림 전송 범위에 영향을 주지 않습니다.

사용자 지정 알림 내용¶

기본적으로 시스템은 이벤트 내용을 알림 내용으로 사용합니다. 실제로 외부에 전송되는 알림을 사용자 지정하려면 여기에서 스위치를 활성화하고 알림 정보를 입력할 수 있습니다.

• 독립 편집기가 펼쳐지며, 외부로 전송할 알림 내용을 별도로 정의할 수 있습니다.
• 원래 이벤트 내용은 플랫폼 내에 이벤트 상세 정보 표시용으로 그대로 유지됩니다.
• 독립 편집기에서도 Markdown, 템플릿 변수, 관련 링크 및 고급 구성을 지원합니다.

데이터 누락 이벤트¶

데이터 누락(데이터 미보고) 시 알림 내용을 사용자 정의합니다. 이 유형의 이벤트가 최종적으로 외부로 전송될 때의 제목, 내용 등의 정보를 동시에 구성할 수 있습니다.

사용자 정의 구성을 하지 않으면 시스템은 공식 기본 템플릿을 사용하여 데이터 누락 알림을 전송합니다.

인시던트 연결¶

연결을 활성화하면 해당 모니터에서 이상 이벤트가 발생할 경우 인시던트가 함께 생성됩니다.

설정 항목¶

1. 자동 생성된 인시던트에 태그를 추가하여 인시던트 센터에서 분류 및 필터링할 수 있도록 합니다.

2. 이벤트 등급과 인시던트 등급의 매핑 관계를 구성합니다. 여러 규칙을 추가할 수 있습니다.

   • 치명적/심각/중요/경고/데이터 누락 등급 이벤트가 발생하면 동시에 새 인시던트 등급 P0/P1/P2/P3/... 가 생성됩니다.

여기서 생성된 인시던트는 인시던트 센터에서 확인할 수 있습니다(❗️이러한 인시던트는 태그 필터 조건을 포함합니다).

연동 메커니즘¶

1. 이벤트가 트리거되면 자동으로 인시던트 센터에 인시던트 기록이 생성되며, 인시던트 설명은 이벤트 내용을 자동으로 동기화합니다.
2. 이벤트 내용의 @ 멤버 목록을 기반으로 인시던트 추가 알림을 전송합니다.
3. 인시던트 센터에서 인시던트 상세 정보를 확인할 수 있으며, 시스템은 해당 인시던트와 관련된 전체 데이터(성능 메트릭, 오류 로그, 호출 트레이스, 인프라 토폴로지 등)를 자동으로 연결하여 표시합니다.

알림 구성¶

모니터링 조건이 충족되면 즉시 지정된 알림 대상에게 알림 메시지를 전송합니다.

알림 정책¶

생성된 알림 정책을 선택합니다. 여러 개를 선택할 수 있습니다. 정책 이름을 클릭하면 상세 정보를 펼쳐서 볼 수 있고, 알림 정책 편집을 클릭하면 구성을 수정할 수 있습니다:

연결¶

생성된 대시보드를 선택하여 모니터와 대시보드 간의 연결을 설정합니다. 이를 통해 빠르게 이동하고 모니터링 데이터를 시각적으로 볼 수 있습니다.

권한¶

모니터의 작업 권한을 설정하여 각 사용자가 자신의 역할 및 권한 수준에 따라 적절한 작업을 수행할 수 있도록 합니다. 현재 워크스페이스의 Owner는 이곳의 작업 권한 구성에 영향을 받지 않습니다.

• 이 구성을 활성화하지 않음: "모니터 구성 관리"의 기본 권한을 따릅니다.
• 이 구성을 활성화하고 사용자 정의 권한 대상을 선택: 생성자와 권한이 부여된 대상만 해당 모니터에 설정된 규칙에 대해 활성화/비활성화, 편집, 삭제 작업을 수행할 수 있습니다.
• 이 구성을 활성화했지만 사용자 정의 권한 대상을 선택하지 않음: 생성자만 이 모니터에 대한 활성화/비활성화, 편집, 삭제 권한을 가집니다.

또한, 워크스페이스 Owner는 통합 권한 관리 구성을 통해 관리자, 역할 또는 멤버에게 모니터 작업 권한을 통합적으로 부여할 수 있습니다. 권한이 부여된 대상은 사용자 정의 작업 권한이 활성화된 모든 모니터를 작업할 수 있으며, 각 모니터의 사용자 정의 권한 대상에 개별적으로 추가될 필요가 없습니다.

즉시 감지 트리거¶

규칙 구성이 완료되면 즉시 감지 트리거를 클릭하여 수동으로 한 번 테스트를 실행하고, 현재 규칙 구성의 전반적인 효과를 확인할 수 있습니다. 테스트 실행은 실제 알림을 생성하지 않습니다.

알림 캐시 보호 메커니즘¶

구성이 완료되면 모니터는 실행 중에 다음 보호 전략을 수행합니다. 시스템은 다음 메커니즘을 통해 고차원 집계로 인한 과도한 감지 대상으로 인한 시스템 부하를 방지합니다:

알림 캐시 상한은 100,000개이며, 경고 비율은 80%입니다.

일시 중지 복구 메커니즘¶

알림 캐시 초과로 인해 모니터가 시스템에 의해 일시 중지된 경우, 다음 작업 중 하나를 수행하면 자동으로 복구됩니다:

• 쿼리 조건을 수정하고 모니터를 다시 저장합니다.

• 모니터를 직접 다시 저장합니다.

시스템은 자동으로 알림 캐시 표시를 정리하고 모니터를 정상 실행 상태로 복구합니다. 추가 작업이 필요하지 않습니다.

더 읽을거리¶

모니터 규칙 생성이 성공적으로 완료되면 다음이 필요할 수 있습니다: