Monitoring > Cloud Monitoring > 콘솔 사용 가이드

콘솔 사용 가이드에서는 Cloud Monitoring 서비스의 기본적인 사용법을 안내합니다.

대시보드

Monitoring > Cloud Monitoring > 대시보드에서는 NHN Cloud 서비스에서 생성한 리소스에서 수집한 다양한 지표를 차트 위젯으로 만들고 대시보드를 구성해서 지표를 확인할 수 있습니다.

사용자가 구성한 대시보드의 지표 데이터 조회 기간은 기본적으로 현재 시각으로부터 5분 전까지의 데이터를 조회합니다. 기본 설정된 자동 새로고침 간격은 1분입니다.

사용자 지정 기간을 설정하면 자동 새로고침은 사용할 수 없습니다.

조회 모드/편집 모드

대시보드에는 조회 모드와 편집 모드 두 가지가 있습니다.

대시보드는 기본적으로 조회 모드로 표시되며, 대시보드나 위젯을 수정하려면 편집 모드 토글을 클릭해 편집 모드로 전환해야 합니다.

편집 모드에서는 대시보드의 이름 또는 설명을 수정하거나, 대시보드를 복제 또는 삭제할 수 있습니다. 각 위젯을 수정하거나 위젯의 위치 이동 및 복제를 수행할 수도 있습니다.

위젯을 추가하거나 위젯의 위치 및 크기 등을 수정한 내용은 전체 저장을 클릭해야 적용됩니다. 저장하지 않은 경우 저장 알림 모달이 표시되며, 저장하지 않은 변경 사항은 사라집니다.

대시보드 생성

조회 모드에서 대시보드 탭 오른쪽의 + 버튼을 클릭하면 대시보드 추가 모달이 열립니다.

생성된 대시보드가 없을 경우 + 대시보드 생성 버튼이 표시됩니다.

대시보드 이름과 대시보드 설명을 입력합니다. 대시보드 이름은 반드시 입력해야 하는 필수 값이며, 중복된 이름으로 설정할 수 있으나 되도록 고유한 이름을 사용할 것을 권장합니다. 대시보드 설명은 선택 값으로, 해당 대시보드를 설명할 수 있는 내용을 입력합니다.

대시보드 템플릿

대시보드를 직접 구성하거나 미리 구성된 템플릿으로 시작할 수 있습니다. 대시보드 템플릿 항목에서 사용 여부를 선택합니다.

• 사용: 템플릿 선택 영역이 표시됩니다. 서비스를 선택하면 해당 서비스에 대한 템플릿 목록이 표시됩니다.
• 사용 안 함(기본값): 템플릿 없이 빈 대시보드가 생성됩니다.

템플릿 사용을 선택한 경우 서비스와 템플릿을 각각 선택합니다. 템플릿을 선택하면 대시보드 이름 필드에 템플릿 이름이 자동으로 입력되며, 이름은 자동 입력된 이후에도 수정할 수 있습니다.

템플릿 목록에서 미리보기 버튼을 클릭하면 템플릿 미리보기 모달이 열립니다.

미리보기 모달에서는 템플릿에 포함된 위젯 구성과 레이아웃을 미리 확인할 수 있습니다. 미리보기 화면에는 샘플 데이터가 표시되며, 대시보드 생성 후 실제 데이터를 확인할 수 있습니다.

대시보드 구성

대시보드에는 위젯과 위젯 그룹을 추가할 수 있습니다. 위젯은 대시보드마다 12개까지 추가할 수 있으며, 추가 시 대시보드의 최하단에 추가됩니다.

위젯은 대시보드를 구성하는 최소 단위입니다. + 위젯 추가를 클릭하거나 해당 버튼의 드롭다운 목록에서 위젯 추가, 위젯 템플릿 추가를 선택해 생성할 수 있습니다. 위젯의 크기와 위치는 대시보드 편집 모드에서 자유롭게 변경할 수 있습니다.

위젯 그룹을 사용하면 여러 위젯을 그룹으로 묶어 관리할 수 있습니다. 위젯 그룹을 접거나 펼쳐서 여러 위젯을 숨기고 나타낼 수 있으며, 위젯 그룹의 높이 및 너비는 그룹 내의 위젯 크기에 따라 자동으로 조절됩니다.

