알람

알람 내역

알람 내역 조회

현재까지 발생한 알람 내역을 확인할 수 있습니다.

  1. 메인 메뉴에서 [모니터링] > [알람 내역] 메뉴를 선택합니다.

  2. 알람 내역 화면이 열리면 발생한 알람 목록이 표시됩니다.

    figure alarm basic

    • ① 알람 조회 기간

      알람을 조회할 기간입니다. 기본적으로 실시간 모니터링이 동작하며, 수동으로 기간을 설정할 수도 있습니다.

      설정 방법에 대한 자세한 설명은 "모니터링 기간 설정"을 참고합니다.

    • ② 상세 검색

      알람 상세 검색 영역입니다. 검색 조건을 설정해서 원하는 알람만 검색이 가능합니다.

      조건 설명

      검색 범위

      알람이 발생한 영역입니다.

      • All

      • Business

      • Instance

      • Service

      검색 키워드

      알람 메시지 내용을 기준으로 검색할 키워드입니다.

      태그

      알람 검색을 위해 모니터링 백엔드에 미리 설정된 태그입니다.

      입력란에 '키=값' 형식으로 입력한 후 <Enter> 키를 누르면 검색할 태그가 추가됩니다. 이때 태그는 여러 개 추가할 수 있습니다.

      [참고] 모니터링 백엔드 서버에서 'application.yaml' 파일의 'searchableAlarmTags' 파라미터에 설정된 태그만 검색할 수 있습니다.

      페이지당 행

      한 페이지에 보여줄 알람 목록의 개수입니다.

    • ③ 알람 목록

      가장 최근에 발생한 순서대로 알람 목록이 표시됩니다.

알람 상세 정보 조회

알람 정보를 상세하게 확인할 수 있습니다.

  1. 메인 메뉴에서 [모니터링] > [알람 내역] 메뉴를 선택합니다.

  2. 알람 내역 화면이 열리면 알람 목록에서 상세 정보를 확인할 알람을 클릭합니다.

  3. 화면 오른쪽에 해당 알람의 상세 정보가 표시됩니다.

    figure alarm detail
    항목 설명

    Level

    알람의 심각도 수준입니다.

    Scope

    알람이 발생한 영역입니다.

    Scope Name

    알람이 발생한 대상의 이름입니다.

    Start Time

    알람이 발생한 시간입니다.

    Tags

    알람에 설정된 '키-값' 형태의 태그입니다.

    Message

    알람의 상세 메시지 내용입니다.

    Event

    Out Of Memory(OOM) 또는 Exception 관련 오류 발생 시 문제 원인을 확인할 수 있는 정보입니다.

    • Trace Id: 오류가 발생한 요청의 ID

    • Type: 오류의 유형

    • Stack Trace: 오류 발생 지점과 관련된 코드 호출 스택

이벤트 트레이스 정보 조회

Out Of Memory(OOM) 또는 Exception 알람 발생 시 관련 이벤트의 트레이스 정보를 조회할 수 있습니다.

알람 상세 정보 화면에서 'Event' 항목의 Trace Id 값을 클릭하면 해당 트레이스의 정보를 확인할 수 있는 Trace View 화면이 열립니다.

figure alarm trace view
항목 설명

스팬 이름

스팬의 이름입니다.

스팬 ID

스팬의 ID입니다.

시작 시간

스팬이 시작된 시간입니다.

전체 실행 시간 (ms)

스팬이 시작되어 완료되기까지의 총 소요 시간입니다. (단위: ms)

자체 실행 시간 (ms)

하위 작업을 제외하고, 해당 스팬 자체에서 소요된 시간입니다. (단위: ms)

전체 실행 시간 (%)

스팬이 트레이스에서 차지하는 실행 시간의 비율입니다. (단위: %)

갭 (ms)

이전 스팬과 현재 스팬 간의 시간 차이입니다. (단위: ms)

업무

스팬이 속한 업무의 이름입니다.

이때 목록에서 특정 행을 클릭하면 해당 스팬의 상세 정보를 확인할 수 있는 Span Detail 화면이 열립니다.

figure alarm span detail
항목 설명

업무

스팬이 속한 업무의 이름입니다.

인스턴스

스팬이 실행된 서비스 인스턴스입니다.

서비스

스팬이 속한 서비스의 이름입니다.

스팬 유형

스팬이 실행하는 작업의 유형입니다.

에러 여부

스팬 실행 중 에러의 발생 여부입니다.

태그

스팬에 지정된 태그 정보입니다.

단일 룰

