콘텐츠로 이동

이벤트 센터


이벤트 센터는 Guance의 통합 이벤트 조회 및 분석 플랫폼으로, 모니터, 통합 수집기, 지능형 모니터링, AI 모니터, SLO, 보안 모니터링, 감사, OpenAPI 등 여러 소스의 이벤트 데이터를 모아 다차원 필터링, 상세 조회, 연관 분석 기능을 제공합니다.

이벤트 센터는 이벤트 집계 및 조회만 수행하며, 이벤트를 생성하거나 규칙을 구성하거나 알림을 전송하지 않습니다. 이벤트는 각 소스 모듈에서 독립적으로 생성된 후 자동으로 이곳에 집계됩니다.

이벤트 소스

소스 생성 방식 df_source 값
모니터 모니터링 모듈에서 감지 규칙을 구성하고 조건 충족 시 트리거 monitor
지능형 모니터링 내장 규칙 또는 AI가 생성하여 저장한 고정 규칙에 따라 이상을 감지 smartMonitor
AI 모니터 AI가 실행할 때마다 자연어 Prompt에 따라 관측 데이터를 분석하고, 증거로 뒷받침되는 문제를 발견하면 이벤트 보고서를 생성 aiMonitor
변경 이벤트 Kubernetes 클러스터에서 예상 패턴과 다른 실행 활동 이벤트를 기록 change
SLO SLO 모듈에서 서비스 품질 목표를 구성하고 위반 시 트리거 slo
보안 모니터링 보안 모듈에서 감지한 이상 행위 또는 취약점 경고 security
감사 이벤트 사용자가 Guance 플랫폼에서 수행한 작업 기록 audit
사용자 지정 이벤트 OpenAPI를 통해 직접 기록 user
통합 수집 이벤트 클라우드 수집기 실행 중 발생한 이상 및 복구 이벤트 monitor (df_monitor_type=integration_collection)

이벤트 내용 구성

이벤트 내용은 소스 시스템이 생성 시점에 결정하며, 이벤트 센터는 표시만 수행합니다.

규칙 모니터 이벤트

모니터 이벤트 내용은 규칙 생성 > 이벤트 알림에서 구성한 템플릿을 기반으로 하며, 변수를 통해 동적으로 채울 수 있습니다:

변수(예시) 설명 예시
{{Result}} 감지 결과 값 85.5
{{df_dimension_tags}} 이벤트 차원 {"host":"web01"}
{{df_monitor_checker_name}} 모니터 이름 호스트 CPU 모니터링

시스템은 실제 모니터링 데이터에 따라 변수를 치환한 후 최종 이벤트 내용을 생성합니다.

아래 그림과 같이 이벤트 제목을 日志检测-多索引로 정의하고 이벤트 내용에 DQL 쿼리 문과 변수가 포함되면, 시스템은 실제 모니터링 데이터에 따라 최종 결과를 생성하여 표시합니다.

규칙이 이상을 감지하면 이벤트 > 이벤트 상세에서 관련 이벤트 내용을 확인할 수 있습니다.

지능형 모니터링 이벤트 분석 보고서

지능형 모니터링은 저장된 고정 규칙에 따라 감지를 실행합니다. 규칙이 트리거 조건을 충족하면 시스템은 지능형 모니터링 이벤트를 생성하고 이벤트 상세에서 분석 보고서를 제공합니다.

동일한 감지에서 여러 규칙이 동시에 트리거될 수 있습니다. 시스템은 이번 감지에서 매칭된 규칙을 동일한 분석 보고서에 집계하고, 감지 차원별로 이상 요약, 규칙 세부 정보, 모니터링 신호, 현재 값, 판정 근거, 이상 원인 및 추세 등의 정보를 표시합니다. 지능형 모니터링 이벤트의 df_source는 smartMonitor이며, df_source:smartMonitor로 필터링하여 조회할 수 있습니다.

AI 모니터 이벤트 보고서

AI 모니터는 Prompt를 지속적으로 적용되는 감지 규칙으로 사용하며, 실행할 때마다 관련 관측 데이터를 조회하고 분석합니다. 설명에 부합하고 데이터 증거로 뒷받침되는 문제를 발견하면 시스템은 구조화된 이벤트 보고서를 생성하고 이벤트 센터에 이벤트 레코드 형태로 표시합니다.

이벤트 보고서는 문제 요약, 판단 신뢰도 및 지원 증거를 제공하고 영향 범위, 진단 및 권장 작업 등의 정보를 보완하여 사용자가 문제를 이해하고 영향을 확인하며 후속 조치를 수행하도록 돕습니다.

AI 모니터 이벤트 보고서의 df_source는 aiMonitor입니다. 이벤트 센터 > 모든 이벤트로 이동하여 df_source:aiMonitor로 필터링해 조회할 수 있습니다.

통합 수집 이벤트