위젯 및 위젯 그룹 추가/수정

위젯 및 위젯 그룹은 조회 모드와 편집 모드 상태 모두에서 추가할 수 있습니다. 단, 위젯 및 위젯 그룹을 수정하려면 편집 모드로 전환해야 합니다.

위젯 추가

위젯을 추가하여 원하는 지표와 필터를 적용해 차트 위젯을 자유롭게 생성할 수 있습니다. 위젯 이름, 그래프 유형, 서비스, 지표 설정 > 지표 항목은 필수 값이므로 반드시 입력해야 합니다. 하나의 위젯은 단일 서비스만 표현할 수 있습니다. 단, 지표 항목은 복수 개 선택할 수 있습니다.

지표 항목을 선택할 때마다 화면 하단에 지표 항목의 필터와 범례를 설정할 수 있는 요소가 추가됩니다. 지표 필터 레이블은 종류별로 1개만 지정 가능하고, 모든 필터는 & 연산 형태로 최종 적용됩니다. 따라서 필터를 복수 개 적용할 때, 조건 값의 검색 결과는 이전에 설정한 필터 조건들을 모두 충족하는 검색 결과만 표시됩니다. 앞서 추가한 필터의 연산자와 조건 값에 따라 더 이상 선택할 수 있는 조건 값이 없을 수 있습니다.

범례는 각 지표 항목으로 조회한 지표 데이터를 구분하기 위한 이름입니다. 지표 항목을 추가하면 기본적으로 추천되는 이름을 자동으로 채워 넣습니다. {{ }} 이중 중괄호 문법으로 감싼 플레이스홀더 앞/뒤로 원하는 문구를 추가할 수 있습니다. 아무 텍스트도 입력하지 않으면 지표 항목이 가지고 있는 레이블 속성을 모두 연결해 표시합니다. 단위를 선택해서 차트에 표시할 Y축 타이틀 및 단위를 지정할 수 있습니다. 단위에 따른 별도 포매팅은 지원하지 않고 지표 항목의 실제 값을 소수점 15자리까지 표시합니다(16번째 자리에서 반올림하며, Percent(0.0~1.0)를 선택한 경우만 예외적으로 0~100으로 값을 변환하여 표시합니다). Y축 위치 설정으로 지표 항목의 Y축 위치를 자동 / 왼쪽 / 오른쪽 중에서 선택할 수 있습니다. 지표 항목 추가 시, 기본적으로 자동 값이 선택되어 있습니다. 모든 지표 항목이 자동으로 선택되어 있다면, 순차적으로 Y축을 왼쪽 또는 오른쪽 위치로 나누어 배치합니다. 만약 Y축 위치가 왼쪽 또는 오른쪽으로 지정된 지표가 있으면 같은 Y축 방향으로 배치합니다. 이때, 단위와 Y축 위치가 같은 지표 항목이 있다면 같은 Y축으로 표현합니다.

쿼리 설정 블록

지표 항목을 선택하면 해당 지표에 대한 지표 설정 블록이 추가되며, 지표 설정 블록 내에 쿼리 설정 블록이 기본 1개 포함되어 추가됩니다.

쿼리 설정 블록은 개별 쿼리별로 필터, 범례, 집계 등을 설정하는 단위입니다. 하나의 지표 설정 블록 내에 여러 쿼리 설정 블록을 추가할 수 있으며, 각 쿼리는 알파벳 순서(A, B, C, ...)로 자동 번호가 부여됩니다.

• 추가: 지표 설정 블록의 + 아이콘을 클릭하면 하단에 쿼리 설정 블록이 추가됩니다.
• 복사: 쿼리 설정 블록의 복사 아이콘을 클릭하면 필터, 범례, 집계 설정값이 모두 복제된 쿼리가 추가됩니다.
• 삭제: 쿼리 설정 블록이 2개 이상인 경우 삭제 아이콘이 활성화됩니다.
• 접기/펼치기: 쿼리 설정 블록을 접으면 타이틀 영역에 필터, 집계 등 핵심 요약 정보가 표시됩니다.

쿼리 설정 블록 간의 필터, 집계 등의 설정값은 중복이 가능합니다. 각각 독립된 쿼리로 간주되어 설정값이 동일한 경우에도 위젯에 모두 표시됩니다.