단일 룰은 하나의 조건을 기준으로 알람을 생성하는 규칙입니다.

단일 룰 생성

새로운 단일 룰을 생성할 수 있습니다.

  1. 메인 메뉴에서 [모니터링] > [단일 룰] 메뉴를 선택합니다.

  2. 단일 룰 화면이 열리면 [+ 추가] 버튼을 클릭합니다.

    figure monitor set add

  3. 단일 룰 생성 화면이 열리면 룰 정보를 설정한 후 [생성] 버튼을 클릭합니다. (*: 필수 설정 항목)

    figure monitor set add info

    • 기본 항목

      항목 설명

      Only As Condition *

      복합 룰 조건으로만 사용할지 여부입니다.

      Rule Name *

      단일 룰의 이름입니다. 단, 무조건 _rule로 끝나야 하며 고유한 이름이어야 합니다.

      Metrics Name *

      알람을 생성할 메트릭의 이름입니다.

      Level *

      알람의 심각도 수준입니다.

      Threshold / OP *

      알람 발생의 기준인 임계값과 비교 연산자입니다.

      이때 임계값은 1 이상의 값을 입력해야 합니다.

      Period *

      알람을 체크할 시간 주기입니다. (단위: 초)

      Count *

      알람 발생 조건이 충족되는 횟수입니다.

      'Period' 설정값 동안 임계값을 초과하는 횟수가 해당 값에 도달하면 알람이 발생합니다.

      Silence Period *

      알람 발생 조건이 충족된 상태에서 알람을 발생시키지 않을 시간 간격입니다. (단위: 초)

      Message *

      알람 발생 시 표시할 메시지입니다.

      Tags

      알람에 추가할 태그의 키와 값입니다.

      [+ 추가] 버튼을 클릭하면 키와 값 입력란이 하나씩 추가되고, image 버튼을 클릭하면 해당 키와 값 입력란이 삭제됩니다.

    • 고급 선택사항

      항목 설명

      Include Names

      알람 발생 대상에 포함할 이름입니다.

      [+ 추가] 버튼을 클릭해서 여러 개의 이름을 추가할 수 있고, image 버튼을 클릭하면 추가된 이름을 삭제할 수 있습니다.

      Exclude Names

      알람 발생 대상에서 제외할 이름입니다.

      [+ 추가] 버튼을 클릭해서 여러 개의 이름을 추가할 수 있고, image 버튼을 클릭하면 추가된 이름을 삭제할 수 있습니다.

      Include Names Regex

      알람 발생 대상에 포함할 이름 패턴(정규 표현식)입니다.

      Exclude Names Regex

      알람 발생 대상에서 제외할 이름 패턴(정규 표현식)입니다.

      Include Labels

      알람 발생 대상에 포함할 라벨입니다.

      Exclude Labels

      알람 발생 대상에서 제외할 라벨입니다.

      Include Labels Regex

      알람 발생 대상에 포함할 라벨 패턴(정규 표현식)입니다.

      Exclude Labels Regex

      알람 발생 대상에서 제외할 라벨 패턴(정규 표현식)입니다.

단일 룰 상세 정보 조회

단일 룰의 정보를 상세하게 확인할 수 있습니다.

  1. 메인 메뉴에서 [모니터링] > [단일 룰] 메뉴를 선택합니다.

  2. 단일 룰 화면이 열리면 단일 룰 목록에서 상세 정보를 확인할 룰의 이름을 클릭합니다.

    figure monitor set name click

  3. 단일 룰 상세 화면이 열리면 상세 정보를 확인할 수 있습니다.

    figure monitor set detail info

    • 기본

      항목 설명

      Only As Condition

      복합 룰 조건으로만 사용할지 여부입니다.

      Rule Name

      단일 룰의 이름입니다.

      Metrics Name

      알람을 생성할 메트릭의 이름입니다.

      Level

      알람의 심각도 수준입니다.

      Threshold / OP

      알람 발생의 기준인 임계값과 비교 연산자입니다.

      Period

      알람을 체크할 시간 주기입니다.

      Count

      알람 발생 조건이 충족되는 횟수입니다.

      Silence Period

      알람 발생 조건이 충족된 상태에서 알람을 발생시키지 않을 시간 간격입니다.

      Message

      알람 발생 시 표시할 메시지입니다.

      Tags

      알람에 지정된 태그의 키와 값입니다.

    • 고급 선택사항

      항목 설명

      Include Names

      알람 발생 대상에 포함할 이름입니다.

      Exclude Names

      알람 발생 대상에서 제외할 이름입니다.

      Include Names Regex

      알람 발생 대상에 포함할 이름 패턴(정규 표현식)입니다.

      Exclude Names Regex

      알람 발생 대상에서 제외할 이름 패턴(정규 표현식)입니다.

      Include Labels

      알람 발생 대상에 포함할 라벨입니다.

      Exclude Labels

      알람 발생 대상에서 제외할 라벨입니다.

      Include Labels Regex

      알람 발생 대상에 포함할 라벨 패턴(정규 표현식)입니다.

      Exclude Labels Regex

      알람 발생 대상에서 제외할 라벨 패턴(정규 표현식)입니다.