클라우드 수집기의 연관 이벤트는 수집 이상 및 복구 상황을 확인하는 데 사용되며, 데이터 수집 문제를 찾는 데 도움을 줍니다. 서로 다른 이상은 각각의 복구 상황을 표시하며, 과거 이상 이벤트는 다시 조회할 수 있도록 보존됩니다.

이벤트 센터 > 모든 이벤트로 이동하여 시간 범위를 선택한 후 검색창에 df_source:monitor AND df_monitor_type:integration_collection을 입력합니다. 클라우드 공급자, 통합 제품, 클라우드 계정 및 이벤트 상태를 기준으로 범위를 계속 좁힐 수 있습니다. 자세한 단계와 필드 예시는 이벤트 센터에서 통합 수집 이벤트 조회를 참조하세요.

이벤트 필드 참조

공통 필드

최종 이벤트 레코드에는 일반적으로 다음 필드가 포함됩니다:

필드
설명
date / timestamp 생성 시간. 단위: 초
df_date_range 시간 범위. 단위: 초
df_check_range_start 감지 범위 시작 시간. 단위: 초
df_check_range_end 감지 범위 종료 시간. 단위: 초
df_issue_start_time 이번 장애가 처음 발생한 시간. 단위: 초
df_issue_duration 이번 장애의 지속 시간(초) (df_issue_start_time부터 본 이벤트까지)
df_source 이벤트 소스. 일반적인 값은 이벤트 소스 참조
df_status 이벤트 상태. ok, info, fatal, warning, error, critical, nodata, nodata_ok, nodata_as_ok, manual_ok 포함. 모니터 이벤트 등급과 상태의 대응 관계는 이벤트 등급 참조
df_sub_status 이벤트 세부 상태(df_status의 보충)
df_event_id 이벤트 고유 ID
df_title 제목
df_message 설명

모니터 이벤트 특유 필드

규칙 모니터 이벤트의 df_source = monitor이며, 아래는 규칙 모니터의 필드 참조입니다. 통합 수집 이벤트도 동일한 df_source를 사용하며 df_monitor_type = integration_collection으로 구분합니다. 조회 설명은 통합 연관 이벤트를 참조하세요.

