자주 묻는 질문¶

이벤트 조회 및 시간 범위¶

“미복구 이벤트”는 기본적으로 최근 48시간만 표시됩니다. 더 이전의 미복구 이벤트를 확인하려면 어떻게 해야 하나요?

페이지 오른쪽 상단의 시간 위젯에서 시간 범위를 자유롭게 조정할 수 있습니다.

“모든 이벤트”와 “미복구 이벤트” 탭의 차이점은 무엇인가요? 두 탭 모두 미복구 이벤트를 필터링할 수 있는 이유는 무엇인가요?

비교 항목	미복구 이벤트	모든 이벤트
기본 시간 범위	최근 48시간	일반적으로 더 길음(구성 가능)
기본 필터 조건	`df_status != ok`	없음
표시 내용	비정상 상태 이벤트만	전체 상태(정상/비정상/복구/데이터 단절)
용도	현재 문제를 빠르게 확인	전체 이력 조회 및 분석

핵심 차이점: “미복구 이벤트”는 바로가기로 자동으로 필터가 적용되며, “모든 이벤트”는 필터 조건을 직접 추가해야 하지만 유연성이 더 높습니다.

시간 위젯을 조정하면 기존에 설정한 필터 조건이 초기화되나요?

초기화되지 않습니다. 시간 범위 조정은 독립적으로 적용되며, 설정한 필터 조건(이벤트 등급, 알림 정책, 모니터 이름 등)은 유지됩니다. 시스템은 새 시간 범위 안에서 해당 필터 조건을 적용합니다.

이벤트 내용 및 변수¶

이벤트 내용의 변수(예: {{df_dimension_tags}}, {{Result}})가 비어 있거나 형식이 올바르지 않게 표시됩니다. 어떻게 디버깅하나요?

변수 출처: 이벤트 내용의 변수는 모니터의 이벤트 알림 구성 영역에서 정의되며, 시스템이 실제 모니터링 데이터를 기반으로 치환합니다.

일반적인 빈 값 원인:

DQL 쿼리가 해당 필드를 반환하지 않음
변수 이름 오타(대소문자 구분)
탐지 차원 태그가 비어 있음

디버깅 방법:

이벤트 상세의 탐지 메트릭 영역을 확인하여 원본 쿼리 결과를 확인합니다.
모니터의 DQL 쿼리문이 올바른지 확인합니다.

자주 사용하는 변수 참고:

{{Result}} - 탐지 값
{{df_dimension_tags}} - 탐지 차원 태그 JSON
{{df_status}} - 이벤트 상태
{{df_monitor_name}} - 모니터 이름
{{date}} - 이벤트 생성 타임스탬프

이벤트 제목과 이벤트 내용의 차이점은 무엇인가요? 알림 시 어떤 것이 전송되나요?

이벤트 제목: 이벤트 목록에 표시되며 알림의 제목(이메일 제목, DingTalk 메시지 제목 등)이기도 합니다.
이벤트 내용: 이벤트 상세 페이지에 표시되는 내용이며, 기본 알림 본문이기도 합니다.

사용자 지정 알림 내용:

모니터는 “사용자 지정 알림 내용” 스위치를 지원합니다. 이 경우:

이벤트 내용은 이벤트 상세에 계속 저장됩니다.
그러나 알림은 사용자 지정 템플릿으로 전송됩니다.
알림 채널별로 콘텐츠를 맞춤 설정해야 하는 상황에 적합합니다.

이벤트 내용에서 지원하는 템플릿 함수는 무엇인가요? 숫자를 백분율로 형식화할 수 있나요?

현재 명시적으로 지원되는 템플릿 함수는 다음과 같습니다.

함수	기능	예시
`to_datetime`	타임스탬프를 날짜로 변환	`{{ date \\| to_datetime }}`
`to_status_human`	상태를 읽을 수 있는 텍스트로 변환	`{{ df_status \\| to_status_human }}`
`to_fixed(n)`	소수 자릿수를 고정	`{{ Result \\| to_fixed(2) }}`
`to_percent`	백분율로 변환	`{{ Result \\| to_percent }}`
`to_pretty_tags`	태그 출력을 보기 좋게 변환	`{{ df_dimension_tags \\| to_pretty_tags }}`

이벤트 상태 및 복구¶

이벤트 복구는 자동인가요, 수동인가요? 일부 이벤트가 계속 미복구로 표시되는 이유는 무엇인가요?

자동 복구: 모니터가 메트릭이 정상으로 복구되었음을 감지하면 자동으로 복구 이벤트가 생성되고 df_status가 ok로 변경됩니다.

수동 복구: 이벤트 목록 또는 상세 페이지에서 이벤트를 수동으로 복구할 수 있습니다.