단일 룰 정보 수정

단일 룰의 기본 정보를 수정할 수 있습니다.

  1. 메인 메뉴에서 [모니터링] > [단일 룰] 메뉴를 선택합니다.

  2. 단일 룰 화면이 열리면 단일 룰 목록에서 정보를 수정할 룰의 이름을 클릭합니다.

    figure monitor set name click

  3. 단일 룰 상세 화면이 열리면 [수정] 버튼을 클릭합니다.

    figure monitor set edit button

  4. 단일 룰 수정 대화상자가 열리면 수정할 항목의 값을 설정한 후 [수정] 버튼을 클릭합니다.

    figure monitor set edit info

    다음은 수정 가능한 항목에 대한 설명입니다.

    • 기본

      항목 설명

      Only As Condition *

      복합 룰 조건으로만 사용할지 여부입니다.

      Metrics Name *

      알람을 생성할 메트릭의 이름입니다.

      Level *

      알람의 심각도 수준입니다.

      Threshold / OP *

      알람 발생의 기준인 임계값과 비교 연산자입니다.

      이때 임계값은 1 이상의 값을 입력해야 합니다.

      Period *

      알람을 체크할 시간 주기입니다. (단위: 초)

      Count *

      알람 발생 조건이 충족되는 횟수입니다.

      'Period' 설정값 동안 임계값을 초과하는 횟수가 해당 값에 도달하면 알람이 발생합니다.

      Silence Period *

      알람 발생 조건이 충족된 상태에서 알람을 발생시키지 않을 시간 간격입니다. (단위: 초)

      Message *

      알람 발생 시 표시할 메시지입니다.

      Tags

      알람에 추가할 태그의 키와 값입니다.

      [+ 추가] 버튼을 클릭하면 키와 값 입력란이 하나씩 추가되고, image 버튼을 클릭하면 해당 키와 값 입력란이 삭제됩니다.

    • 고급 선택사항

      항목 설명

      Include Names

      알람 발생 대상에 포함할 이름입니다.

      [+ 추가] 버튼을 클릭해서 여러 개의 이름을 추가할 수 있고, image 버튼을 클릭하면 추가된 이름을 삭제할 수 있습니다.

      Exclude Names

      알람 발생 대상에서 제외할 이름입니다.

      [+ 추가] 버튼을 클릭해서 여러 개의 이름을 추가할 수 있고, image 버튼을 클릭하면 추가된 이름을 삭제할 수 있습니다.

      Include Names Regex

      알람 발생 대상에 포함할 이름 패턴(정규 표현식)입니다.

      Exclude Names Regex

      알람 발생 대상에서 제외할 이름 패턴(정규 표현식)입니다.

      Include Labels

      알람 발생 대상에 포함할 라벨입니다.

      Exclude Labels

      알람 발생 대상에서 제외할 라벨입니다.

      Include Labels Regex

      알람 발생 대상에 포함할 라벨 패턴(정규 표현식)입니다.

      Exclude Labels Regex

      알람 발생 대상에서 제외할 라벨 패턴(정규 표현식)입니다.

단일 룰 삭제

사용하지 않는 단일 룰을 삭제할 수 있습니다.

  1. 메인 메뉴에서 [모니터링] > [단일 룰] 메뉴를 선택합니다.

  2. 단일 룰 화면이 열리면 단일 룰 목록에서 삭제할 룰의 체크박스를 선택한 후 [삭제] 버튼을 클릭합니다.

    figure single rule delete checkbox click

  3. 단일 룰 삭제 대화상자가 열리면 입력란에 삭제할 룰 이름을 그대로 입력한 후 [삭제] 버튼을 클릭합니다.

    figure single rule delete confirm

 

☞ 더 알아보기

다음과 같은 방법으로도 단일 룰을 삭제할 수 있습니다.

  • 단일 룰 상세 화면에서 [삭제] 버튼을 클릭합니다.

    figure monitor set del button