집계 설정

조회 기간이 넓어지면 차트에 표시되는 데이터 간격이 자동으로 조정됩니다. 이때 데이터 간격 내에 존재하는 개별 데이터 포인트는 차트에 반영되지 않을 수 있습니다. 집계 기능을 사용하면 데이터 간격 내의 모든 데이터를 평균, 최소, 최대 등의 집계 함수로 계산하여 차트에 표시할 수 있습니다. 집계를 지원하는 지표에서만 집계 설정 영역이 표시됩니다.

• 사용 안 함(기본값): 각 시점의 실제 데이터 값을 가공 없이 그대로 표시합니다. 조회 기간에 따라 데이터 간격 내의 일부 데이터가 차트에 반영되지 않을 수 있습니다.
• 사용: 집계 항목(평균, 최소, 최대)을 선택할 수 있습니다. 데이터 간격 내에 발생한 모든 데이터를 집계하여 반영하므로 전체적인 흐름과 추세를 파악하기 용이합니다.

조회 기간에 따른 데이터 간격은 다음과 같습니다.

조회 기간	데이터 간격
~ 5분	15초
~ 30분	30초
~ 1시간	1분
~ 6시간	5분
~ 12시간	10분
~ 24시간	20분
~ 2일	30분
~ 7일	2시간
~ 14일	3시간
~ 27일	6시간
~ 366일	24시간

예를 들어, 조회 기간을 24시간으로 설정하면 데이터 간격이 20분이 되어 그 사이의 데이터는 차트에 직접 표시되지 않습니다. 집계를 사용하면 20분 구간 내 모든 데이터를 반영할 수 있습니다.

아래는 5분 데이터 간격으로 집계를 적용한 예시입니다. 회색 점은 수집된 원본 데이터이며, 빨간 점은 실제 차트에 표시되는 값입니다.

Aggregation Off는 집계를 사용하지 않은 경우입니다. 12:05, 12:10 시점의 데이터만 차트에 표시되고, 그 사이에 수집된 데이터(0.8, 5.0, 1.0)는 차트에서 확인할 수 없습니다. Aggregation On은 평균 집계를 사용한 경우입니다. 각 구간 내 모든 데이터의 평균을 계산하여 차트에 표시하므로, 구간 사이에 수집된 데이터도 결과에 반영됩니다.

동적 필터 적용

동적 필터 적용 토글로 대시보드 상단에서 선택한 동적 필터 조건을 해당 위젯에 반영할지 설정할 수 있습니다. 기본값은 On입니다. 동적 필터 적용 시 항상 대시보드 상단 필터에서 선택한 조건으로 적용됩니다.

그래프 유형을 변경하거나 지표 항목 필터를 수정한 뒤 변경점이 반영된 차트 위젯의 모습을 미리 확인할 수 있습니다. 화면 오른쪽 상단의 미리보기 토글을 클릭해 필터와 범례 값을 적용한 차트 위젯을 실시간으로 확인할 수 있는 미리보기 레이어를 열거나 닫을 수 있습니다. 미리보기 레이어는 좌우 너비를 조정할 수 있습니다.

위젯 템플릿 추가

위젯 템플릿은 미리 구성한 위젯의 지표 항목들을 이용해 위젯을 더 간편하게 생성할 수 있는 기능입니다. 위젯을 추가한 뒤 위젯 수정으로 지표 항목에 필터를 추가하거나 지표 항목 및 이름을 변경할 수 있습니다. 단, 일부 위젯 템플릿으로 추가한 위젯은 삭제만 가능하고 수정이 불가능할 수 있습니다.

위젯 그룹 추가

대시보드에 위젯 그룹을 추가할 수 있습니다. 위젯을 위젯 그룹에 추가하려면 편집 모드에서 위젯 상단의 타이틀 영역을 드래그해서 위젯 그룹 내부로 옮기면 됩니다.

위젯 그룹은 위젯과 마찬가지로 수정이 가능하며, 위젯 그룹을 수정하려면 편집 모드로 전환해야 합니다.

• 수정을 클릭하면 위젯 그룹 수정 모달이 열립니다.
• 그룹 삭제를 클릭하면 위젯의 위치나 크기 정보는 그대로 남고, 그룹만 제거됩니다.
• 그룹 및 하위 위젯 전체 삭제를 클릭하면 그룹 내의 위젯까지 전체 삭제됩니다.