일반적인 미복구 원인:

모니터 구성 문제: 복구 조건이 올바르게 구성되지 않음
데이터 단절 이벤트: 복구 정책이 구성되지 않았거나 데이터가 다시 보고되지 않음
탐지 로직 문제: 임계값 설정으로 인해 자동 복구 판정이 불가능함

모니터 음소거 기간에 생성된 이벤트가 이벤트 목록에 표시되나요? 상태는 어떻게 되나요?

이벤트 목록에는 표시되지만:

알림이 전송되지 않습니다.
인시던트가 동기 생성되지 않습니다.(동기 생성을 구성한 경우)
이벤트 상태는 정상적으로 기록됩니다(critical/warning 등).

음소거는 알림 전송만 일시 중지하며 이벤트 자체의 생성 및 기록에는 영향을 미치지 않습니다.

데이터 단절 이벤트¶

데이터 단절 이벤트란 무엇인가요? 어떤 상황에서 활성화해야 하나요?

데이터 단절은 모니터가 탐지 주기 내에 예상한 데이터를 조회하지 못한 것을 의미합니다.

구성 위치: 모니터의 “데이터 단절 이벤트” 구성 영역(일부 모니터 유형에서 지원)

세 가지 처리 정책:

이벤트 미발생 - 음소거 처리
복구 이벤트 발생 - 데이터 단절을 비정상 복구로 간주
데이터 단절 이벤트 발생 - 전용 단절 알림 생성(등급 구성 가능)

데이터가 분명히 보고되지 않았는데도 데이터 단절 이벤트가 발생하지 않는 이유는 무엇인가요?

Guance는 데이터 단절을 판단할 때 “에지 트리거” 메커니즘을 사용합니다.

이전 조회에서 X가 확인되었는데 이번 조회에서 X가 조회되지 않으면 X에 데이터 단절이 발생한 것으로 판단합니다.

주요 제한 사항:

최초 탐지 시 데이터가 없으면 알림이 생성되지 않습니다.(시스템은 “원래 있어야 하는” 것이 무엇인지 알 수 없음)
“데이터 있음” 상태를 거친 후 다시 탐지되지 않아야 단절로 판정합니다.

점검 권장 사항:

모니터가 최소 하나의 탐지 주기 동안 정상적으로 실행되어 데이터를 조회했는지 확인합니다.
“탐지 범위 드리프트” 메커니즘을 확인합니다(실제 탐지 시간 범위는 1분 정도 드리프트됨).
모니터 실행 로그를 확인하여 DQL 쿼리가 성공했는지 확인합니다.

데이터 단절 이벤트와 데이터 복구 이벤트의 생성 로직은 무엇인가요?

교번 생성 메커니즘:

데이터 단절 이벤트와 데이터 복구 이벤트는 항상 교대로 발생합니다.
연속적인 데이터 단절 이벤트는 생성되지 않습니다.
연속적인 데이터 복구 이벤트도 생성되지 않습니다.

판정 흐름:

최초 탐지 시 데이터 없음 → 알림 없음
↓
데이터 탐지 → “데이터 있음” 상태 기록
↓
다시 데이터 없음 → 데이터 단절 이벤트 발생
↓
데이터 다시 보고됨 → 데이터 복구 이벤트 발생
↓
다시 데이터 없음 → 데이터 단절 이벤트 발생(새 이벤트)

이벤트 연관 및 문제 해결¶

이벤트 상세 페이지의 “연관 이벤트”는 어떻게 연결되나요? 왜 때로는 비어 있나요?

연관 로직:

동일한 탐지 차원 태그를 기준으로 연결(예: host, service 등)
시간 창을 기준으로 연결(같은 시간대의 관련 이벤트)

연관이 비어 있는 일반적인 원인:

해당 차원 태그가 다른 이벤트에 존재하지 않음
시간 창 내에 다른 관련 이벤트가 없음
현재 이벤트 유형이 연관을 지원하지 않음(일부 모니터 유형)

“연관 SLO”가 0으로 표시되는 것은 무엇을 의미하나요? 언제 데이터가 표시되나요?

0으로 표시: 이벤트가 어떤 SLO 작업에도 연결되어 있지 않음을 의미합니다.
데이터가 표시되는 경우: 이벤트가 SLO 작업에 의해 트리거된 경우에만 연결된 SLO 정보가 표시됩니다.
모니터가 트리거한 이벤트는 기본적으로 SLO와 연결되지 않습니다.

과거 추세 차트의 “탐지 구간” 점선은 무엇을 의미하나요? 시간 범위를 조정할 수 있나요?

탐지 구간 점선: 해당 알림을 트리거한 구체적인 탐지 시간 창을 표시합니다.
차트 표시: 해당 탐지 메트릭의 더 긴 시간 범위에서의 추세를 표시합니다.