복합 룰

복합 룰은 여러 조건을 조합하여 알람을 생성하는 규칙입니다.

복합 룰 생성

새로운 복합 룰을 생성할 수 있습니다.

  1. 메인 메뉴에서 [모니터링] > [복합 룰] 메뉴를 선택합니다.

  2. 복합 룰 화면이 열리면 [+ 추가] 버튼을 클릭합니다.

    figure complex rule set add

  3. 복합 룰 생성 화면이 열리면 룰 정보를 설정한 후 [생성] 버튼을 클릭합니다. (*: 필수 설정 항목)

    figure complex rule set add info
    항목 설명

    Rule Name *

    복합 룰의 이름입니다. 단, 무조건 _rule로 끝나야 하며 고유한 이름이어야 합니다.

    Expression *

    알람 발생 조건입니다.

    image(AND), image(OR)의 논리 연산자를 사용하여 여러 개의 단일 룰을 결합할 수 있습니다. 이때 [+ 추가] 버튼을 클릭하면 결합할 단일 룰을 추가할 수 있고, image 버튼을 클릭하면 추가한 단일 룰을 삭제할 수 있습니다.

    Message *

    알람 발생 시 표시할 메시지입니다.

    Tags

    알람에 추가할 태그의 키와 값입니다.

    [+ 추가] 버튼을 클릭하면 키와 값 입력란이 하나씩 추가되고, image 버튼을 클릭하면 해당 키와 값 입력란이 삭제됩니다.

복합 룰 상세 정보 조회

복합 룰의 정보를 상세하게 확인할 수 있습니다.

  1. 메인 메뉴에서 [모니터링] > [복합 룰] 메뉴를 선택합니다.

  2. 복합 룰 화면이 열리면 복합 룰 목록에서 상세 정보를 확인할 룰의 이름을 클릭합니다.

    figure complex rule name click

  3. 복합 룰 상세 화면이 열리면 상세 정보를 확인할 수 있습니다.

    figure complex rule detail info
    항목 설명

    Rule Name

    복합 룰의 이름입니다.

    Expression

    알람 발생 조건입니다.

    Message *

    알람 발생 시 표시할 메시지입니다.

    Tags

    알람에 지정된 태그의 키와 값입니다.

복합 룰 정보 수정

복합 룰의 기본 정보를 수정할 수 있습니다.

  1. 메인 메뉴에서 [모니터링] > [복합 룰] 메뉴를 선택합니다.

  2. 복합 룰 화면이 열리면 복합 룰 목록에서 정보를 수정할 룰의 이름을 클릭합니다.

    figure complex rule name click

  3. 복합 룰 상세 화면이 열리면 [수정] 버튼을 클릭합니다.

    figure complex rule edit button

  4. 복합 룰 수정 대화상자가 열리면 수정할 항목의 값을 설정한 후 [수정] 버튼을 클릭합니다.

    figure complex rule edit info

    다음은 수정 가능한 항목에 대한 설명입니다.

    항목 설명

    Expression *

    알람 발생 조건입니다.

    image(AND), image(OR)의 논리 연산자를 사용하여 여러 개의 단일 룰을 결합할 수 있습니다. 이때 [+ 추가] 버튼을 클릭하면 결합할 단일 룰을 추가할 수 있고, image 버튼을 클릭하면 추가한 단일 룰을 삭제할 수 있습니다.

    Message *

    알람 발생 시 표시할 메시지입니다.

    Tags

    알람에 추가할 태그의 키와 값입니다.

    [+ 추가] 버튼을 클릭하면 키와 값 입력란이 하나씩 추가되고, image 버튼을 클릭하면 해당 키와 값 입력란이 삭제됩니다.

복합 룰 삭제

사용하지 않는 복합 룰을 삭제할 수 있습니다.

  1. 메인 메뉴에서 [모니터링] > [복합 룰] 메뉴를 선택합니다.

  2. 복합 룰 화면이 열리면 복합 룰 목록에서 삭제할 룰의 체크박스를 선택한 후 [삭제] 버튼을 클릭합니다.

    figure complex rule delete checkbox click

  3. 복합 룰 삭제 대화상자가 열리면 입력란에 삭제할 룰 이름을 그대로 입력한 후 [삭제] 버튼을 클릭합니다.

    figure complex rule delete confirm

 

☞ 더 알아보기

다음과 같은 방법으로도 복합 룰을 삭제할 수 있습니다.

  • 복합 룰 상세 화면에서 [삭제] 버튼을 클릭합니다.

    figure complex rule del button