위젯 이동/복제/삭제

편집 모드로 전환한 뒤 위젯 오른쪽 하단 모서리를 드래그해 크기를 조정하거나 위젯 상단 영역을 드래그해 위치를 이동할 수 있습니다.

• 삭제를 클릭해 위젯을 삭제할 수 있습니다.
• 대시보드 내 위젯 복제를 클릭해 대시보드에 위젯을 복제할 수 있습니다. 복제된 위젯은 최하단에 추가됩니다.
• 다른 대시보드에 위젯 복제를 클릭해 다른 대시보드에 위젯을 복제할 수 있습니다. 이때, 위젯을 추가할 대시보드를 선택할 수 있는 모달이 열립니다.

알림 생성

알림 생성을 클릭하면 알림 관리 > 알림 생성 화면으로 이동합니다. 위젯 이름, 서비스, 지표 항목, 지표 항목 필터 정보 등 해당 위젯의 정보가 입력된 상태로 간편하게 알림을 생성할 수 있습니다. 알림 조건 및 알림 수신 대상만 입력하면 간편하게 알림을 생성할 수 있습니다.

동적 필터

동적 필터는 대시보드 상단의 공통 필터 영역에서 개별 위젯을 하나씩 수정하지 않고 전체 위젯의 데이터를 한 번에 필터링하는 기능입니다.

동적 필터는 서비스별로 그룹화되어 배치됩니다. 필터 항목 간 영향도에 따라 내부 정의된 우선순위에 따라 왼쪽에서 오른쪽으로 자동 배치됩니다.

동적 필터 항목을 변경하면 대시보드 내 위젯에 즉시 반영됩니다. 왼쪽 필터의 선택값을 변경하면 오른쪽 필터의 항목이 변경된 조건에 맞게 갱신되며, 오른쪽 필터의 선택 상태는 초기화됩니다.

동적 필터의 선택 상태에 따라 다음과 같이 표시됩니다.

선택 상태	표시 형식	예시
전체 선택(기본값)	전체	전체
1개 선택	선택한 필터값	한국(판교)
2개 이상 선택	{필터값} 외 N개	한국(판교) 외 2개
선택 항목 없음	선택 항목 없음	선택 항목 없음
항목 없음	항목 없음	항목 없음

참고: 동적 필터는 위젯 추가/편집 화면에서 동적 필터 적용 토글을 활성화한 위젯에만 적용됩니다.

동적 필터 관리

조회 모드에서 동적 필터 관리 버튼을 클릭하면 동적 필터 관리 모달이 열립니다. 편집 모드에서는 동적 필터 관리 버튼이 표시되지 않습니다.

동적 필터는 대시보드별로 독립적으로 관리됩니다. 모달 상단에 현재 설정 중인 동적 필터가 적용되는 대시보드 이름이 안내됩니다.

• 추가: 추가 버튼을 클릭하면 동적 필터 목록의 최하단에 새로운 행이 추가됩니다. 다음 항목을 입력합니다.
• 필터 이름: 대시보드 상단에 표시될 필터의 이름을 입력합니다.
• 서비스: 동적 필터를 적용할 서비스를 선택합니다. (예: Instance, Load Balancer)
• 레이블: 선택한 서비스에서 사용 가능한 레이블을 선택합니다. (예: Instance 서비스 선택 시 리전, 인스턴스 등)
• 편집: 기존 동적 필터의 편집 버튼을 클릭하면 필터 이름, 서비스, 레이블을 수정할 수 있습니다.
• 삭제: 삭제 버튼을 클릭하면 해당 동적 필터가 삭제됩니다.

동일한 서비스와 레이블 조합은 중복으로 추가할 수 없습니다.

대시보드 관리

대시보드 관리를 클릭하면 대시보드 관리 모달이 표시됩니다. 대시보드의 이름, 설명, 생성 일시, 프로젝트 대시보드 노출 설정 여부를 확인하거나 편집할 수 있습니다.