차트 오른쪽 상단의 “차트 쿼리 가져오기” 버튼을 클릭하면 메트릭 또는 로그 탐색기로 이동하며, 탐색기에서 시간 범위를 유연하게 조정하여 더 장기적인 추세 분석을 수행할 수 있습니다.

이벤트 소스 및 필드¶

소스가 다른 이벤트(모니터, AI 모니터, 감사, OpenAPI)는 필드에 어떤 차이가 있나요?

df_source 값에 따라 다른 추가 필드가 대응합니다.

df_source	소스	추가 필드
`monitor`	모니터	모니터 관련 필드(탐지 메트릭, 임계값 등)
`smartMonitor`	지능형 모니터링	지능형 모니터링 보고서, 탐지 메트릭 등
`aiMonitor`	AI 모니터	AI가 생성한 구조화된 이벤트 보고서, 모니터 정보 및 탐지에 사용된 데이터
`slo`	SLO	SLO 및 서비스 품질 목표 관련 정보
`audit`	감사 이벤트	작업자, 작업 유형, 변경 세부 정보 등
`user`	OpenAPI 작성	사용자 지정 필드

OpenAPI로 작성한 사용자 지정 이벤트와 시스템에서 생성한 이벤트는 사용상 어떤 차이가 있나요?

기능 차이:

사용자 지정 이벤트는 df_status, df_title, df_message 등의 필드를 설정할 수 있습니다.
연관에 사용할 df_dimension_tags를 지정할 수 있습니다.
모니터 이벤트처럼 대시보드에 자동으로 연결되지 않습니다.
이벤트 복구 로직을 직접 처리해야 합니다(API를 통해 복구 인터페이스 호출).

사용 사례: 외부 시스템 연동, 사용자 지정 비즈니스 알림, 과거 이벤트 대량 가져오기 등.

감사 이벤트¶

감사 이벤트는 구체적으로 어떤 작업을 기록하나요? 어디에서 확인할 수 있나요?

확인 위치: 관리 > 기본 설정 > 보안 > 작업 감사

일반적인 기록 범위:

데이터 권한 추가/삭제(워크스페이스 간 권한 부여)
모니터, SLO, 알림 정책 등 구성의 생성/삭제/수정
워크스페이스 멤버 권한 변경

필드 특징: df_source = audit이며, 작업자, 작업 시간, 작업 유형 등의 감사 전용 필드를 포함합니다.

일반적인 문제 해결¶

이벤트 상세에 표시된 시간과 실제 인시던트 발생 시간이 일치하지 않는 이유는 무엇인가요?

이는 정상적인 현상이며, 이유는 두 가지입니다.

예약 트리거 시간과 실제 실행 시간의 차이:
- 이벤트에 표시된 시간은 모니터의 예약 트리거 시간(Crontab 기반의 규칙적인 시간)입니다.
- 이벤트가 시스템에서 실제로 생성된 시간이 아닙니다.
탐지 범위 드리프트:
- 실제 탐지 데이터 범위는 예약 트리거 시간 - 탐지 범위 - 1분부터 예약 트리거 시간 - 1분까지입니다.
- 따라서 인시던트 데이터의 타임스탬프가 이벤트 표시 시간보다 이전일 수 있습니다.

점검 권장 사항: 이벤트 상세의 “탐지 메트릭” 영역을 확인하여 실제 탐지된 데이터의 시간 범위를 확인합니다.

플랫폼에서 직접 조회하면 인시던트 데이터가 보이는데 모니터가 이벤트를 생성하지 않은 이유는 무엇인가요?

일반적인 원인:

데이터 저장 지연: 탐지 실행 시점에 인시던트 데이터가 아직 조회되지 않습니다(모니터는 자동으로 1분 드리프트하여 회피하지만 지연이 1분을 초과하면 효과가 없습니다).
DQL 쿼리 실패: 탐지 과정이 쿼리 실패로 중단됩니다.
모니터 음소거: 음소거 기간에는 알림이 전송되지 않지만 이벤트는 계속 생성됩니다(이벤트 목록을 확인해야 합니다).
임계값 설정: 실제 탐지 값이 트리거 임계값에 도달하지 못했습니다.

이벤트 데이터는 얼마나 오래 보존되나요? 내보내기 또는 보관은 어떻게 하나요?

장기 보존 방안:

Dataway Sink 기능을 사용하여 이벤트 데이터를 외부 스토리지로 분산합니다.
OpenAPI를 통해 이벤트 데이터를 주기적으로 로컬 스토리지로 가져옵니다.
데이터 전송 기능을 사용하여 Kafka, S3 등 외부 시스템으로 전송합니다.