필드
설명
df_dimension_tags 감지 차원 태그(예: {"host":"web01"})
df_monitor_id 알림 정책 ID
df_monitor_name 알림 정책 이름
df_monitor_type 소속 유형: 사용자 지정 모니터 이벤트는 custom, SLO 이벤트는 slo, 지능형 점검 이벤트는 bot_obs로 고정
df_monitor_checker 실행 함수 이름(예: custom_metric 등)
df_monitor_checker_sub 감지 단계: 데이터 결측 감지 단계에서 생성된 경우 nodata, 정상 감지 단계에서 생성된 경우 check
df_monitor_checker_id 모니터 ID
df_monitor_checker_name 모니터 이름
df_monitor_checker_value 이벤트 생성 시의 이상 값
df_monitor_checker_value_dumps 이벤트 생성 시의 이상 값(JSON 직렬화)
사용자가 역직렬화하여 원래 값을 얻을 수 있도록 편의 제공
df_monitor_checker_value_with_unit 이벤트 생성 시의 이상 값(최적 단위)
df_monitor_checker_ref 모니터 연관, 감지 구성의 DQL 문과만 연관된 필드
df_monitor_checker_event_ref 모니터 이벤트 연관, df_dimension_tags 및 df_monitor_checker_id와만 연관된 필드
df_monitor_ref_key 자체 점검의 연관 Key로, 자체 점검과 대응시키는 데 사용
df_fault_id 이번 장애 ID, 최초 장애 이벤트의 df_event_id 값
df_fault_status 이번 장애 상태. df_status, df_sub_status의 중복 필드로 OK 여부를 표시하며 값은 다음과 같습니다:
ok: 정상
fault: 장애
df_fault_start_time 이번 장애 시작 시간.
df_fault_duration 이번 장애의 지속 시간(초) (df_issue_start_time부터 본 이벤트까지)
df_event_detail 이벤트 감지 상세
df_user_id 수동 복구 시 작업자 사용자 ID
df_user_name 수동 복구 시 작업자 사용자 이름
df_user_email 수동 복구 시 작업자 사용자 이메일
df_crontab_exec_mode 실행 모드, 선택 가능 값.
  • 자동 트리거(예약 실행) crontab
  • 비동기 호출(수동 실행) manual
  • df_site_name 현재 Guance 사이트 이름
    df_workspace_name 소속 워크스페이스 이름
    df_workspace_uuid 소속 워크스페이스 UUID
    df_label 모니터 태그. 모니터에서 지정한 태그는 이 필드 UUID에 저장됩니다
    df_alert_policy_ids 알림 정책 ID(목록)
    df_alert_policy_names 알림 정책 이름(목록)
    df_matched_alert_policy_rules 알림 정책 이름 및 일치하는 모든 규칙 이름(목록)
    df_channels 이벤트가 속한 인시던트 채널 목록
    df_at_accounts @계정 정보
    df_at_accounts_nodata @계정 정보(데이터 결측)
    df_message_at_accounts 장애 알림 메시지의 @사용자 상세 정보 목록
    df_nodata_message_at_accounts 데이터 결측 알림 메시지의 @사용자 상세 정보 목록
    df_workspace_declaration 워크스페이스의 속성 클레임
    df_matched_alert_members 구성원별 전송을 선택한 경우 일치하는 모든 알림 대상 구성원 정보 목록
    df_matched_alert_upgrade_members 구성원별 전송을 선택한 경우 일치하는 모든 알림 에스컬레이션 대상 구성원 정보 목록
    df_matched_alert_member_groups 구성원별 전송을 선택한 경우 일치하는 모든 구성원 그룹 이름
    df_charts 모니터 구성에 차트를 추가한 후 본 알림 이벤트에서 메시지를 전송해야 할 때 추가되는 차트 정보
    df_alert_info 알림 정보 기록
    df_is_silent 이벤트 음소거 여부. 문자열 "true" / "false" 값을 가집니다
    df_sent_target_types 본 이벤트에서 이미 전송된 중복 없는 알림 대상 유형 목록
    df_check_targets 모니터 구성의 감지 시간, 감지 지표 기록
    df_check_condition, df_check_condition_expr 모니터 구성의 트리거 규칙 기록
    df_check_rules 모니터 구성의 감지 횟수, 감지 규칙 기록
    df_check_targets 모니터 구성의 감지 시간, 감지 지표 기록
    df_check_condition 모니터 구성의 트리거 규칙 기록
    df_check_interval 모니터 구성의 감지 빈도 기록
    df_fault_end_time 장애 복구 시간 기록

    지능형 모니터링 이벤트 특유 필드

    df_source = smartMonitor일 때 df_event_report에는 지능형 모니터링 분석 보고서 데이터가 기록됩니다. 동일한 감지에서 매칭된 여러 규칙은 해당 분석 보고서에 집계됩니다.

    AI 모니터 이벤트 특유 필드

    df_source = aiMonitor일 때 다음 필드를 통해 이벤트 소스를 식별하고 AI 분석의 근거가 된 데이터를 확인할 수 있습니다:

    필드
    설명
    df_monitor_type / df_monitor_checker_type ai로 고정되며, 해당 이벤트가 AI 모니터에서 생성되었음을 나타냅니다.
    df_monitor_checker_id / df_monitor_checker_name 이벤트를 생성한 AI 모니터 ID와 이름.
    df_message AI가 생성한 구조화된 이벤트 보고서.
    df_check_targets 이번 감지에 사용된 데이터 객체 및 쿼리 정보로, 분석 증거를 연관시키는 데 사용됩니다.

    감사 이벤트 특유 필드

    df_source = audit일 때 다음 필드가 추가로 존재합니다:

    필드 설명
    df_user_id 작업자 사용자 ID
    df_user_name 작업자 사용자 이름
    df_user_email 작업자 사용자 이메일
    {기타 필드} 구체적인 감사 데이터 요구 사항에 따른 기타 필드

    사용자 지정 이벤트 특유 필드

    df_source = user일 때 다음 필드가 추가로 존재합니다:

    필드 설명
    df_user_id 생성자 사용자 ID
    df_user_name 생성자 사용자 이름
    df_user_email 생성자 사용자 이메일
    {기타 필드} 사용자 작업에 따라 이벤트를 생성할 때 추가되는 기타 필드

    이벤트 조회 및 확인

    이벤트 센터는 여러 탐색기를 제공하여 다양한 시나리오의 이벤트 조회 및 분석 요구를 충족합니다.

    이벤트 조회 차원 설명 핵심 기능
    모든 이벤트 전체 이벤트 조회 현재 워크스페이스 내 모든 소스의 이벤트 데이터를 집계하여 표시하며, 목록/차트 두 가지 표시 모드를 지원하고 다차원 필터링, 검색, 내보내기, 스냅샷 저장 등의 기능을 제공
    미복구 이벤트 활성 장애 추적 최근 48시간 내 df_status != ok인 이벤트를 집중 표시하고 df_fault_id를 기준으로 장애 지속 시간을 집계하여 표시
    변경 이벤트 K8s 변경 감사 Kubernetes 클러스터에서 예상 패턴과 다른 실행 활동 이벤트를 기록하고 변경 전후 구성 차이를 표시
    지능형 모니터링 이벤트 지능형 이상 조회 지능형 모니터링 규칙에서 감지한 이상 이벤트와 단일 감지에서 여러 매칭 규칙이 병합되어 생성된 분석 보고서를 확인
    이벤트 상세 단일 이벤트 심층 분석 임의의 이벤트를 클릭해 진입하면 기본 속성, 확장 필드, 알림, 이력 기록, 연관 이벤트, 연관 SLO 등 전체 정보를 확인

    추가 읽기

    ‘이벤트’라는 기본 개념을 이해한 후 다음과 같은 내용이 필요할 수 있습니다:

    문서 평가

    이 페이지가 도움이 되었나요?