각 대시보드 편집 열의 수정 또는 삭제 아이콘을 클릭해 해당 대시보드의 이름 및 설명을 수정하거나 대시보드를 삭제할 수 있습니다. 프로젝트 대시보드 노출 설정 토글을 클릭해 프로젝트 커스텀 대시보드 화면에서 해당 대시보드의 노출 여부를 설정할 수 있습니다. 노출 설정을 해제하더라도 Cloud Monitoring 서비스에서는 항상 노출됩니다.

위젯 데이터 다운로드

대시보드의 모든 위젯 데이터를 .png, .csv, .xlsx 파일로 내려받을 수 있습니다. 파일명은 대시보드 이름으로 저장되며, .csv 파일의 경우 대시보드 이름으로 압축한 .zip 파일로 다운로드됩니다. 내부에는 각 위젯 이름으로 된 개별 .csv 파일이 들어 있습니다. .csv, .xlsx 파일의 경우 시작 일시를 기준으로 최대 3개월간의 데이터만 다운로드할 수 있습니다. 조회 기간이 1개월 미만일 경우 5분 간격으로 데이터를 제공하며, 1개월 이상은 1일 간격으로 데이터를 제공합니다. 지정한 조회 기간이 길거나 위젯과 위젯에 포함된 지표 데이터가 많을수록 다운로드에 소요되는 시간이 오래 걸릴 수 있습니다.

알림 관리

Monitoring > Cloud Monitoring > 알림 설정에서는 NHN Cloud 리소스에 알림을 추가할 수 있고, 알림 발생 이력을 확인할 수 있습니다.

알림 설정

알림 설정 화면에서는 생성한 알림의 정보를 확인할 수 있는 테이블이 표시되며, 알림명, 알림 사용 여부, 생성 일시로 테이블의 정렬을 변경할 수 있습니다. - 알림 사용 여부 토글을 클릭해 알림을 활성화하거나 비활성화할 수 있습니다. - 알림 상세 보기 열의 보기를 클릭하면 알림 상세 정보 모달이 표시됩니다. - 수정 열의 수정을 클릭하면 알림 수정 화면으로 이동합니다. - 각 알림 행을 클릭하면 알림 발생 이력 탭으로 이동하며, 해당 알림이 자동 조회되어 표시됩니다.

알림 생성/수정

알림 기본 정보의 이름, 서비스와 알림 설정의 지표 항목 및 알림 조건, 알림 수신 대상은 필수 값이므로 반드시 입력해야 합니다. 알림의 서비스는 단일 선택만 가능하고, 지표 항목은 복수 개 선택할 수 있습니다.

지표 항목을 선택하면 해당 지표에 대한 지표 설정 블록이 추가되며, 지표 설정 블록 내에 쿼리 설정 블록이 기본 1개 포함됩니다. 쿼리 설정 블록은 개별 쿼리별로 필터, 집계, 조건 등을 설정하는 단위이며, 하나의 지표 설정 블록 내에 여러 쿼리 설정 블록을 추가할 수 있습니다.

집계를 지원하는 지표에서는 쿼리 설정 블록 내에 집계 설정 영역이 표시됩니다. 사용을 선택하면 집계 항목(평균, 최소, 최대)을 선택할 수 있으며, 사용 안 함(기본값)을 선택하면 원본 데이터를 기반으로 알림을 판단합니다.

지표 항목의 필터는 입력하지 않아도 되지만 조건은 반드시 1개 이상 입력해야 합니다. 알림을 받고자 하는 조건을 비교 방법, 임계치, 지속 시간 조합으로 설정합니다.

알림 수신 대상은 1개 이상 선택해야 합니다. 알림 수신 대상 유형은 알림 수신 그룹만 지원되며, 프로젝트 관리 > 알림 수신 그룹 관리 화면에서 관리할 수 있습니다. [가이드 바로 가기]

알림 수신 그룹의 커스텀 웹훅으로 알림을 받을 수 있습니다.

• 커스텀 웹훅 요청 데이터로 제공하는 파라미터 목록

값	설명	타입	비고
orgName	조직 이름	String
projectName	프로젝트 이름	String
tenantType	서비스 타입	String	organization(커스텀 대시보드) project(Cloud Monitoring)
referenceKey	조직 또는 프로젝트 ID	String
serviceName	서비스 이름	String
alertName	알림명	String
alertId	알림 ID	String
eventsCount	발생 이벤트 개수	Integer
events	알림 이벤트	List<Object>	events 파라미터 목록 참조

• events 파라미터 목록

값	설명	타입	비고
events[].resourceTypeName	리소스 타입 이름(En)	String
events[].enMetricName	지표 이름(En)	String
events[].threshold	임계치	String	Double 형태의 문자열
events[].operator	비교 방법	String	Enum (EQUAL, NOT_EQUAL, GREATER_THAN, LESS_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN_OR_EQUAL)
events[].duration	지속 시간	String	조건에 설정된 값
events[].result	감지된 값	String	Double 형태의 문자열
events[].startAt	이벤트 발생 일시	String	ex) 2024-10-29T08:44:22Z
events[].endAt	이벤트 종료 일시	String	ex) 2024-10-29T08:44:22Z
events[].contMinutes	이벤트 지속 시간(분)	Integer	이벤트가 발생한 시간과 현재 시간의 차이(분)
events[].labels	발생 위치	Map<String, String>

알림 상세 보기 모달

알림 상세 보기 모달에서는 설정한 알림의 상세 정보를 확인할 수 있습니다. 알림의 이름, 설명, 서비스, 지표 항목 필터 및 알림 조건, 집계 설정 정보, 알림 수신 대상을 확인할 수 있습니다. 집계를 지원하는 지표의 경우 설정된 집계값(사용 안 함/평균/최대/최소)이 표시되며, 집계를 지원하지 않는 지표의 경우 -로 표시됩니다.

알림 발생 이력

발생한 알림의 이력을 조회할 수 있는 검색 필터와 테이블을 사용하여 발생한 알림을 다양하게 조회할 수 있으며, 검색 필터로 조회한 알림 정보를 확인할 수 있는 테이블을 제공합니다. 알림명, 발생 일시, 종료 일시, 서비스, 리소스, 지표 항목, 집계, 결과 값, 지속 시간을 확인할 수 있습니다. 집계를 지원하는 지표의 경우 설정된 집계값이 표시되며, 집계를 지원하지 않는 지표의 경우 -로 표시됩니다. 발생 일시, 종료 일시로 테이블 정렬을 변경할 수 있습니다.

참고: 지속 시간은 알림 발생 시점에서 알림 종료 시점까지의 시간을 나타냅니다. 알림이 발생한 상태에서 해당 알림이 종료되기 전에 알림을 비활성화한다면, 명시적으로 알림이 종료되지 않았기 때문에 지속 시간이 계속 증가할 수 있습니다.

알림 발생 이력 조회

알림명, 알림 상태, 지표 항목, 발생 시간 필터를 사용하여 알림 발생 이력을 조회할 수 있습니다. 초기화를 누르면 검색 필터가 초기화됩니다.

알림 발송 이력 보기 모달

각 알림에서 알림 발송 이력 보기 열의 보기를 클릭하면 알림 발송 이력 보기 모달이 열립니다.

알림 발송 이력 보기 모달에서는 해당 알림의 발생 일시, 지속 시간, 지표 항목, 집계, 결과 값, 알림 조건 등의 알림 설정 정보와 발생 위치를 상세하게 확인할 수 있습니다.

알림을 실제로 발송한 이력도 테이블 형태로 제공합니다. 각 알림 발송 이력의 알림 발송 일시, 알림 방법, 수신 대상, 알림 발송 결과를 확인할 수 있습니다. 알림 발송 일시, 알림 방법으로 테이블 정렬을 변경할 수 있습니다.

지표 관리

Monitoring > Cloud Monitoring > 지표 관리에서는 NHN Cloud 리소스에 대한 서비스별 지표 수집 여부를 설정할 수 있습니다.

지표 수집 설정

서비스별 지표 수집을 설정할 수 있는 테이블이 표시됩니다. 서비스마다 카테고리, 서비스, 서비스 활성화 여부, 지표 수집 설정 내용을 확인할 수 있고, 지표 수집 설정 토글을 클릭해 지표 수집 여부를 설정할 수 있습니다.

지표 수집을 시작/중단하는 경우 확인 모달이 열립니다.

지표 수집을 중단한 경우, 해당 서비스의 지표를 사용해서 생성해 둔 위젯에서 해당 지표가 더 이상 표시되지 않고 해당 지표의 범례가 비활성화됩니다.

예시 화면