How-to guides

사용자는 ServiceWatch를 통해 Samsung Cloud Platform에서 생성한 자원을 모니터링할 수 있습니다.

대시보드 이용하기

ServiceWatch의 대시보드 상세 정보 화면에서 자원을 모니터링할 수 있습니다.

안내
  • 대시보드를 이용하려면 먼저 대시보드를 생성하여 모니터링 지표를 위젯으로 등록해야 합니다.
  • 대시보드 생성에 대한 자세한 내용은 대시보드 생성하기를 참고하세요.

대시보드로 자원을 모니터링하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
  3. 대시보드 목록 페이지에서 모니터링할 자원에 대한 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
  4. 대시보드 상세 페이지에서 모니터링할 기간과 시간대를 선택한 후, 위젯을 통해 자원을 모니터링하세요.
    구분상세 설명
    대시보드 이름대시보드의 이름
    • 이름을 클릭하여, 다른 대시보드 선택 가능
    기간 설정 영역대시보드내 위젯에 적용되는 기간 선택
    • 지표 조회는 현재부터 최대 455일까지 설정 가능
    시간대 설정 영역기간 설정에 적용되는 시간대 선택
    초기화 버튼대시보드 상세 화면에서 조작하거나 설정한 사항들을 모두 초기화
    새로고침 설정 영역위젯 정보의 새로고침 주기 선택
    • 새로고침 버튼을 현재 시간을 기준으로 정보를 새로 표시
    • 새로고침 주기를 클릭하여 원하는 주기 선택 가능: 끄기, 10초, 1분, 2분, 5분, 15분
    수정대시보드의 정보를 수정
    • 수정 버튼 클릭 시, 대시보드 수정 페이지로 이동
    더보기대시보드를 관리하기 위한 추가 작업 항목을 표시
    경보 현황서비스 대시보드의 권장 지표와 연계된 경보 중 활성화된 경보 개수를 단계별로 표시
    • 경보정책 전체 보기 버튼 클릭 시 경보정책 목록 페이지로 이동
    • 펼치기 버튼 클릭 시 위젯 형태로 제공(최대 12개)
      • 경보정책 보기: 해당 지표의 경보정책 상세 페이지로 이동
    대시보드 현황각 자원 모니터링을 위한 지표 위젯 표시
    • 위젯 확대보기 버튼을 클릭하여 지표에 대한 상세 정보 확인 가능
    • 더보기 버튼을 클릭하여 위젯 관리 가능
    • 그래프에 마우스 커서를 위치하면 해당 지점의 시간, 데이터값, 지표 데이터 정보를 팝업으로 표시
    • 마우스를 드래그하여 그래프의 특정 영역을 확대 가능
    • 범례에 표시한 자원명을 클릭하면 해당 자원에 대한 상세 정보가 팝업으로 표시
    표. 대시보드 상세 항목
참고
  • 위젯의 우측 상단에 있는 더보기 > 지표 보기 버튼을 클릭하면 해당 위젯에 대한 지표 정보를 지표 페이지에서 확인할 수 있습니다.
  • 지표 페이지에 대한 자세한 내용은 지표 보기를 참고하세요.

대시보드 즐겨찾기 설정하기

자주 사용하는 대시보드를 즐겨찾기하여 ServiceWatch의 Service Home 페이지에서 해당 대시보드로 쉽게 이동할 수 있습니다.
대시보드를 즐겨찾기 하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
  3. 대시보드 목록 페이지에서 즐겨찾기할 대시보드의 즐겨찾기 아이콘을 체크하세요.상세 정보를 확인할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
    • 즐겨찾기한 대시보드는 대시보드 > 대시보드 즐겨찾기 메뉴 하단과 Service Home 페이지의 대시보드 즐겨찾기 영역에 추가됩니다.

위젯 상세보기

대시보드 내 위젯을 확대하여 개별적으로 확인할 수 있습니다.
개별 위젯을 확대하여 보려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
  3. 대시보드 목록 페이지에서 모니터링할 자원에 대한 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
  4. 대시보드 상세 페이지에서 확대하여 확인할 위젯의 위젯 확대보기 버튼을 클릭하세요. 해당 위젯에 대한 지표 상세 팝업창이 열립니다.
    구분상세 설명
    위젯 이름위젯의 이름 표시
    기간 설정 영역위젯에 적용되는 기간 선택
    • 지표 조회는 현재부터 최대 455일까지 설정 가능
    시간대 설정 영역기간 설정에 적용되는 시간대 선택
    초기화 버튼대시보드 상세 화면에서 조작하거나 설정한 사항들을 모두 초기화
    통계위젯에 표시되는 지표의 통계 기준 선택
    • 통계기준을 클릭하여 기준 선택 가능: 평균, 최소, 최대, 합계
    집계기간 설정 영역위젯 정보의 집계 기간 선택
    • 집계기간을 클릭하여 원하는 기간 선택 가능: 1분, 5분, 15분, 30분, 1시간, 3시간, 6시간, 12시간, 1일
    새로고침 설정 영역위젯 정보의 새로고침 주기 선택
    • 새로고침 버튼을 현재 시간을 기준으로 정보를 새로 표시
    • 새로고침 주기를 클릭하여 원하는 주기 선택 가능: 끄기, 10초, 1분, 2분, 5분, 15분
    차트 영역모니터링 결과를 차트로 표시
    • 그래프, 범례 부분에 마우스 커서를 위치하면 해당 지점의 시간, 데이터값, 지표 데이터 정보를 팝업으로 표시
    • 그래프 영역을 드래그하여 해당 영역을 확대 가능
    • 범례에 표시한 자원명을 클릭하면 해당 자원에 대한 경보 상황이 팝업으로 열림
    표. 지표 상세 항목

경보 이력 확인하기

ServiceWatch의 대시보드에 등록된 지표에 대한 경보 이력을 확인할 수 있습니다.
경보 이력을 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 경보 > 경보 이력 메뉴를 클릭하세요. 경보 이력 페이지로 이동합니다.
  3. 경보 이력 페이지에서 경보 이력을 확인하세요.
    구분상세 설명
    경보 필터 및 검색 영역경보 내역을 필터링하거나 검색 가능
    • 전체 경보 상태: 경보 상태를 선택하여 필터링 가능
    • 검색어 입력란에 경보 정책명을 입력하여 검색 가능
    • 상세 검색: 경보 정책명이나 경보 상태, 변경 일시를 입력하여 검색 가능
    경보 정책명경보 정책의 이름
    • 경보 정책명 클릭 시 해당 경보 정책의 상세 정보 확인 가능
    조건경보 발생 조건과 총 발생 시간
    • 중요도에 따른 단계 표시: High, Middle, Low
    구분경보 생성, 경보 상태 변경 정보 구분
    경보 상태현재 경보 상태
    • Normal: 지표가 설정된 조건에 충족하지 않은 경우
    • Insulfficient data: 지표 데이터를 확인할 수 없는 경우(누락, 미존재, 미도착)
    • Alert: 지표가 설정된 조건에 충족하는 경우
    경보 단계경보 상태가 Alert 상태인 경우, 경보 단계를 표시
    • High, Middle, Low
    표. 경보 이력 항목
참고
새로운 경보 정책을 생성하고 관리할 수 있습니다. 경보 정책에 대한 자세한 내용은 경보 정책 확인하기를 참고하세요.

지표 모니터링하기

ServiceWatch에서 이용 가능한 지표를 확인하고 모니터링할 수 있습니다.

지표별 비교하기

하나 또는 여러 개의 지표와 자원을 선택하여 모니터링할 수 있습니다.
지표별로 비교하여 모니터링하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 지표 메뉴를 클릭하세요. 지표 페이지로 이동합니다.

  3. 지표 페이지에서 지표 보기 모드에서 지표 비교를 클릭하세요.

  4. 지표 페이지의 지표 목록에서 모니터링할 지표를 선택하세요. 선택한 지표에 대한 모니터링 차트가 하단의 선택된 지표 영역에 표시됩니다.

    구분상세 설명
    지표 목록 영역ServiceWatch에서 모니터링 가능한 지표 목록
    • 네임 스페이스, 차원 앞의 + 버튼을 클릭하여 하위 단계 목록 확인 가능
    • 모니터링할 지표를 선택하면 선택된 지표 영역에 차트로 표시
    검색 필터 영역필터링할 검색 항목을 설정한 후, 필터 적용 버튼을 클릭하여 지표 목록을 필터링
    • 네임 스페이스-차원명: 선택한 네임스페이스의 하위 차원명 기준으로 검색
    • 지표명: 정확한 지표명을 입력하여 검색
    • 자원명: 정확한 자원명을 입력하여 검색
    • 자원 ID: 정확한 자원 ID를 입력하여 검색
    • 키워드: 선택한 상위 분류와 입력한 키워드를 기준으로 검색
      • 지표명, 자원명, 자원ID, 태그-Key를 제외한 항목별 검색 진행
    • 태그 Key: 선택한 태그 Key로 검색
    표. 지표 목록 항목

  5. 선택된 지표 영역에서 모니터링 차트를 확인하세요.

    구분상세 설명
    기간 설정 영역차트에 적용되는 기간 선택
    • 지표 조회는 현재부터 최대 455일까지 설정 가능
    시간대 설정 영역차트에 적용되는 시간대 선택
    초기화 버튼차트에서 조작하거나 설정한 사항들을 모두 초기화
    새로고침 설정 영역차트의 새로고침 주기 선택
    • 새로고침 버튼을 현재 시간을 기준으로 정보를 새로 표시
    • 새로고침 주기를 클릭하여 원하는 주기 선택 가능: 끄기, 10초, 1분, 2분, 5분, 15분
    더보기차트를 관리하기 위한 추가 작업 항목을 표시
    그래프 영역차트에 적용되는 기간 동안 수집한 데이터 그래프
    • 그래프에 마우스 커서를 위치하면 해당 지점의 시간, 데이터값, 지표 데이터 정보를 팝업으로 표시
    • 마우스를 드래그하여 그래프의 특정 영역을 확대 가능
    • 범례에 표시된 레이블명을 클릭하면 해당 범례에 대한 상세 정보가 팝업으로 표시
    표 영역범례별 레이블과 통계, 집계기간 확인 및 수정 가능
    • 범례: 범례별 색상
      • 범례 색상을 클릭하여 다른 색상으로 변경 가능
    • 레이블: 선택한 지표의 네임 스페이스, 자원명, 지표명 표시
      • 범례 이름을 클릭하여 변경 가능
      • 영문, 숫자, 특수 문자를 사용하여 3 ~ 255자 이내로 입력
    • 통계: 지표 데이터 집계하는 방법 선택
      • 평균(기본값), 최소, 최대, 합계 중 선택 가능
    • 집계 기간: 지표값의 집계 기간 단위를 선택
      • 1분, 5분(기본값), 15분, 30분, 1시간, 3시간, 6시간, 12시간, 1일 중 선택 가능
    • 더보기: 범례를 삭제하거나 범례에 대한 경보 정책 생성 가능
    표. 지표 비교 모니터링 차트 항목
    참고
    • 통계 방식은 다음과 같습니다.
      • 합계: 해당 기간 동안 수집된 모든 데이터 포인트값의 합
      • 평균: 지정된 기간 동안의 합계에서 해당 기간 동안 데이터 포인터 수를 나눈 값
      • 최소: 지정된 기간 동안 관찰된 가장 낮은 값
      • 최대: 지정된 기간 동안 관찰된 가장 높은 값
    • 지표에 대한 자세한 설명은 지표 개요를 참고하세요.

날짜별 비교하기

하나의 지표와 자원을 날짜 또는 기간별로 비교하여 모니터링할 수 있습니다.
날짜 또는 기간별로 비교하여 모니터링하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 지표 메뉴를 클릭하세요. 지표 페이지로 이동합니다.

  3. 지표 페이지에서 지표 보기 모드에서 날짜 비교를 클릭하세요.

  4. 지표 페이지의 지표 목록에서 모니터링할 지표를 선택하세요. 선택한 지표에 대한 모니터링 차트가 하단의 선택된 지표 영역에 표시됩니다.

    구분상세 설명
    지표 목록 영역ServiceWatch에서 모니터링 가능한 지표 목록
    • 네임 스페이스, 차원 앞의 + 버튼을 클릭하여 하위 단계 목록 확인 가능
    • 모니터링할 지표를 선택하면 선택된 지표 영역에 차트로 표시
    검색 필터 영역필터링할 검색 항목을 설정한 후, 필터 적용 버튼을 클릭하여 지표 목록을 필터링
    • 네임 스페이스-차원명: 선택한 네임스페이스의 하위 차원명 기준으로 검색
    • 지표명: 정확한 지표명을 입력하여 검색
    • 자원명: 정확한 자원명을 입력하여 검색
    • 자원 ID: 정확한 자원 ID를 입력하여 검색
    • 키워드: 선택한 상위 분류와 입력한 키워드를 기준으로 검색
      • 지표명, 자원명, 자원ID, 태그-Key를 제외한 항목별 검색 진행
    • 태그 Key: 선택한 태그 Key로 검색
    표. 지표 목록 항목

  5. 선택된 지표 영역에서 모니터링 차트를 확인하세요.

    구분상세 설명
    날짜 비교/기간 비교지표를 비교할 기준 선택
    • 날짜 비교: 특정 날짜를 지정하여 비교
    • 기간 비교: 26년 5월 제공 예정
    날짜 및 기간 설정 영역비교할 날짜 또는 기간 선택
    • 날짜 비교: 차트로 확인할 날짜 지정
      • 현재부터 최대 455일까지 설정 가능
      • 최대 4개까지 설정 가능
    • 기간 비교: 추후 제공 예정
    시간대 설정 영역차트에 적용되는 시간대 선택
    초기화 버튼차트에서 조작하거나 설정한 사항들을 모두 초기화
    새로고침 설정 영역차트의 새로고침 주기 선택
    • 새로고침 버튼을 현재 시간을 기준으로 정보를 새로 표시
    • 새로고침 주기를 클릭하여 원하는 주기 선택 가능: 끄기, 10초, 1분, 2분, 5분, 15분
    더보기차트를 관리하기 위한 추가 작업 항목을 표시
    그래프 영역차트에 적용되는 기간 동안 수집한 데이터 그래프
    • 그래프에 마우스 커서를 위치하면 해당 지점의 시간, 데이터값, 지표 데이터 정보를 팝업으로 표시
    • 마우스를 드래그하여 그래프의 특정 영역을 확대 가능
    • 범례에 표시된 날짜 또는 기간을 클릭하면 해당 범례에 대한 상세 정보가 팝업으로 표시
    표 영역범례별 레이블과 통계, 집계기간 확인 및 수정 가능
    • 범례: 범례별 색상
      • 범례 색상을 클릭하여 다른 색상으로 변경 가능
    • 기간: 차트에 적용된 기간
    • 지표: 선택한 지표의 네임 스페이스, 자원명, 지표명 표시
    • 통계: 지표 데이터 집계하는 방법 선택
      • 평균(기본값), 최소, 최대, 합계 중 선택 가능.
      • 해당하는 지표에서 의미있는 지표 오른쪽에 초록색 아이콘 표시 참고
    • 집계 기간: 지표값의 집계 기간 단위를 선택
      • 1분, 5분(기본값), 15분, 30분, 1시간, 3시간, 6시간, 12시간, 1일 중 선택 가능
    • 더보기: 범례를 삭제하거나 범례에 대한 경보 정책 생성 가능
    표. 날짜 비교 모니터링 차트 항목
    참고
    • 통계 방식은 다음과 같습니다.
      • 합계: 해당 기간 동안 수집된 모든 데이터 포인트값의 합
      • 평균: 지정된 기간 동안의 합계에서 해당 기간 동안 데이터 포인터 수를 나눈 값
      • 최소: 지정된 기간 동안 관찰된 가장 낮은 값
      • 최대: 지정된 기간 동안 관찰된 가장 높은 값
    • 지표에 대한 자세한 설명은 지표 개요를 참고하세요.

로그 모니터링하기

Samsung Cloud Platform 서비스로부터 수집된 로그를 모니터링할 수 있습니다.

안내
로그 모니터링 데이터를 확인하려면 먼저 로그 그룹로그 스트림을 생성해야 합니다. 로그 그룹에 대한 자세한 내용은 로그 모니터링하기를 참고하세요.

로그 모니터링 데이터를 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 로그 > 로그 그룹 메뉴를 클릭하세요. 로그 그룹 목록 페이지로 이동합니다.
  3. 로그 그룹 목록 페이지에서 상세 정보를 확인할 로그 그룹명을 클릭하세요. 로그 그룹 상세 페이지로 이동합니다.
  4. 로그 그룹 상세 페이지에서 로그 스트림 탭을 클릭하세요. 로그 스트림 목록이 표시됩니다.
  5. 로그 스트림 목록에서 상세 정보를 확인할 로그 스트림명을 클릭하세요. 로그 스트림 상세 페이지로 이동합니다.
    • 로그 스트림 목록 상단의 모든 로그 스트림 조회 버튼을 클릭하면 모든 로그 스트림 상세 페이지로 이동합니다.
      구분상세 설명
      엑셀 다운로드로그 스트림 내역을 엑셀 파일로 다운로드 가능
      타임 스탬프 목록타임 스탬프별 메시지 목록
      • 기간 선택, 사용자 시간대, 메시지 입력을 이용하여 필터링 가능
      표. 로그 그룹 상세 - 로그 스트림 상세 항목

이벤트 알림 수신하기

Samsung Cloud Platform에서 생성된 자원의 변경 사항에 대한 시스템 이벤트 규칙을 생성하여 알림으로 수신할 수 있습니다.

안내
이벤트 알림을 수신하려면 먼저 이벤트 규칙을 생성해 합니다. 이벤트 규칙 생성에 대한 자세한 내용은 이벤트 규칙 생성하기를 참고하세요.

ServiceWatch Agent 설치하기

ServiceWatch Agent를 설치하여 모니터링 대상으로부터 사용자 정의 지표 및 로그를 수집할 수 있습니다.

주의
ServiceWatch Agent를 통한 지표 수집은 사용자 정의 지표로 구분되어 각 서비스로부터 기본으로 수집되는 지표와는 달리 요금이 부과되므로, 불필요한 메트릭 수집 설정을 하지 않도록 주의해야 합니다. 반드시 수집이 필요한 지표만 수집될 수 있도록 설정하세요.

ServiceWatch Agent를 설치하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 Agent Setup & Guideline 버튼을 클릭하세요. Agent Setup & Guideline 팝업창이 열립니다.
  3. Agent Setup & Guideline 팝업창의 설치 파일 URL을 복사하여 해당 주소로 이동하세요. Agent, 매니저, 설정 파일을 다운로드할 수 있습니다.
참고
ServiceWatch Agent를 통한 사용자 정의 지표 및 로그 수집은 현재 Samsung Cloud Platform For Enterprise에서만 사용 가능합니다. 이외 오퍼링에서도 향후 제공 예정입니다.

1 - 대시보드 및 위젯 관리하기

Samsung Cloud Platform Console에서 사용 중인 서비스의 자원을 모니터링하기 위한 대시보드를 생성하고 관리할 수 있습니다.

대시보드 생성하기

ServiceWatch의 대시보드를 생성할 수 있습니다.

개별 위젯 추가로 대시보드 생성하기

대시보드를 생성하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.

  3. 대시보드 목록 페이지에서 대시보드 생성 버튼을 클릭하세요.

  4. 대시보드의 이름을 입력하세요.

    • 대시보드의 이름은 영문, 숫자, 특수 문자(-_)를 사용하여 3 ~ 40자 이내로 입력하세요.
    • 서비스 대시보드에서 사용 중인 이름은 입력할 수 없습니다.
  5. 대시보드를 구성할 위젯을 추가하세요. 위젯 추가 방법에 따라 해당하는 팝업창이 열립니다.

    • 개별 위젯 추가: 지표, 자원을 조합한 단일 위젯을 추가할 수 있습니다. 버튼을 클릭하면 개별 위젯 추가 팝업창이 열립니다.
      구분
      필수 여부
      상세 설명
      지표 구분선택ServiceWatch에서 모니터링 가능한 지표를 전체 또는 주요 지표로 구분하여 필터링하여 지표 목록에 표시
      지표 목록 영역필수ServiceWatch에서 모니터링 가능한 지표 목록
      • 네임 스페이스, 차원 앞의 + 버튼을 클릭하여 하위 단계 목록 확인 가능
      • 모니터링할 지표를 선택하면 선택된 지표 영역에 차트로 표시
      검색 필터 영역-필터링할 검색 항목을 설정한 후, 필터 적용 버튼을 클릭하여 지표 목록을 필터링
      • 네임 스페이스-차원명: 선택한 네임스페이스의 하위 차원명 기준으로 검색
      • 지표명: 정확한 지표명을 입력하여 검색
      • 자원명: 정확한 자원명을 입력하여 검색
      • 자원 ID: 정확한 자원 ID를 입력하여 검색
      • 키워드: 선택한 상위 분류와 입력한 키워드를 기준으로 검색
        • 지표명, 자원명, 자원ID, 태그-Key를 제외한 항목별 검색 진행
      • 태그 Key: 선택한 태그 Key로 검색
      선택된 지표 영역-지표 목록 영역에서 선택한 지표에 대한 모니터링 차트
      • 차트에 적용되는 기간 동안 수집한 데이터 그래프
        • 그래프에 마우스 커서를 위치하면 해당 지점의 시간, 데이터값, 지표 데이터 정보를 팝업으로 표시
        • 마우스를 드래그하여 그래프의 특정 영역을 확대 가능
        • 범례에 표시한 자원명을 클릭하면 해당 자원에 대한 상세 정보가 팝업으로 표시
      • 차트 내 표 영역의 항목값 수정 가능
        • 레이블: 범례 이름을 영문, 숫자, 특수 문자를 사용하여 3 ~ 255자 이내로 입력
        • 통계: 지표 데이터 집계하는 방법 선택
          • 평균(기본값), 최소, 최대, 합계 중 선택 가능
        • 집계 기간: 지표값의 집계 기간 단위를 선택
          • 1분, 5분(기본값), 15분, 30분, 1시간, 3시간, 6시간, 12시간 중 선택 가능
        • 삭제: 해당 범례를 삭제
      표. 개별 위젯 추가 항목
  6. 위젯 추가 팝업창의 완료 버튼을 클릭하세요. 대시보드 생성 페이지에 대시보드에 위젯이 추가됩니다.

  7. 추가된 위젯을 확인한 후, 생성 버튼을 클릭하세요. 대시보드 생성을 알리는 팝업창이 열립니다.

  8. 확인 버튼을 클릭하세요. 대시보드 생성이 완료됩니다.

다중 위젯 추가로 대시보드 생성하기

대시보드를 생성하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.

  3. 대시보드 목록 페이지에서 대시보드 생성 버튼을 클릭하세요.

  4. 대시보드의 이름을 입력하세요.

    • 대시보드의 이름은 영문, 숫자, 특수 문자(-_)를 사용하여 3 ~ 40자 이내로 입력하세요.
    • 서비스 대시보드에서 사용 중인 이름은 입력할 수 없습니다.
  5. 대시보드를 구성할 위젯을 추가하세요. 위젯 추가 방법에 따라 해당하는 팝업창이 열립니다.

    • 다중 위젯 추가: 지표 단위로 원하는 자원을 선택하여 여러 개의 위젯을 한 번에 추가할 수 있습니다. 버튼을 클릭하면 다중 위젯 추가 팝업창이 열립니다.
      구분
      필수 여부
      상세 설명
      지표 구분선택ServiceWatch에서 모니터링 가능한 지표를 전체 또는 주요 지표로 구분하여 필터링하여 지표 목록에 표시
      지표 선택 영역필수추가할 네임스페이스 및 자원 자원을 선택
      • 네임스페이스 및 자원 앞의 + 버튼을 클릭하여 하위 자원 및 지표 목록 확인
      • 지표 목록에서 위젯에 추가할 지표를 체크하면 선택 지표선택된 자원 영역 표시
      • 여러 개의 지표 선택 가능
      선택 지표필수네임스페이스 및 자원 목록에서 선택한 지표 목록 표시
      • 지표를 클릭하면 선택된 자원 영역에 해당 지표에 포함된 자원 목록 표시
      선택된 자원필수선택 지표 목록에서 선택한 지표에 자원 추가
      • 선택 버튼을 클릭한 후, 해당 지표에 추가할 수 있는 자원을 선택하여 최대 5개까지 추가 가능
      • 선택 지표 목록의 모든 지표에 대하여 자원을 추가해야 함
      통계필수지표값의 통계 기준을 선택
      • 평균(기본값), 최소, 최대, 합계 중 선택 가능
      집계 기간필수지표값의 집계 기간 단위를 선택
      • 1분, 5분(기본값), 15분, 30분, 1시간, 3시간, 6시간, 12시간 중 선택 가능
      표. 다중 위젯 추가 항목
  6. 위젯 추가 팝업창의 완료 버튼을 클릭하세요. 대시보드 생성 페이지에 대시보드에 위젯이 추가됩니다.

  7. 추가된 위젯을 확인한 후, 생성 버튼을 클릭하세요. 대시보드 생성을 알리는 팝업창이 열립니다.

  8. 확인 버튼을 클릭하세요. 대시보드 생성이 완료됩니다.

대시보드 불러오기로 대시보드 생성하기

대시보드를 생성하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.

  3. 대시보드 목록 페이지에서 대시보드 생성 버튼을 클릭하세요.

  4. 대시보드의 이름을 입력하세요.

    • 대시보드의 이름은 영문, 숫자, 특수 문자(-_)를 사용하여 3 ~ 40자 이내로 입력하세요.
    • 서비스 대시보드에서 사용 중인 이름은 입력할 수 없습니다.
  5. 대시보드를 구성할 위젯을 추가하세요. 위젯 추가 방법에 따라 해당하는 팝업창이 열립니다.

    • 대시보드 불러오기: ServiceWatch에 등록된 대시보드의 위젯을 불러올 수 있습니다. 버튼을 클릭하면 대시보드 불러오기 팝업창이 열립니다.
      구분
      필수 여부
      상세 설명
      대시보드필수ServiceWatch에 등록된 대시보드 목록 표시
      • 대시보드 선택 시 대시보드에 적용된 위젯이 미리보기 영역에 표시
      미리보기필수대시보드 목록에서 선택한 대시보드에 적용된 위젯 표시
      • 위젯 이름을 체크하여 생성할 대시보드에 추가할 위젯 선택
      • 전체 선택 항목을 체크하면 해당 대시보드의 지표를 모두 선택
      표. 대시보드 불러오기 항목
  6. 위젯 추가 팝업창의 완료 버튼을 클릭하세요. 대시보드 생성 페이지에 대시보드에 위젯이 추가됩니다.

  7. 추가된 위젯을 확인한 후, 생성 버튼을 클릭하세요. 대시보드 생성을 알리는 팝업창이 열립니다.

  8. 확인 버튼을 클릭하세요. 대시보드 생성이 완료됩니다.

대시보드 확인하기

대시보드 목록 페이지에서 선택한 대시보드의 정보를 확인할 수 있습니다.
대시보드의 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
    구분상세 설명
    대시보드명대시보드의 이름
    • 사용자 대시보드는 사용자가 설정한 대시보드 이름. 서비스 대시보드는 서비스 네임스페이스와 일치하는 Samsung Cloud Platform 서비스명
    대시보드 구분대시보드 구분
    • 사용자: 사용자가 직접 생성한 대시보드
    • 서비스: 자동으로 사전 구축된 서비스별 주요 지표로 구성된 대시보드
    수정 일시대시보드 수정 일시
    생성 일시대시보드 생성 일시시
    즐겨찾기즐겨찾기 설정한 경우 노란색으로 표시
    • 즐겨찾기 설정 또는 해제하고자 하는 경우 별모양 클릭
    표. 대시보드 목록 항목
  3. 대시보드 목록 페이지에서 상세 정보를 확인할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
    구분상세 설명
    대시보드명대시보드의 이름 표시
    • 이름을 클릭하여, 다른 대시보드 선택 가능
    기간 설정 영역대시보드내 위젯에 적용되는 기간 선택
    • 지표 조회는 현재부터 최대 455일까지 설정 가능
    시간대 설정 영역기간 설정에 적용되는 시간대 선택
    초기화 버튼대시보드 상세 화면에서 조작하거나 설정한 사항들을 모두 초기화
    새로고침 설정 영역위젯 정보의 새로고침 주기 선택
    • 새로고침 버튼을 현재 시간을 기준으로 정보를 새로 표시
    • 새로고침 주기를 클릭하여 원하는 주기 선택 가능: 끄기, 10초, 1분, 2분, 5분, 15분
    수정대시보드의 이름을 수정하거나 위젯 관리 가능
    • 수정 버튼 클릭 시, 대시보드 수정 페이지로 이동
    더보기대시보드를 관리하기 위한 추가 작업 항목을 표시
    • 대시보드의 복제 및 삭제, 상세 정보 확인, 소스 보기 가능
    위젯 영역각 자원 모니터링을 위한 위젯 표시
    • 위젯 우측 상단의 더보기 버튼을 클릭하여 위젯 관리 가능
    • 위젯의 수정 및 복제, 파일 다운로드, 지표 보기, 소스 보기 가능
    표. 대시보드 상세 항목

대시보드 관리하기

대시보드 상세 페이지에서 대시보드 정보와 위젯을 수정하거나 관리할 수 있습니다.

대시보드 수정하기

대시보드의 이름을 수정하거니 위젯 구성을 변경할 수 있습니다.

안내
서비스 대시보드는 수정할 수 없습니다.

대시보드를 수정하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
  3. 대시보드 목록 페이지에서 상세 정보를 확인할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
  4. 대시보드 상세 페이지의 우측 상단에 있는 수정 버튼을 클릭하세요. 대시보드 수정 페이지로 이동합니다.
  5. 대시보드의 정보나 위젯을 수정한 후, 저장 버튼을 클릭하세요.
    구분상세 설명
    대시보드명대시보드의 이름 수정 불가
    • 영문, 숫자, 특수 문자(-_)를 사용하여 34자 이내로 입력
    • 사용 중인 대시보드 이름은 사용 불가
    위젯 이름위젯 이름 수정 가능
    • 영문, 숫자, 공백, 특수 문자(-_.|)를 사용하여 3 ~ 255자 이내로 입력
    위젯 관리위젯에 마우스 커서를 위치하면 위젯 테두리 우측에 관리 버튼이 표시
    • 수정: 위젯 수정 팝업창에서 위젯의 지표 및 자원 수정 가능
    • 복제: 현재 위젯을 복제하여 대시보드에 추가
    • 삭제: 현재 위젯을 대시보드에서 삭제
    • 확장: 현재 위젯의 크기를 확장하여 표시
      • 축소: 확장하여 표시한 경우, 다시 클릭하면 위젯의 크기를 축소
    위젯 추가대시보드에 새로운 위젯을 추가
    • 개별 위젯 추가: 지표, 자원을 조합한 단일 위젯을 추가
    • 다중 위젯 추가: 지표 단위로 원하는 자원을 선택하여 여러 개의 위젯을 한 번에 추가
    • 대시보드 불러오기: 다른 대시보드의 위젯을 불러와서 추가
    표. 대시보드 수정 항목

대시보드 상세 정보 확인하기

대시보드에 대한 상세 정보를 확인할 수 있습니다.
대시보드의 상세 정보를 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
  3. 대시보드 목록 페이지에서 상세 정보를 확인할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
  4. 대시보드 상세 페이지의 우측 상단에 있는 더보기 > 상세 정보 버튼을 클릭하세요. 대시보드 상세 정보 팝업창이 열립니다.
    구분상세 설명
    대시보드명대시보드 이름
    대시보드 구분대시보드의 사용 구분
    • 사용자: 사용자가 직접 생성한 대시보드
    • 서비스: 자동으로 사전 구축된 서비스별 주요 지표로 구성된 대시보드
    서비스서비스명
    자원 유형dashboard
    SRNSamsung Cloud Platform에서의 고유 자원 ID
    • ServiceWatch에서는 대시보드의 SRN을 의미
    자원명자원 이름
    • ServiceWatch에서는 대시보드의 이름 의미
    자원 ID서비스에서의 고유 자원 ID
    생성자대시보드를 생성한 사용자
    생성 일시대시보드를 생성한 일시
    수정자대시보드 정보를 수정한 사용자
    수정 일시대시보드 정보를 수정한 일시
    표. 대시보드 상세 - 상세 정보 팝업창 항목
참고

대시보드 목록에서 대시보드명 정렬할때, 아래의 정렬 규칙을 따릅니다.

  1. 공백 및 제어문자
  2. 일부 특수문자 ( !"#$%&()*+,-./ )
  3. 숫자 (0–9)
  4. 일부 특수문자 ( ; < = > ? @ )
  5. 영어 (A–Z, a–z, 대소문자 구분 없음)
  6. 나머지 특수문자 ([\]^_`)
  7. 기타 문자

대시보드 소스 코드 확인하기

대시보드의 소스 코드를 확인할 수 있습니다.
대시보드의 소스 코드 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
  3. 대시보드 목록 페이지에서 상세 정보를 확인할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
  4. 대시보드 상세 페이지의 우측 상단에 있는 더보기 > 소스 보기 버튼을 클릭하세요. 대시보드 소스 보기 팝업창이 열립니다.
    구분상세 설명
    소스 정보대시보드 소스 코드를 JSON 형식으로 표시
    코드 복사소스 코드를 클립보드에 복사
    표. 대시보드 상세 - 대시보드 소스 보기 팝업창 항목

대시보드 복제하기

현재 대시보드의 위젯을 복제하여 다른 대시보드에 추가할 수 있습니다.

안내

대시보드를 복제하려면 사용자 권한이 필요합니다.

  • User: {email}
  • Action: iam:CreatGroup
  • On resource: {SRN}
  • Context: no identity-based policy allows the action

대시보드를 복제하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.

  3. 대시보드 목록 페이지에서 상세 정보를 확인할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.

  4. 대시보드 상세 페이지의 우측 상단에 있는 더보기 > 복제 버튼을 클릭하세요. 대시보드 복제 팝업창이 열립니다.

  5. 대시보드 복제 방법을 선택한 후 필수 정보를 입력하세요. 복제 방법에 따라 필수 정보가 달라집니다.

    구분
    필수 여부
    상세 설명
    복제 대상-복제할 대시보드의 이름
    복제 방법필수대시보드의 위젯을 복제한 후, 추가할 대시보드를 선택
    • 신규 대시보드: 새로운 대시보드를 생성하여 현재 대시보드의 위젯을 복제하여 생성
    • 기존 대시보드: 기존 대시보드에 현재 대시보드의 위젯을 복제하여 추가
    대시보드명필수새로 생성할 대시보드의 이름을 입력
    • 복제 방법을 신규 대시보드로 선택 시 표시
    • 영문, 숫자, 특수 문자(-_)를 사용하여 3 ~ 40자 이내로 입력
    대시보드 선택필수기존에 생성된 대시보드 중 복제한 위젯을 추가할 대시보드를 선택
    • 복제 방법을 기존 대시보드로 선택 시 표시
    표. 대시보드 복제 항목

  6. 필수 정보 입력이 끝나면 완료 버튼을 클릭하세요. 대시보드 복제를 알리는 팝업창이 열립니다.

  7. 팝업창의 확인 버튼을 클릭하세요. 대시보드 복제 작업이 완료됩니다.

참고
서비스 대시보드를 복제하여 사용자 대시보드에 위젯을 추가하거나, 새로운 대시보드로 생성할 수 있습니다.

대시보드 삭제하기

사용하지 않는 대시보드를 삭제할 수 있습니다.

안내
서비스 대시보드는 삭제할 수 없습니다.

대시보드를 삭제하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
  3. 대시보드 목록 페이지에서 삭제할 대시보드의 체크박스를 선택한 후, 삭제 버튼을 클릭하세요. 대시보드 삭제를 알리는 팝업창이 열립니다.
    • 여러 개의 대시보드를 동시에 삭제할 수 있습니다.
    • 대시보드 상세 페이지의 우측 상단에 있는 더보기 > 삭제 버튼을 클릭하여 개별적으로 삭제할 수도 있습니다.
  4. 삭제 확인 입력 영역에 삭제를 입력한 후, 확인 버튼을 클릭하세요. 대시보드가 삭제됩니다.

위젯 관리하기

대시보드 상세 페이지에서 위젯을 수정하거나 관리할 수 있습니다.

위젯 수정하기

위젯의 지표와 자원을 수정할 수 있습니다.

안내
서비스 대시보드의 위젯은 수정할 수 없습니다.

위젯을 수정하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
  3. 대시보드 목록 페이지에서 위젯을 수정할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
  4. 대시보드 상세 페이지에서 수정할 위젯의 우측 상단에 있는 더보기 > 위젯 수정 버튼을 클릭하세요. 위젯 수정 팝업창이 열립니다.
  5. 위젯의 지표와 자원을 수정한 후, 확인 버튼을 클릭하세요. 위젯 수정이 완료됩니다.
    구분
    필수 여부
    상세 설명
    지표 구분선택ServiceWatch에서 모니터링 가능한 지표를 전체 또는 주요 지표로 구분하여 필터링하여 지표 목록에 표시
    지표 목록 영역필수ServiceWatch에서 모니터링 가능한 지표 목록
    • 네임 스페이스, 차원 앞의 + 버튼을 클릭하여 하위 단계 목록 확인 가능
    • 모니터링할 지표를 선택하면 선택된 지표 영역에 차트로 표시
    검색 필터 영역-필터링할 검색 항목을 설정한 후, 필터 적용 버튼을 클릭하여 지표 목록을 필터링
    • 네임 스페이스-차원명: 선택한 네임스페이스의 하위 차원명 기준으로 검색
    • 지표명: 정확한 지표명을 입력하여 검색
    • 자원명: 정확한 자원명을 입력하여 검색
    • 자원 ID: 정확한 자원 ID를 입력하여 검색
    • 키워드: 선택한 상위 분류와 입력한 키워드를 기준으로 검색
      • 지표명, 자원명, 자원ID, 태그-Key를 제외한 항목별 검색 진행
    • 태그 Key: 선택한 태그 Key로 검색
    선택된 지표 영역-지표 목록 영역에서 선택한 지표에 대한 모니터링 차트
    • 차트에 적용되는 기간 동안 수집한 데이터 그래프
      • 그래프에 마우스 커서를 위치하면 해당 지점의 시간, 데이터값, 지표 데이터 정보를 팝업으로 표시
      • 마우스를 드래그하여 그래프의 특정 영역을 확대 가능
      • 범례에 표시한 레이블명을 클릭하면 해당 범례에 대한 상세 정보가 팝업으로 표시
    • 차트 내 표 영역에서 범례별 레이블과 통계, 집계기간 확인 및 수정 가능
      • 범례: 범례별 색상
        • 범례 색상을 클릭하여 다른 색상으로 변경 가능
      • 기간: 차트에 적용된 기간
      • 지표: 선택한 지표의 네임 스페이스, 자원명, 지표명 표시
      • 통계: 지표 데이터 집계하는 방법 선택
        • 평균(기본값), 최소, 최대, 합계 중 선택 가능
      • 집계 기간: 지표값의 집계 기간 단위를 선택
        • 1분, 5분(기본값), 15분, 30분, 1시간, 3시간, 6시간, 12시간, 1일 중 선택 가능
      • 삭제: 해당 범례를 삭제
    표. 개별 위젯 추가 항목

위젯 복제하기

위젯을 복사하여 다른 대시보드에 추가할 수 있습니다.

안내

대시보드를 복제하려면 사용자 권한이 필요합니다.

  • User: {email}
  • Action: iam:CreatGroup
  • On resource: {SRN}
  • Context: no identity-based policy allows the action

위젯을 복제하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.

  3. 대시보드 목록 페이지에서 복제할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.

  4. 대시보드 상세 페이지에서 복제할 위젯의 우측 상단에 있는 더보기 > 위젯 복제 버튼을 클릭하세요. 위젯 복제 팝업창이 열립니다.

  5. 위젯 복제 방법을 선택한 후 필수 정보를 입력하세요. 복제 방법에 따라 필수 정보가 달라집니다.

    구분
    필수 여부
    상세 설명
    복제 대상-복제할 대시보드의 이름
    복제 방법필수위젯을 복제한 후, 추가할 대시보드를 선택
    • 기존 대시보드: 기존 대시보드에 위젯을 추가
    • 신규 대시보드: 새로운 대시보드를 생성하여 위젯을 추가
    대시보드 선택필수기존에 생성된 대시보드 중 복제한 위젯을 추가할 대시보드를 선택
    • 복제 방법을 기존 대시보드로 선택 시 표시
    대시보드명필수새로 생성할 대시보드의 이름을 입력
    • 복제 방법을 신규 대시보드로 선택 시 표시
    • 영문, 숫자, 특수 문자(-_)를 사용하여 3 ~ 40자 이내로 입력
    위젯명필수위젯을 대시보드에 추가할 때 위젯의 이름을 입력
    • 영문, 숫자, 특수 문자(-_.|)를 사용하여 3 ~ 255자 이내로 입력
    표. 위젯 복제 항목

  6. 필수 정보 입력이 끝나면 완료 버튼을 클릭하세요. 위젯 추가를 알리는 팝업창이 열립니다.

  7. 팝업창의 확인 버튼을 클릭하세요. 해당 대시보드에 위젯이 복제되어 추가됩니다.

위젯 파일 다운로드하기

위젯 정보를 파일 형태로 다운로드할 수 있습니다.
위젯 정보를 다운로드하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
  3. 대시보드 목록 페이지에서 위젯 정보를 다운로드할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
  4. 대시보드 상세 페이지에서 위젯 정보를 다운로드할 위젯의 우측 상단에 있는 더보기 > 파일 다운로드 버튼을 클릭하세요. 파일 다운로드 팝업창이 열립니다.
  5. 파일 다운로드 방식을 선택한 후, 확인 버튼을 클릭하세요. 다운로드가 시작됩니다.
    • 다운로드 방식은 동시에 선택할 수 있습니다.
      구분상세 설명
      CSV위젯의 지표와 모니터링 데이터를 엑셀(*.csv) 파일로 변환하여 다운로드
      PNG위젯 차트를 이미지(*.png) 파일로 변환하여 다운로드
      표. 위젯 파일 다운로드 항목

위젯 지표 확인하기

위젯의 자원 및 지표 정보를 지표 페이지에서 확인할 수 있습니다.
위젯 지표를 지표 페이지에서 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
  3. 대시보드 목록 페이지에서 위젯 지표를 확인할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
  4. 대시보드 상세 페이지에서 지표 페이지에서 확인할 위젯의 우측 상단에 있는 더보기 > 지표 보기 버튼을 클릭하세요. 지표 페이지로 이동합니다.
    • 선택한 위젯의 자원과 지표 정보는 지표 페이지에서 자동으로 설정되어 표시됩니다.
참고
지표 페이지에 대한 자세한 내용은 지표 보기를 참고하세요.

위젯 소스 코드 확인하기

대시보드의 소스 코드를 확인할 수 있습니다.

안내
서비스 대시보드에서는 위젯의 소스 정보를 확인할 수 없습니다.

대시보드의 소스 코드 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
  3. 대시보드 목록 페이지에서 상세 정보를 확인할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
  4. 대시보드 상세 페이지에서 소스 코드를 확인할 위젯의 우측 상단에 있는 더보기 > 소스 보기 버튼을 클릭하세요. 위젯 소스 보기 팝업창이 열립니다.
    구분상세 설명
    소스 정보위젯 소스 코드를 JSON 형식으로 표시
    코드 복사소스 코드를 클립보드에 복사
    표. 위젯 소스 보기 항목

위젯 파일 다운로드하기

위젯 정보를 파일 형태로 다운로드할 수 있습니다.
위젯 정보를 다운로드하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
  3. 대시보드 목록 페이지에서 위젯 정보를 다운로드할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
  4. 대시보드 상세 페이지에서 위젯 정보를 다운로드할 위젯의 우측 상단에 있는 더보기 > 파일 다운로드 버튼을 클릭하세요. 파일 다운로드 팝업창이 열립니다.
  5. 파일 다운로드 방식을 선택한 후, 확인 버튼을 클릭하세요. 다운로드가 시작됩니다.
    • 다운로드 방식은 동시에 선택할 수 있습니다.
      구분상세 설명
      CSV위젯의 지표와 모니터링 데이터를 엑셀(*.csv) 파일로 변환하여 다운로드
      PNG위젯 차트를 이미지(*.png) 파일로 변환하여 다운로드
      표. 위젯 파일 다운로드 항목

Object Storage로 내보내기

위젯 정보를 Object Storage에 저장할 수 있습니다.

안내

Object Storage에 저장하려면 사용자 권한이 필요합니다.

  • User: {email}
  • Action: iam:CreatGroup
  • On resource: {SRN}
  • Context: no identity-based policy allows the action

위젯 정보를 Object Storage에 저장하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
  3. 대시보드 목록 페이지에서 위젯 정보를 다운로드할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
  4. 대시보드 상세 페이지에서 위젯 정보를 다운로드할 위젯의 우측 상단에 있는 더보기 > Object Storage 내보내기 버튼을 클릭하세요. Object Storage 내보내기 팝업창이 열립니다.
  5. 위젯 정보를 저장할 버킷을 선택한 후, 완료 버튼을 클릭하세요. 저장을 알리는 팝업창이 열립니다.
  6. 팝업창에서 확인 버튼을 클릭하세요. 데이터 내보내기가 시작됩니다.
안내
  • Object Stroage로 내보낼 수 있는 지표의 제한 사항은 다음과 같습니다.
    • 지표 개수: 10개 이내
    • 조회 기간: 2개월(63일) 이내
  • 조회 기간이 2개월(63일)을 초과한 경우, 최대 63일 동안의 데이터만 저장됩니다.
참고
  • 지표 데이터를 저장할 Object Storage가 없을 경우, Object Storage를 생성한 후, 진행하세요.
  • 지표 데이터는 “지표명-yyyymmddhhmmss.json” 파일 형식으로 저장되며 Object Storage 버킷의 ~/servicewatch/metric 경로에서 확인할 수 있습니다.

2 - 경보

ServiceWatch에서 모니터링할 지표에 임곗값 기준을 설정하여 설정한 조건에 충족될 경우, 경보 알림을 발생하도록 경보 정책을 생성하고 관리할 수 있습니다.

참고
Auto-Scaling Group의 정책은 2026년 3월 25일부터 ServiceWatch와 연계됩니다. Auto-Scaling Group의 정책은 ServiceWatch의 경보 정책으로 연계되어 생성되며, Auto-Scaling Group과 연계된 경보 정책은 ServiceWatch에서 수정 또는 삭제가 불가하고 Auto-Scaling Group을 통해서 가능합니다.

경보 정책 생성하기

지표에 대한 경보 정책을 생성하여 경보 발생 기준을 설정할 수 있습니다.
경보 정책을 생성하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 경보 > 경보 정책 메뉴를 클릭하세요. 경보 정책 목록 페이지로 이동합니다.

  3. 경보 정책 목록 페이지에서 경보 정책 생성 버튼을 클릭하세요. 경보 정책 생성 페이지로 이동합니다.

  4. 기본 정보 입력 영역에서 경보 정책의 이름과 설명을 입력한 후, 지표 선택 버튼을 클릭하세요. 지표 선택 팝업창이 열립니다.

  5. 지표 선택 팝업창에서 경보 정책을 생성할 지표를 선택한 후, 확인 버튼을 클릭하세요. 지표 및 조건 설정 영역이 표시됩니다.

    구분
    필수 여부
    상세 설명
    지표 구분필수ServiceWatch에서 모니터링 가능한 지표를 전체 또는 주요 지표로 구분하여 필터링하여 지표 목록에 표시
    지표 목록 영역필수ServiceWatch에서 모니터링 가능한 지표 목록
    • 네임 스페이스, 차원 앞의 + 버튼을 클릭하여 하위 단계 목록 확인 가능
    • 모니터링할 지표를 선택하면 선택된 지표 영역에 차트로 표시
    • 해당 지표가 네임스페이스와 연결되어 있는 경우, 서비스 대시보드 표시
      • 서비스 대시보드 클릭 시 해당 대시보드의 상세 페이지로 이동
    검색 필터 영역-필터링할 검색 항목을 설정한 후, 필터 적용 버튼을 클릭하여 지표 목록을 필터링
    • 네임 스페이스-차원명: 선택한 네임스페이스의 하위 차원명 기준으로 검색
    • 지표명: 정확한 지표명을 입력하여 검색
    • 자원명: 정확한 자원명을 입력하여 검색
    • 자원 ID: 정확한 자원 ID를 입력하여 검색
    • 키워드: 선택한 상위 분류와 입력한 키워드를 기준으로 검색
      • 지표명, 자원명, 자원ID, 태그-Key를 제외한 항목별 검색 진행
    • 태그 Key: 선택한 태그 Key로 검색
    선택된 지표 영역-지표 목록 영역에서 선택한 지표에 대한 모니터링 차트
    • 차트에 적용되는 기간 동안 수집한 데이터 그래프
      • 그래프에 마우스 커서를 위치하면 해당 지점의 시간, 데이터값, 지표 데이터 정보를 팝업으로 표시
      • 마우스를 드래그하여 그래프의 특정 영역을 확대 가능
      • 범례에 표시한 레이블명을 클릭하면 해당 범례에 대한 상세 정보가 팝업으로 표시
    • 차트 내 표 영역에서 범례별 레이블과 통계, 집계기간 확인 및 수정 가능
      • 범례: 범례별 색상
        • 범례 색상을 클릭하여 다른 색상으로 변경 가능
      • 기간: 차트에 적용된 기간
      • 지표: 선택한 지표의 네임 스페이스, 자원명, 지표명 표시
      • 통계: 지표 데이터 집계하는 방법 선택
        • 평균(기본값), 최소, 최대, 합계 중 선택 가능
      • 집계 기간: 지표값의 집계 기간 단위를 선택
        • 1분, 5분(기본값), 15분, 30분, 1시간, 3시간, 6시간, 12시간, 1일 중 선택 가능
      • 삭제: 해당 범례를 삭제
    표. 지표 선택 팝업창 항목

  6. 지표 및 조건 설정 영역에서 경보 발생을 위한 기준값을 설정하세요.

    구분
    필수 여부
    상세 설명
    네임스페이스-선택한 지표의 네임스페이스
    지표명-선택한 지표의 이름
    단위-선택한 지표의 데이터 단위
    평가 범위필수경보 평가를 위한 시간(초) 범위
    • 60과 60배수로 최대 604,800초까지 입력 가능
    • 수집 주기보다 작거나 수집 주기의 배수에 맞지 않게 설정한 경우, 경보 평가가 비정상적으로 적용될 수 있음
    통계필수평가 범위 동안 지표 데이터를 계산하는 방식 선택
    • 합계: 해당 기간 동안 수집된 모든 데이터 포인트값의 합
    • 평균: 지정된 기간 동안의 합계에서 해당 기간 동안 데이터 포인터 수를 나눈 값
    • 최소: 지정된 기간 동안 관찰된 가장 낮은 값
    • 최대: 지정된 기간 동안 관찰된 가장 높은 값
    추가 구성선택평가 횟수와 위반 횟수, 누락 데이터 처리 방법 설정
    • 추가 구성을 사용으로 설정할 경우, 경보 평가할 때 사용하는 평가 횟수와 위반 횟수를 설정할 수 있음. 평가 범위(초)동안 평가 횟수 중에서 위반 횟수 만큼 조건에 만족하면 경보 상태가 Alert으로 전환
      • 평가 횟수: 알람 발생 평가 횟수
        • 1 ~ 8,640 입력 가능
      • 위반 횟수: 알람 발생 시 까지 허용 위반 횟수
        • 1 ~ 평가 횟수 이내로 입력 가능
      • 평가 범위가 1시간(3,600초) 미만일 경우, 평가 횟수/평가 범위는 최대 1일(86,400초)까지 설정 가능
      • 평가 범위가 1시간(3,600초) 이상일 경우, 평가 횟수/평가 범위는 최대 7일(604,800초)까지 설정 가능
    • 추가 구성을 사용으로 설정할 경우, 경보 평가할 때 누락된 데이터를 어떤 방식으로 처리할 지 설정할 수 있음.
      • 누락된 데이터를 누락으로 처리 (Missing)
      • 누락된 데이터를 무시로 처리하여 현재 경보 상태를 유지 (Ignore)
      • 누락된 데이터를 조건에 만족하는 것으로 처리 (Breaching)
      • 누락된 데이터를 조건에 만족하지 않는 정상으로 처리 (Not breaching)
    조건 설정필수
    • 조건 연산자: 평가 범위 동안 지표 데이터를 계산한 후, 해당 값과 임곗값을 비교할 조건 연산자 선택
    • 임곗값: 평가 범위 동안 지표 데이터를 계산한 후, 해당 값과 조건 연산자로 비교할 임곗값 설정
      • 0 ~ 2,147,483,647까지 입력 가능
    • 조건: 설정한 조건 연산자임곗값에 따른 경보 상태(Alert) 변경 조건 설명
    경보 단계필수경보 정책의 중요도에 따른 경보 단계 선택
    자원 ID-지표 모니터링 대상 자원 ID
    자원명-지표 모니터링 대상 자원 이름
    표. 지표 및 조건 설정 항목

  7. 알림 설정 영역에서 경보 발생 시 알림을 전달받을 사용자를 선택하세요.

    • 로그인 이력이 있는 사용자(이메일, 휴대전화 번호 등록 사용자)만 알림 수신자로 추가할 수 있습니다.
    • 알림 수신자는 최대 100명까지 추가할 수 있습니다.
참고
  • 추가하려는 사용자가 없는 경우, IAM 서비스의 사용자 생성 페이지에서 사용자를 생성할 수 있습니다. 사용자 생성에 대한 자세한 내용은 사용자 생성하기를 참고하세요.
  • 알림 수신 방식(E-mail 또는 SMS)은 알림 설정 페이지에서 알림 대상을 서비스 > 경보로 선택한 후, 변경할 수 있습니다. 알림 설정에 대한 자세한 내용은 알림 설정 확인하기를 참고하세요.
  1. 추가 정보 입력 영역에서 태그 정보를 추가하세요.
  2. 요약 정보를 확인한 후, 생성 버튼을 클릭하세요. 경보 정책 생성을 알리는 팝업창이 열립니다.
  3. 확인 버튼을 클릭하세요. 경보 정책 생성이 완료됩니다.
참고
경보 정책 생성은 규모에 따라 수십 분이상 걸릴 수 있습니다.

경보 정책 상세 정보 확인하기

경보 정책에 대한 상세 정보를 확인하고 관리할 수 있습니다.
경보 정책에 대한 상세 정보를 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 경보 > 경보 정책 메뉴를 클릭하세요. 경보 정책 목록 페이지로 이동합니다.
    • 경보 정책 메뉴에 표시된 경보 단계 버튼을 클릭하여 해당 경보 단계에 해당하는 경보 정책 목록만 필터링하여 볼 수도 있습니다.
  3. 경보 정책 목록 페이지에서 상세 정보를 확인할 경보 정책명을 클릭하세요. 경보 정책 상세 페이지로 이동합니다.
    구분상세 설명
    경보 정책 상태경보 정책의 상태
    • Active: 경보 정책이 활성화된 상태
    • Inactive: 경보 정책이 비활성화된 상태
    • 활성화 또는 비활성화 버튼을 클릭하여 변경 가능
    경보 정책 삭제해당하는 경보 정책을 삭제
    경보 상태현재 경보 상태
    • Normal: 지표가 설정된 조건에 충족하지 않은 경우
    • Insulfficient data: 지표 데이터를 확인할 수 없는 경우(누락, 미존재, 미도착)
    • Alert: 지표가 설정된 조건에 충족하는 경우
    • 경보 상태가 Alert 상태인 경우, 경보 단계(>High, Middle, Low)를 함께 표시
    지표 모니터링 차트설정한 기간 동안의 지표 모니터링 차트
    정보 구분 탭경보 정책에 대한 정보 구분 탭
    • 상세 정보, 알림, 경보 이력, 태그, 작업 이력
    • 각 탭을 클릭하면 해당 정보 확인 가능
    표. 경보 상세 항목
참고

경보 정책 목록에서 경보 정책명 정렬할때, 아래의 정렬 규칙을 따릅니다.

  1. 공백 및 제어문자
  2. 일부 특수문자 ( !"#$%&()*+,-./ )
  3. 숫자 (0–9)
  4. 일부 특수문자 ( ; < = > ? @ )
  5. 영어 (A–Z, a–z, 대소문자 구분 없음)
  6. 나머지 특수문자 ([\]^_`)
  7. 기타 문자

상세 정보

경보 정책 목록 페이지에서 선택한 경보 정책의 기본 정보와 지표 정보를 확인할 수 있습니다.

구분상세 설명
서비스서비스명
자원 유형자원 유형
SRNSamsung Cloud Platform에서의 고유 자원 ID
  • ServiceWatch에서는 자원 유형의 SRN을 의미
자원명자원 이름
  • ServiceWatch에서는 경보 정책의 이름을 의미
자원 ID서비스에서의 고유 자원 ID
생성자서비스를 생성한 사용자
생성 일시서비스를 생성한 일시
수정자서비스 정보를 수정한 사용자
수정 일시서비스 정보를 수정한 일시
경보 정책명경보 정책의 이름
네임 스페이스지표의 네임 스페이스
지표명지표 이름
평가 범위경보 평가를 위한 시간 범위
단위지표 데이터의 단위
평가 횟수경보 정책 평가 횟수
위반 횟수경보 정책 위반 횟수
통계평가 범위 동안 지표 데이터를 계산하는 방식
평가 간격평가 간격: 평가 범위(단위) x 평가 횟수
조건설정한 조건 연산자임곗값에 따른 경보 상태(Alert) 변경 조건
경보 단계경보 발생 시 경보 단계
대상 지표 정보 영역경보 정책 대상 지표의 설명과 자원 ID, 자원명
표. 경보 정책 상세 - 상세 정보 탭 항목

알림

경보 정책 목록 페이지에서 선택한 경보 정책의 알림 수신자를 확인할 수 있습니다.

구분상세 설명
알림 수신자 목록사용자 ID, 생성 일시, 마지막 로그인, 상태 정보
  • 더보기 버튼을 클릭하여 해당 사용자에 대한 알림의 상태(활성화/비활성화)를 변경하거나 사용자 삭제 가능
삭제알림 수신자 목록에서 선택한 사용자를 모두 삭제
  • 알림 수신자 목록에서 삭제할 사용자를 체크하면 활성화
더보기알림 수신자 목록에서 선택한 사용자에 대한 알림 상태를 변경(활성화/비활성화)
  • 알림 수신자 목록에서 상태를 변경할 사용자를 체크하면 활성화
알림 수신자 추가새로운 알림 수신자 추가 가능
  • 알림 수신자 추가 팝업창에서 추가할 사용자 선택
표. 경보 정책 상세 - 알림 탭 항목
참고
  • 로그인 이력이 있는 사용자(이메일, 휴대전화 번호 등록 사용자)만 알림 수신자로 추가할 수 있습니다.
  • 알림 수신자는 최대 100명까지 추가할 수 있습니다.
  • 추가하려는 사용자가 없는 경우, IAM 서비스의 사용자 생성 페이지에서 사용자를 생성할 수 있습니다. 사용자 생성에 대한 자세한 내용은 사용자 생성하기를 참고하세요.
  • 알림 수신 방식(E-mail 또는 SMS)은 알림 설정 페이지에서 알림 대상을 서비스 > 경보로 선택한 후, 변경할 수 있습니다. 알림 설정에 대한 자세한 내용은 알림 설정 확인하기를 참고하세요.
참고
Auto-Scaling Group과 연계된 경보 정책은 알림 수신자 추가할 수 없습니다.

경보 이력

경보 정책 목록 페이지에서 선택한 경보 정책의 경보 상태 변경 이력을 확인할 수 있습니다.

구분상세 설명
경보 이력 목록경보 상태 변경 일시, 변경 상태 구분 정보, 경보 설명
  • 상세 보기를 클릭하여 해당 경보 이력의 상세 정보와 JSON 형식의 소스 코드를 확인 가능
상세 보기경보 이력 상세 정보와 JSON 형식의 소스 코드를 확인 가능
  • 경보 이력 목록에서 상세 정보를 확인할 경보를 1개 선택한 경우에만 활성화
표. 경보 정책 상세 - 경보 이력 탭 항목

태그

경보 정책 목록 페이지에서 선택한 경보 정책의 태그 정보를 확인하고, 추가하거나 변경 또는 삭제할 수 있습니다.

구분상세 설명
태그 목록태그의 Key, Value 정보
태그 수정기존 태그 정보를 수정, 삭제하거나 새로운 태그 추가 가능
  • 태그는 자원 당 최대 50개까지 추가 가능
  • 태그 추가 시 Key와 Value값을 입력하면 기존에 생성된 태그의 Key와 Value 목록에서 선택 가능
표. 경보 정책 상세 - 태그 탭 항목

작업 이력

경보 정책 목록 페이지에서 선택한 경보 정책의 작업 이력을 확인할 수 있습니다.

구분상세 설명
작업 이력 목록자원 변경 이력
  • 작업 내역, 작업 일시, 자원 유형, 자원명, 작업 결과, 작업자 정보 확인 가능
    • 설정 버튼을 클릭하여 정보 항목 변경 가능
  • 기간 선택, 사용자 시간대, 작업자 정보 입력, 상세 검색을 이용하여 필터링 가능
  • 작업 이력 목록에서 작업 내역을 클릭하면 해당 작업의 활동 내역 상세 페이지로 이동
표. 경보 정책 상세 - 작업 이력 탭 항목

경보 정책 수정하기

경보 정책의 대상 지표와 정책 설정을 수정할 수 있습니다.
경보 정책을 수정하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 경보 > 경보 정책 메뉴를 클릭하세요. 경보 정책 목록 페이지로 이동합니다.
  3. 경보 정책 목록 페이지에서 상세 정보를 확인할 경보 정책명을 클릭하세요. 경보 정책 상세 페이지로 이동합니다.
  4. 경보 정책 상세 페이지의 상세 정보 탭에서 지표 정보수정 버튼을 클릭하세요. 지표 정보 수정 팝업창이 열립니다.
  5. 지표 정보 및 정책 설정을 수정한 후, 확인 버튼을 클릭하세요. 지표 수정을 알리는 팝업창이 열립니다.
  6. 확인 버튼을 클릭하세요. 경보 정책 수정이 완료됩니다.
참고
Auto-Scaling Group과 연계된 경보 정책은 Auto-Scaling Group을 통해서 수정할 수 있습니다.

경보 정책 비활성화하기

경보 정책을 비활성화하여 경보 상태 변경에 따른 알림 발송을 중단할 수 있습니다. 경보 정책을 비활성화해도 경보 평가는 진행되며, 경보 상태가 변경됨에 따라 경보 이력도 쌓입니다. 하지만 알림은 발송하지 않습니다.

특정 기간 동안 알림 수신을 막고자 한다면 해당 경보 정책을 비활성화할 수 있습니다.

경보 정책을 비활성화하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 경보 > 경보 정책 메뉴를 클릭하세요. 경보 정책 목록 페이지로 이동합니다.
  3. 경보 정책 상세 페이지에서 비활성화 버튼을 클릭하세요. 경보 정책 비활성화 알림 팝업창이 열립니다.
  4. 확인 버튼을 클릭하세요. 경보 정책의 상태를 확인하세요.
참고
Auto-Scaling Group과 연계된 경보 정책은 활성화 또는 비활성화할 수 없습니다.

경보 정책 활성화하기

경보 정책을 활성화하여 경보 상태 변경에 따른 알림 발송을 재개할 수 있습니다. 경보 정책을 활성화하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 경보 > 경보 정책 메뉴를 클릭하세요. 경보 정책 목록 페이지로 이동합니다.
  3. 경보 정책 상세 페이지에서 활성화 버튼을 클릭하세요. 경보 정책 활성화 알림 팝업창이 열립니다.
  4. 확인 버튼을 클릭하세요. 경보 정책의 상태를 확인하세요.
참고
Auto-Scaling Group과 연계된 경보 정책은 활성화 또는 비활성화할 수 없습니다.

경보 정책 삭제하기

사용하지 않는 경보 정책을 삭제할 수 있습니다.
경보 정책을 삭제하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 경보 > 경보 정책 메뉴를 클릭하세요. 경보 정책 목록 페이지로 이동합니다.
  3. 경보 정책 목록 페이지에서 삭제할 경보 정책의 체크박스를 선택한 후, 삭제 버튼을 클릭하세요. 경보 정책 삭제를 알리는 팝업창이 열립니다.
    • 여러 개의 경보 정책을 동시에 삭제할 수 있습니다.
    • 각 경보 정책의 우측 끝에 있는 삭제 버튼을 클릭하거나 해당 경보 정책 상세 페이지의 경보 정책 삭제 버튼을 클릭하여 개별적으로 삭제할 수도 있습니다.
  4. 확인 버튼을 클릭하세요. 경보 정책이 삭제됩니다.
참고
Auto-Scaling Group과 연계된 경보 정책은 Auto-Scaling Group을 통해서 삭제할 수 있습니다.
참고
경보 정책 삭제는 규모에 따라 수십 분이상 걸릴 수 있습니다.

3 - 지표

사용자는 Samsung Cloud Platform Console의 서비스 자원에 대한 지표를 모니터링하고 관리에 사용할 수 있습니다.

지표 확인하기

ServiceWatch에서 이용 가능한 지표를 확인할 수 있습니다.
지표를 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 지표 메뉴를 클릭하세요. 지표 페이지로 이동합니다.
  3. 지표 페이지의 지표 목록에서 지표를 확인하세요.
구분상세 설명
지표 비교 모드지표를 비교하는 방식을 선택
  • 지표 비교: 다중 지표 및 자원을 비교
  • 날짜 비교: 하나의 지표 및 자원을 다중 기간으로 비교
    • 하나의 지표만 선택 가능
지표 구분ServiceWatch에서 모니터링 가능한 지표를 전체 또는 주요 지표로 구분하여 필터링하여 지표 목록에 표시
지표 목록 영역ServiceWatch에서 모니터링 가능한 지표 목록
  • 네임 스페이스, 차원 앞의 + 버튼을 클릭하여 하위 단계 목록 확인 가능
  • 지표를 선택하여 모니터링 가능
  • 해당 지표가 네임스페이스와 연결되어 있는 경우, 서비스 대시보드 표시
    • 서비스 대시보드 클릭 시 해당 대시보드의 상세 페이지로 이동
검색 필터 영역필터링할 검색 항목을 설정한 후, 필터 적용 버튼을 클릭하여 지표 목록을 필터링
  • 네임 스페이스-차원명: 선택한 네임스페이스의 하위 차원명 기준으로 검색
  • 지표명: 정확한 지표명을 입력하여 검색
  • 자원명: 정확한 자원명을 입력하여 검색
  • 자원 ID: 정확한 자원 ID를 입력하여 검색
  • 키워드: 선택한 상위 분류와 입력한 키워드를 기준으로 검색
    • 지표명, 자원명, 자원ID, 태그-Key를 제외한 항목별 검색 진행
  • 태그 Key: 선택한 태그 Key로 검색
선택된 지표지표 목록에서 선택한 지표의 모니터링 정보를 표시
표. 지표 목록 항목

지표 차트 관리하기

지표 모니터링 결과 차트를 위젯으로 추가하거나 데이터를 관리할 수 있습니다.

위젯으로 추가하기

선택한 지표를 대시보드에 위젯으로 추가할 수 있습니다.

안내
지표 비교 모드를 지표 비교로 선택한 경우에만 위젯으로 추가할 수 있습니다.

지표를 위젯으로 추가하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 지표 메뉴를 클릭하세요. 지표 페이지로 이동합니다.

  3. 지표 페이지의 지표 목록에서 모니터링할 지표를 선택하세요. 선택한 지표에 대한 모니터링 차트가 하단의 선택된 지표 영역에 표시됩니다.

  4. 선택된 지표 영역의 모니터링 차트에서 표 영역을 설정한 후, 더보기 > 위젯 추가 버튼을 클릭하세요. 위젯 추가 팝업창이 열립니다.

  5. 위젯 추가 방법을 선택한 후 필수 정보를 입력하세요. 추가 방법에 따라 필수 정보가 달라집니다.

    구분
    필수 여부
    상세 설명
    복제 방법필수위젯을 복제한 후, 추가할 대시보드를 선택
    • 기존 대시보드: 기존 대시보드에 위젯을 추가
    • 신규 대시보드: 새로운 대시보드를 생성하여 위젯을 추가
    대시보드 선택필수기존에 생성된 대시보드 중 복제한 위젯을 추가할 대시보드를 선택
    • 복제 방법을 기존 대시보드로 선택 시 표시
    대시보드명필수새로 생성할 대시보드의 이름을 입력
    • 복제 방법을 신규 대시보드로 선택 시 표시
    • 영문, 숫자, 특수 문자(-_)를 사용하여 3 ~ 40자 이내로 입력
    위젯명필수위젯을 대시보드에 추가할 때 위젯의 이름을 입력
    • 영문, 숫자, 특수 문자(-_.|)를 사용하여 3 ~ 255자 이내로 입력
    표. 위젯 추가 항목

  6. 필수 정보 입력이 끝나면 완료 버튼을 클릭하세요. 위젯 추가를 알리는 팝업창이 열립니다.

  7. 팝업창의 확인 버튼을 클릭하세요. 해당 대시보드에 위젯이 추가됩니다.

모니터링 차트 URL 공유하기

모니터링 차트 정보를 파일 형태로 다운로드할 수 있습니다.
모니터링 차트 정보를 다운로드하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 지표 메뉴를 클릭하세요. 지표 페이지로 이동합니다.
  3. 지표 페이지의 지표 목록에서 모니터링할 지표를 선택하세요. 선택한 지표에 대한 모니터링 차트가 하단의 선택된 지표 영역에 표시됩니다.
  4. 선택된 지표 영역의 모니터링 차트에서 표 영역을 설정한 후, 더보기 > URL 공유 버튼을 클릭하세요. URL 공유 팝업창이 열립니다.
  5. URL 공유 팝업창에서 URL 복사 버튼을 클릭하세요. 생성된 URL이 복사됩니다.
    • 모니터링 차트 내 정보는 메타 데이터 링크 형태로 제공됩니다.

모니터링 차트 파일 다운로드하기

모니터링 차트 정보를 파일 형태로 다운로드할 수 있습니다.
모니터링 차트 정보를 다운로드하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 지표 메뉴를 클릭하세요. 지표 페이지로 이동합니다.
  3. 지표 페이지의 지표 목록에서 모니터링할 지표를 선택하세요. 선택한 지표에 대한 모니터링 차트가 하단의 선택된 지표 영역에 표시됩니다.
  4. 선택된 지표 영역의 모니터링 차트에서 표 영역을 설정한 후, 더보기 > 파일 다운로드 버튼을 클릭하세요. 파일 다운로드 팝업창이 열립니다.
  5. 파일 다운로드 방식을 선택한 후, 확인 버튼을 클릭하세요. 다운로드가 시작됩니다.
    • 다운로드 방식은 동시에 선택할 수 있습니다.
      구분상세 설명
      CSV차트의 지표와 모니터링 데이터를 엑셀(*.csv) 파일로 변환하여 다운로드
      PNG차트를 이미지(*.png) 파일로 변환하여 다운로드
      • 지표 비교 모드를 지표 비교로 선택한 경우에만 선택 가능
      • 최대 100개의 지표 데이터 다운로드 가능
      표. 지표 모니터링 파일 다운로드 항목

Object Storage로 내보내기

모니터링 차트 데이터를 Object Storage에 저장할 수 있습니다.

안내

Object Storage에 저장하려면 사용자 권한이 필요합니다.

  • User: {email}
  • Action: iam:CreatGroup
  • On resource: {SRN}
  • Context: no identity-based policy allows the action

모니터링 차트 데이터를 Object Storage에 저장하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 지표 메뉴를 클릭하세요. 지표 페이지로 이동합니다.
  3. 지표 페이지의 지표 목록에서 모니터링할 지표를 선택하세요. 선택한 지표에 대한 모니터링 차트가 하단의 선택된 지표 영역에 표시됩니다.
  4. 선택된 지표 영역의 모니터링 차트에서 표 영역을 설정한 후, 더보기 > Object Storage 내보내기 버튼을 클릭하세요. Object Storage 내보내기 팝업창이 열립니다.
  5. 데이터를 저장할 버킷을 선택한 후, 완료 버튼을 클릭하세요. 데이터 저장을 알리는 팝업창이 열립니다.
  6. 팝업창에서 확인 버튼을 클릭하세요. 데이터 내보내기가 시작됩니다.
안내
  • Object Stroage로 내보낼 수 있는 지표의 제한 사항은 다음과 같습니다.
    • 지표 개수: 10개 이내
    • 조회 기간: 2개월(63일) 이내
  • 조회 기간이 2개월(63일)을 초과한 경우, 최대 63일 동안의 데이터만 저장됩니다.
참고
  • 지표 데이터를 저장할 Object Storage가 없을 경우, Object Storage를 생성한 후, 진행하세요.
  • 지표 데이터는 “지표명-yyyymmddhhmmss.json” 파일 형식으로 저장되며 Object Storage 버킷의 ~/servicewatch/metric 경로에서 확인할 수 있습니다.

모니터링 차트 소스 보기

모니터링 차트의 소스 코드를 확인할 수 있습니다.

안내
지표 비교 모드를 지표 비교로 선택한 경우에만 소스 코드를 확인할 수 있습니다.

모니터링 차트의 소스 코드를 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 지표 메뉴를 클릭하세요. 지표 페이지로 이동합니다.
  3. 지표 페이지의 지표 목록에서 모니터링할 지표를 선택하세요. 선택한 지표에 대한 모니터링 차트가 하단의 선택된 지표 영역에 표시됩니다.
  4. 선택된 지표 영역의 모니터링 차트에서 표 영역을 설정한 후, 더보기 > 소스 보기 버튼을 클릭하세요. 위젯 소스 보기 팝업창이 열립니다.
    구분상세 설명
    소스 정보모니터링 차트의 소스 코드를 JSON 형식으로 표시
    코드 복사소스 코드를 클립보드에 복사
    표. 모니터링 차트 소스 보기 항목

4 - 로그

ServiceWatch에서 모니터링할 지표에 임곗값 기준을 설정하여 설정한 조건에 충족될 경우, 경보 알림을 발생하도록 로그 그룹을 생성하고 관리할 수 있습니다.

로그 그룹 생성하기

지표에 대한 로그 그룹을 생성할 수 있습니다.
로그 그룹을 생성하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 로그 > 로그 그룹 메뉴를 클릭하세요. 로그 그룹 목록 페이지로 이동합니다.

  3. 로그 그룹 목록 페이지에서 로그 그룹 생성 버튼을 클릭하세요. 로그 그룹 생성 페이지로 이동합니다.

  4. 로그 그룹 생성에 필요한 기본 정보와 태그 정보를 입력하세요.

    구분
    필수 여부
    상세 설명
    로그 그룹명필수ServiceWatch에서 모니터링할 로그 그룹의 이름을 입력
    • 영문, 숫자, 특수 문자(-_./#)를 사용하여 3 ~ 512자 이내로 입력
    로그 보관 정책필수모니터링한 로그 데이터를 보관할 기간 선택
    태그선택태그 정보 추가
    • 태그는 자원 당 최대 50개까지 추가 가능
    • 태그 추가 시 Key와 Value값을 입력하면 기존에 생성된 태그의 Key와 Value 목록에서 선택 가능
    표. 로그 그룹 생성 항목

  5. 요약 정보를 확인한 후, 생성 버튼을 클릭하세요. 로그 그룹 생성을 알리는 팝업창이 열립니다.

  6. 확인 버튼을 클릭하세요. 로그 그룹 생성이 완료됩니다.

로그 그룹 상세 정보 확인하기

로그 그룹에 대한 상세 정보를 확인하고 관리할 수 있습니다.

로그 그룹에 대한 상세 정보를 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 로그 > 로그 그룹 메뉴를 클릭하세요. 로그 그룹 목록 페이지로 이동합니다.
  3. 로그 그룹 목록 페이지에서 상세 정보를 확인할 로그 그룹명을 클릭하세요. 로그 그룹 상세 페이지로 이동합니다.
    구분상세 설명
    로그 그룹 상태로그 그룹의 상태
    • Active: 로그 그룹이 활성화된 상태
    • Inactive: 로그 그룹이 비활성화된 상태
    로그 그룹 내보내기로그 그룹의 로그 데이터를 Object Storage에 저장
    로그 그룹 삭제해당하는 로그 그룹을 삭제
    정보 구분 탭로그 그룹에 대한 정보 구분 탭
    • 상세 정보, 로그 스트림, 태그, 작업 이력
    • 각 탭을 클릭하면 해당 정보 확인 가능
    표. 로그 그룹 상세 항목
    참고
    로그 그룹 목록 페이지에서 Object Storage에 저장할 로그 그룹의 더보기 > 로그 그룹 내보내기 버튼을 클릭하여 데이터를 내보낼 수 있습니다.
참고

로그 그룹 목록에서 로그 그룹명 정렬할때, 아래의 정렬 규칙을 따릅니다.

  1. 공백 및 제어문자
  2. 일부 특수문자 ( !"#$%&()*+,-./ )
  3. 숫자 (0–9)
  4. 일부 특수문자 ( ; < = > ? @ )
  5. 영어 (A–Z, a–z, 대소문자 구분 없음)
  6. 나머지 특수문자 ([\]^_`)
  7. 기타 문자

상세 정보

로그 그룹 목록 페이지에서 선택한 로그 그룹의 기본 정보와 로그 그룹 정보를 확인할 수 있습니다.

구분상세 설명
서비스서비스명
자원 유형자원 유형
SRNSamsung Cloud Platform에서의 고유 자원 ID
  • ServiceWatch에서는 자원 유형의 SRN을 의미
자원명자원 이름
  • ServiceWatch에서는 로그 그룹의 이름을 의미
자원 ID서비스에서의 고유 자원 ID
생성자서비스를 생성한 사용자
생성 일시서비스를 생성한 일시
수정자서비스 정보를 수정한 사용자
수정 일시서비스 정보를 수정한 일시
로그 그룹명로그 그룹의 이름
로그 보관 정책로그 데이터의 보관 기간
  • 수정 버튼을 클릭하여 보관 기간 변경 가능
로그 데이터저장된 총 로그 데이터 용량(bytes)
표. 로그 그룹 상세 - 상세 정보 탭 항목
참고
로그 데이터는 저장된 총 로그 데이터(bytes)입니다. 로그 집계 용량이 반영되기까지 시간이 소요될 수 있습니다.

로그 스트림

로그 그룹 목록 페이지에서 선택한 로그 그룹의 로그 스트림을 확인할 수 있습니다.

구분상세 설명
모든 스트림 조회로그 스트림 목록의 모든 로그 스트림에 대한 상세 정보 확인 가능
로그 스트림 생성새로운 로그 스트림을 생성
로그 스트림 목록로그 스트림명과 로그 변경 일시
  • 삭제 버튼을 클릭하여 해당 로그 스트림을 삭제 가능
  • 삭제할 로그 스트림을 체크한 후, 목록 상단의 더보기 > 삭제 버튼을 클릭하여 동시에 삭제 가능
표. 로그 그룹 상세 - 로그 스트림 탭 항목

로그 패턴

로그 그룹 목록 페이지에서 선택한 로그 그룹의 로그 패턴을 확인할 수 있습니다.

구분상세 설명
로그 패턴 목록로그 패턴명, 패턴, 로그 패턴 네임 스페이스, 지표명, 경보 정책명 정보
  • 로그 패턴명, 경보 정책명을 클릭하면 해당 항목의 상세 페이지로 이동
  • 지표명을 클릭하면 해당 지표명이 검색어에 포함된 지표 페이지로 이동
  • 경보 정책명을 클릭하면 해당 경보 정책의 상세 페이지로 이동
  • 더보기 버튼을 클릭하여 추가 작업 진행 가능
    • 수정, 삭제: 해당 로그 패턴을 수정하거나 삭제
    • 경보 정책 생성: 경보 정책 생성 페이지로 이동
삭제로그 패턴 목록에서 선택한 로그 패턴을 모두 삭제
  • 로그 패턴 목록에서 로그 패턴을 체크하면 활성화
로그 패턴 생성새로운 로그 패턴을 생성
표. 로그 그룹 상세 - 로그 패턴 탭 항목

태그

로그 그룹 목록 페이지에서 선택한 로그 그룹의 태그 정보를 확인하고, 추가하거나 변경 또는 삭제할 수 있습니다.

구분상세 설명
태그 목록태그의 Key, Value 정보
태그 수정기존 태그 정보를 수정, 삭제하거나 새로운 태그 추가 가능
  • 태그는 자원 당 최대 50개까지 추가 가능
  • 태그 추가 시 Key와 Value값을 입력하면 기존에 생성된 태그의 Key와 Value 목록에서 선택 가능
표. 로그 그룹 상세 - 태그 탭 항목

작업 이력

로그 그룹 목록 페이지에서 선택한 로그 그룹의 작업 이력을 확인할 수 있습니다.

구분상세 설명
작업 이력 목록자원 변경 이력
  • 작업 내역, 작업 일시, 자원 유형, 자원명, 작업 결과, 작업자 정보 확인 가능
    • 설정 버튼을 클릭하여 정보 항목 변경 가능
  • 기간 선택, 사용자 시간대, 작업자 정보 입력, 상세 검색을 이용하여 필터링 가능
  • 작업 이력 목록에서 작업 내역을 클릭하면 해당 작업의 활동 내역 상세 페이지로 이동
표. 로그 그룹 상세 - 작업 이력 탭 항목

로그 스트림 관리하기

로그 스트림을 생성하고 관리할 수 있습니다.

로그 스트림 생성하기

로그 그룹에 새로운 로그 스트림을 생성할 수 있습니다.
호그 스트림을 생성하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 로그 > 로그 그룹 메뉴를 클릭하세요. 로그 그룹 목록 페이지로 이동합니다.
  3. 로그 그룹 목록 페이지에서 로그 스트림을 생성할 로그 그룹명을 클릭하세요. 로그 그룹 상세 페이지로 이동합니다.
  4. 로그 그룹 상세 페이지에서 로그 스트림 탭을 클릭하세요. 로그 스트림 목록이 표시됩니다.
  5. 로그 스트림 생성 버튼을 클릭하세요. 로그 스트림 생성 팝업창이 열립니다.
  6. 로그 스트림명을 입력한 후, 생성 버튼을 클릭하세요. 로그 스트림 생성이 완료됩니다.
    • 이름은 영문, 숫자를 사용하여 3 ~ 512자 이내로 입력하세요.

로그 스트림 상세 정보 확인하기

로그 스트림에 대한 상세 정보를 확인하고 관리할 수 있습니다.
로그 스트림에 대한 상세 정보를 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 로그 > 로그 그룹 메뉴를 클릭하세요. 로그 그룹 목록 페이지로 이동합니다.
  3. 로그 그룹 목록 페이지에서 상세 정보를 확인할 로그 그룹명을 클릭하세요. 로그 그룹 상세 페이지로 이동합니다.
  4. 로그 그룹 상세 페이지에서 로그 스트림 탭을 클릭하세요. 로그 스트림 목록이 표시됩니다.
  5. 로그 스트림 목록에서 상세 정보를 확인할 로그 스트림명을 클릭하세요. 로그 스트림 상세 페이지로 이동합니다.
    구분상세 설명
    엑셀 다운로드로그 스트림 내역을 엑셀 파일로 다운로드 가능
    타임 스탬프 목록타임 스탬프별 메시지 목록
    • 기간 선택, 사용자 시간대, 메시지 입력을 이용하여 필터링 가능
    표. 로그 그룹 상세 - 로그 스트림 상세 항목
    참고
    로그 스트림 목록 상단의 모든 로그 스트림 조회 버튼을 클릭하면 모든 로그 스트림 상세 페이지로 이동합니다.

로그 스트림 삭제하기

사용하지 않는 로그 스트림을 삭제할 수 있습니다.
로그 스트림을 삭제하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 로그 > 로그 그룹 메뉴를 클릭하세요. 로그 그룹 목록 페이지로 이동합니다.
  3. 로그 그룹 목록 페이지에서 로그 스트림을 삭제할 로그 그룹명을 클릭하세요. 로그 그룹 상세 페이지로 이동합니다.
  4. 로그 그룹 상세 페이지에서 로그 스트림 탭을 클릭하세요. 로그 스트림 목록이 표시됩니다.
  5. 로그 스트림 목록에서 삭제할 로그 스트림의 체크박스를 선택한 후, 더보기 > 삭제 버튼을 클릭하세요. 로그 스트림 삭제를 알리는 팝업창이 열립니다.
    • 여러 개의 로그 스트림을 동시에 삭제할 수 있습니다.
    • 각 로그 스트림의 우측 끝에 있는 삭제 버튼을 클릭하여 개별적으로 삭제할 수도 있습니다.
  6. 확인 버튼을 클릭하세요. 로그 스트림이 삭제됩니다.

로그 패턴 관리하기

로그 패턴 생성하기

로그 패턴을 생성하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 로그 > 로그 그룹 메뉴를 클릭하세요. 로그 그룹 목록 페이지로 이동합니다.

  3. 로그 그룹 목록 페이지에서 로그 패턴을 생성할 로그 그룹명을 클릭하세요. 로그 그룹 상세 페이지로 이동합니다.

  4. 로그 그룹 상세 페이지에서 로그 패턴 탭을 클릭하세요. 로그 패턴 목록이 표시됩니다.

  5. 로그 패턴 생성 버튼을 클릭하세요. 로그 패턴 생성 페이지로 이동합니다.

  6. 로그 그룹 생성에 필요한 기본 정보와 지표 정보를 설정하세요.

    • 기본 정보 영역에 로그 패턴에 대한 기본 정보를 입력 및 선택하세요.
      구분
      필수 여부
      상세 설명
      로그 패턴명필수로그 패턴의 이름을 입력
      • 영문, 숫자, 특수 문자(-_./#)를 사용하여 3 ~ 512자 이내로 입력
      패턴 형식필수패턴 형식을 선택하거나 직접 입력
      • 패턴 형식: 패턴 형식으로 제공되는 문자열 패턴, 공백 구분 패턴, JSON 형식 패턴 중 1개를 서택
      • 직접 입력: 문자열 패턴, 공백 구분 패턴, JSON 형식 패턴 중 1개를 선택한 후, 1 ~ 1,024 이내로 입력
      패턴 테스트선택패턴을 사용하여 확인할 로그 데이터를 직접 입력하거나 선택
      • 직접 입력: 사용할 로그 데이터를 로그 이벤트 메시지에 직접 입력
        • 줄 바꿈을 사용하여 로그 이벤트를 구분
        • 로그 이벤트는 최대 50개까지 입력 가능
        • 1개의 로그 이벤트에 1 ~ 1,024 byte 이내로 입력 가능
      • 로그 데이터 선택: 사용할 로그 데이터를 선택
        • 로그 데이터 선택 시 해당하는 로그 데이터가 로그 이벤트 메시지에 표시
      • 패턴 테스트: 로그 이벤트 메시지에 대한 테스트 진행
        • 테스트 성공 시 하단에 테스트 결과 표시
      표. 로그 패턴 생성 - 기본 정보 항목
    • 지표 정보 영역에 지표 정보를 입력 및 선택하세요.
      구분
      필수 여부
      상세 설명
      네임스페이스필수로그 패턴을 위한 네임스페이스를 선택
      • 로그 패턴을 위한 네임스페이스가 없는 경우, 신규 생성을 선택하여 새로 생성
      • 네임스페이스명: 네임스페이스 신규 생성 시 영문, 숫자, 공백, 특수 문자(-_\/#)를 사용하여 3 ~ 128자 이내로 입력
      지표명필수지표의 이름을 입력
      • 영문, 숫자, 특수 문자(_)를 사용하여 3 ~ 128자 이내로 입력
      지표값필수지표값을 입력
      • 0 이상의 숫자 또는 $indetifier 입력
      기본값선택기본값을 사용할 경우, 입력
      • 0 이상의 float값으로 입력
      • 기본값 사용 시 차원 사용 불가
      단위필수지표 단위를 선택
      차원선택로그 패턴으로 생성되는 지표의 차원을 설정
      • 로그 패턴 형식이 공백 구분 패턴, JSON 형식 패턴인 경우에만 사용 가능
      • 기본값 입력 시 사용 불가
      • 사용을 체크하면 사용자 지정 차원 필드를 추가 가능
        • 추가 버튼을 클릭한 후, 필드명필드값 입력하여 추가
        • 최대 3개까지 추가 가능
      표. 로그 패턴 생성 - 지표 정보 항목
  7. 요약 정보를 확인한 후, 생성 버튼을 클릭하세요. 로그 패턴 생성을 알리는 팝업창이 열립니다.

  8. 확인 버튼을 클릭하세요. 로그 패턴 생성이 완료됩니다.

로그 패턴 상세 정보 확인하기

로그 패턴의 상세 정보를 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 로그 > 로그 그룹 메뉴를 클릭하세요. 로그 그룹 목록 페이지로 이동합니다.
  3. 로그 그룹 목록 페이지에서 상세 정보를 확인할 로그 그룹명을 클릭하세요. 로그 그룹 상세 페이지로 이동합니다.
  4. 로그 그룹 상세 페이지에서 로그 패턴 탭을 클릭하세요. 로그 패턴 목록이 표시됩니다.
  5. 로그 패턴 목록에서 상세 정보를 확인할 로그 패턴명을 클릭하세요. 로그 패턴 상세 페이지로 이동합니다.
    구분상세 설명
    경보 정책 생성경보 정책 생성 가능
    • 버튼 클릭 시 경보 정책 생성 페이지로 이동
    로그 패턴 삭제현재 확인 중인 로그 패턴 삭제
    로그 패턴명로그 패턴 이름
    생성자로그 패턴을 생성한 사용자
    생성 일시로그 패턴을 생성한 일시
    수정자로그 패턴 정보를 수정한 사용자
    수정 일시로그 패턴 정보를 수정한 일시
    패턴패턴 형식
    지표 정보패턴 그룹의 지표 정보
    • 네임스페이스명, 지표명, 지표값, 기본값, 단위, 경보 정책명, 차원명
    • 수정 버튼을 지표값, 기본값, 단위 정보 수정 가능
    표. 로그 패턴 상세 항목

로그 패턴 삭제하기

로그 패턴을 삭제하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 로그 > 로그 그룹 메뉴를 클릭하세요. 로그 그룹 목록 페이지로 이동합니다.
  3. 로그 그룹 목록 페이지에서 로그 패턴을 삭제할 로그 그룹명을 클릭하세요. 로그 그룹 상세 페이지로 이동합니다.
  4. 로그 그룹 상세 페이지에서 로그 패턴 탭을 클릭하세요. 로그 패턴 목록이 표시됩니다.
  5. 로그 패턴 목록에서 삭제할 로그 패턴의 체크박스를 선택한 후, 삭제 버튼을 클릭하세요. 로그 패턴 삭제를 알리는 팝업창이 열립니다.
    • 여러 개의 로그 패턴을 동시에 삭제할 수 있습니다.
    • 각 로그 패턴의 우측 끝에 있는 더보기 > 삭제 버튼을 클릭하거나 로그 패턴의 상세 페이지에서 로그 패턴 삭제 버튼을 클릭하여 개별적으로 삭제할 수도 있습니다.
  6. 확인 버튼을 클릭하세요. 로그 패턴이 삭제됩니다.

로그 그룹 내보내기

로그 그룹 데이터를 Object Storage에 저장할 수 있습니다.
로그 그룹 데이터를 Object Storage에 저장하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 로그 > 로그 그룹 내보내기 메뉴를 클릭하세요. 로그 그룹 내보내기 목록 페이지로 이동합니다.

  3. 로그 그룹 내보내기 목록 페이지에서 로그 그룹 내보내기 버튼을 클릭하세요. 로그 그룹 내보내기 페이지로 이동합니다.

    구분
    필수 여부
    상세 설명
    로그 그룹 선택필수Object Storage에 저장할 로그 그룹을 선택
    • 로그 그룹에 포함된 로그 스트림이 있는 경우, 선택 버튼을 클릭하여 저장할 로그 스트림을 선택 가능
    • 로그 그룹을 선택하지 않을 경우, 로그 그룹의 전체 데이터를 저장
    기간 선택선택사용자 시간대와 데이터 저장 구간을 선택
    • 데이터 저장 구간은 시간 설정 영역에서 원하는 구간을 선택하거나 직접 입력 버튼을 클릭하여 시작과 종료 일시를 설정 가능
    저장 버킷필수데이터를 저장할 버킷을 선택
    • 태그는 자원 당 최대 50개까지 추가 가능
    • 태그 추가 시 Key와 Value값을 입력하면 기존에 생성된 태그의 Key와 Value 목록에서 선택 가능
    표. 로그 그룹 내보내기 항목

  4. 데이터를 저장할 버킷을 선택한 후, 완료 버튼을 클릭하세요. 데이터 저장을 알리는 팝업창이 열립니다.

  5. 팝업창에서 확인 버튼을 클릭하세요. 데이터 내보내기가 시작됩니다.

    • 진행 사항은 로그 그룹 내보내기 목록 페이지에서 확인할 수 있습니다.
참고
  • 로그 그룹 데이터를 저장할 Object Storage가 없을 경우, Object Storage를 생성한 후, 진행하세요.
  • 로그 그룹 데이터 내보내기는 규모에 따라 수십 분이상 걸릴 수 있습니다.
  • Account 내에 진행 중인 로그 그룹 내보내기 작업이 있는 경우에는 먼저 진행 중인 작업을 완료한 후, 내보내기를 진행할 수 있습니다.
  • 로그 그룹 내보내기 목록 페이지에서 내보내기 작업이 진행 중인 로그 그룹의 더보기 > 로그 그룹 내보내기 취소 버튼을 클릭하여 작업을 취소할 수 있습니다.

로그 그룹 삭제하기

사용하지 않는 로그 그룹을 삭제할 수 있습니다.

주의
  • 로그 그룹 내보내기으로 Object Storage에 저장된 파일은 삭제되지 않습니다. 단, 로그 그룹 내보내기 이력은 함께 삭제됩니다.
  • 로그 그룹 내보내기를 진행 중인 로그 그룹을 삭제하면 내보내기 작업이 정상적으로 진행되지 않습니다.

로그 그룹을 삭제하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 로그 > 로그 그룹 메뉴를 클릭하세요. 로그 그룹 목록 페이지로 이동합니다.
  3. 로그 그룹 목록 페이지에서 삭제할 로그 그룹의 체크박스를 선택한 후, 삭제 버튼을 클릭하세요. 로그 그룹 삭제를 알리는 팝업창이 열립니다.
    • 여러 개의 로그 그룹을 동시에 삭제할 수 있습니다.
    • 각 로그 그룹의 우측 끝에 있는 삭제 버튼을 클릭하거나 해당 로그 그룹 상세 페이지의 로그 그룹 삭제 버튼을 클릭하여 개별적으로 삭제할 수도 있습니다.
  4. 확인 버튼을 클릭하세요. 로그 그룹이 삭제됩니다.

5 - 이벤트

ServiceWatch에서 Samsung Cloud Platform 서비스에서 생성된 이벤트 확인하고 처리할 수 있습니다.

이벤트 규칙 생성하기

이벤트 규칙을 생성하여 이벤트 발생 시 알림을 받을 수 있습니다.
이벤트 규칙을 생성하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 이벤트 규칙 메뉴를 클릭하세요. 이벤트 규칙 목록 페이지로 이동합니다.

  3. 이벤트 규칙 목록 페이지에서 이벤트 규칙 생성 버튼을 클릭하세요. 이벤트 규칙 생성 페이지로 이동합니다.

  4. 기본 정보 입력 영역에서 이벤트 규칙의 이름과 설명을 입력하세요.

  5. 이벤트 패턴 설정 영역에서 필수 정보를 설정하세요. 설정한 이벤트 패턴은 이벤트 패턴 설정 현황에 JSON 코드 형식으로 입력됩니다.

    구분
    필수 여부
    상세 설명
    이벤트 소스필수ServiceWatch에서 수신하고자 하는 이벤트의 서비스명 선택
    이벤트 유형필수이벤트 규칙에 사용할 이벤트 소스의 이벤트의 유형 선택
    • 자원 유형과 동일하게 분류
    적용 이벤트필수이벤트 유형에서 발생하는 이벤트 중 이벤트 패턴을 적용할 이벤트 선택
    • 모든 이벤트: 이벤트 유형에서 발생하는 모든 이벤트를 적용
    • 개별 이벤트: 이벤트 유형에서 발생하는 이벤트 중 이벤트 패턴으로 설정할 이벤트를 선택
    적용 자원필수이벤트 패턴을 적용할 자원을 선택
    • 모든 자원: 모든 자원에서 발생한 이벤트에 대하여 이벤트 패턴을 설정
    • 개별 자원: 특정 자원에서 발생한 해당 이벤트에 대해 이벤트 패턴을 설정
      • 개별 자원 선택 시 이벤트 자원 선택 영역 표시
      • 자원 추가 버튼을 클릭하여 자원 선택 가능
      • 추가한 자원은 자원 목록에서 자원을 선택한 후, 삭제 버튼을 클릭하여 삭제 가능
    이벤트 패턴 설정 현황-이벤트 패턴 설정값에 따라 JSON 코드 형식으로 변환하여 표시
    • 이벤트 패턴 설정값을 변경하면 초기화
    • 코드 복사 항목을 클릭하여 소스 코드 복사 가능
    표. 이벤트 패턴 설정 항목

  6. 알림 설정 영역에서 이벤트 발생 시 알림을 전달받을 사용자를 선택하세요.

    • 로그인 이력이 있는 사용자(이메일, 휴대전화 번호 등록 사용자)만 알림 수신자로 추가할 수 있습니다.
    • 알림 수신자는 최대 100명까지 추가할 수 있습니다.
참고
  • 추가하려는 사용자가 없는 경우, IAM 서비스의 사용자 생성 페이지에서 사용자를 생성할 수 있습니다. 사용자 생성에 대한 자세한 내용은 사용자 생성하기를 참고하세요.
  • 알림 수신 방식(E-mail 또는 SMS)은 알림 설정 페이지에서 알림 대상을 서비스 > Event Rule로 선택한 후, 변경할 수 있습니다. 알림 설정에 대한 자세한 내용은 알림 설정 확인하기를 참고하세요.
  1. 추가 정보 입력 영역에서 태그 정보를 추가하세요.
  2. 요약 정보를 확인한 후, 생성 버튼을 클릭하세요. 이벤트 규칙 생성을 알리는 팝업창이 열립니다.
  3. 확인 버튼을 클릭하세요. 이벤트 규칙 생성이 완료됩니다.

이벤트 규칙 상세 정보 확인하기

이벤트 규칙에 대한 상세 정보를 확인하고 관리할 수 있습니다.
이벤트 규칙에 대한 상세 정보를 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 이벤트 규칙 메뉴를 클릭하세요. 이벤트 규칙 목록 페이지로 이동합니다.
  3. 이벤트 규칙 목록 페이지에서 상세 정보를 확인할 이벤트명을 클릭하세요. 이벤트 규칙 상세 페이지로 이동합니다.
    구분상세 설명
    이벤트 규칙 상태이벤트 규칙의 상태
    • Active: 이벤트 규칙이 활성화된 상태
    • Inactive: 이벤트 규칙이 비활성화된 상태
    • 활성화 또는 비활성화 버튼을 클릭하여 변경 가능
    이벤트 규칙 삭제해당하는 이벤트 규칙을 삭제
    정보 구분 탭경보 정책에 대한 정보 구분 탭
    • 상세 정보, 알림, 태그, 작업 이력
    • 각 탭을 클릭하면 해당 정보 확인 가능
    표. 이벤트 규칙 상세 항목

상세 정보

이벤트 규칙 목록 페이지에서 선택한 이벤트 규칙의 기본 정보와 이벤트 규칙 정보를 확인할 수 있습니다.

구분상세 설명
서비스서비스명
자원 유형자원 유형
SRNSamsung Cloud Platform에서의 고유 자원 ID
  • ServiceWatch에서는 자원 유형의 SRN을 의미
자원명자원 이름
  • ServiceWatch에서는 이벤트 규칙의 이름을 의미
자원 ID서비스에서의 고유 자원 ID
생성자서비스를 생성한 사용자
생성 일시서비스를 생성한 일시
수정자서비스 정보를 수정한 사용자
수정 일시서비스 정보를 수정한 일시
이벤트 규칙명이벤트 규칙의 이름
이벤트 패턴 설정 현황이벤트 패턴 설정값을 JSON 코드 형식 표시
  • 코드 복사 항목을 클릭하여 소스 코드 복사 가능
설명이벤트 규칙에 대한 설명
  • 수정 버튼을 클릭하여 설명 수정 가능
표. 경보 정책 상세 - 상세 정보 탭 항목

알림

이벤트 규칙 목록 페이지에서 선택한 이벤트 규칙의 알림 수신자를 확인할 수 있습니다.

구분상세 설명
알림 수신자 목록사용자 ID, 생성 일시, 마지막 로그인, 상태 정보
  • 더보기 버튼을 클릭하여 해당 사용자에 대한 알림의 상태(활성화/비활성화)를 변경하거나 사용자 삭제 가능
삭제알림 수신자 목록에서 선택한 사용자를 모두 삭제
  • 알림 수신자 목록에서 삭제할 사용자를 체크하면 활성화
더보기알림 수신자 목록에서 선택한 사용자에 대한 알림 상태를 변경(활성화/비활성화)
  • 알림 수신자 목록에서 상태를 변경할 사용자를 체크하면 활성화
알림 수신자 추가새로운 알림 수신자 추가 가능
  • 알림 수신자 추가 팝업창에서 추가할 사용자 선택
표. 이벤트 규칙 상세 - 알림 탭 항목
참고
  • 로그인 이력이 있는 사용자(이메일, 휴대전화 번호 등록 사용자)만 알림 수신자로 추가할 수 있습니다.
  • 알림 수신자는 최대 100명까지 추가할 수 있습니다.
  • 추가하려는 사용자가 없는 경우, IAM 서비스의 사용자 생성 페이지에서 사용자를 생성할 수 있습니다. 사용자 생성에 대한 자세한 내용은 사용자 생성하기를 참고하세요.
  • 알림 수신 방식(E-mail 또는 SMS)은 알림 설정 페이지에서 알림 대상을 서비스 > Event Rule로 선택한 후, 변경할 수 있습니다. 알림 설정에 대한 자세한 내용은 알림 설정 확인하기를 참고하세요.

태그

이벤트 규칙 페이지에서 선택한 이벤트 규칙의 태그 정보를 확인하고, 추가하거나 변경 또는 삭제할 수 있습니다.

구분상세 설명
태그 목록태그의 Key, Value 정보
태그 수정기존 태그 정보를 수정, 삭제하거나 새로운 태그 추가 가능
  • 태그는 자원 당 최대 50개까지 추가 가능
  • 태그 추가 시 Key와 Value값을 입력하면 기존에 생성된 태그의 Key와 Value 목록에서 선택 가능
표. 이벤트 규칙 상세 - 태그 탭 항목

작업 이력

경보 정책 목록 페이지에서 선택한 이벤트 규칙의 작업 이력을 확인할 수 있습니다.

구분상세 설명
작업 이력 목록자원 변경 이력
  • 작업 내역, 작업 일시, 자원 유형, 자원명, 작업 결과, 작업자 정보 확인 가능
    • 설정 버튼을 클릭하여 정보 항목 변경 가능
  • 기간 선택, 사용자 시간대, 작업자 정보 입력, 상세 검색을 이용하여 필터링 가능
  • 작업 이력 목록에서 작업 내역을 클릭하면 해당 작업의 활동 내역 상세 페이지로 이동
표. 이벤트 규칙 상세 - 작업 이력 탭 항목

이벤트 패턴 수정하기

이벤트 패턴을 수정할 수 있습니다.
이벤트 패턴을 수정하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 이벤트 규칙 메뉴를 클릭하세요. 이벤트 규칙 목록 페이지로 이동합니다.
  3. 이벤트 규칙 목록 페이지에서 이벤트 패턴을 수정할 이벤트명을 클릭하세요. 이벤트 규칙 상세 페이지로 이동합니다.
  4. 이벤트 규칙 상세 페이지의 이벤트 패턴 설정 현황에 있는 수정 버튼을 클릭하세요. 이벤트 패턴 수정 팝업창이 열립니다.
  5. 이벤트 패턴 설정을 수정한 후, 확인 버튼을 클릭하세요. 이벤트 패턴 수정을 알리는 팝업창이 열립니다.
  6. 확인 버튼을 클릭하세요. 이벤트 패턴 수정이 완료됩니다.

이벤트 규칙 삭제하기

사용하지 않는 이벤트 규칙을 삭제할 수 있습니다.
이벤트 규칙을 삭제하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 이벤트 규칙 메뉴를 클릭하세요. 이벤트 규칙 목록 페이지로 이동합니다.
  3. 이벤트 규칙 목록 페이지에서 삭제할 이벤트 규칙의 체크박스를 선택한 후, 삭제 버튼을 클릭하세요. 이벤트 규칙 삭제를 알리는 팝업창이 열립니다.
    • 여러 개의 이벤트 규칙을 동시에 삭제할 수 있습니다.
    • 각 경보 정책의 우측 끝에 있는 더보기 > 삭제 버튼을 클릭하거나 해당 이벤트 규칙 상세 페이지의 이벤트 규칙 삭제 버튼을 클릭하여 개별적으로 삭제할 수도 있습니다.
  4. 확인 버튼을 클릭하세요. 이벤트 규칙이 삭제됩니다.

6 - ServiceWatch Agent 사용하기

사용자는 Virtual Server/GPU Server/Bare Metal Server 등에서 ServiceWatch Agent를 설치하여 사용자 정의 지표와 로그를 수집할 수 있습니다.

참고
ServiceWatch Agent를 통한 사용자 정의 지표/로그 수집은 현재 Samsung Cloud Platform For Enterprise에서만 사용 가능합니다. 이외 오퍼링에서도 향후 제공 예정입니다.
주의
ServiceWatch Agent를 통한 지표 수집은 사용자 정의 지표로 구분되어 각 서비스로부터 기본으로 수집되는 지표와는 달리 요금이 부과되므로, 불필요한 메트릭 수집 설정을 하지 않도록 주의해야 합니다. 반드시 수집이 필요한 지표만 수집될 수 있도록 설정하세요.

ServiceWatch Agent

서버에 ServiceWatch의 사용자 정의 지표 및 로그 수집을 위해 설치해야 하는 Agent는 크게 2가지로 나눌 수 있습니다. Prometheus Exporter와 Open Telemetry Collector 입니다.

구분상세 설명
Prometheus Exporter특정 애플리케이션이나 서비스의 메트릭을 Prometheus가 스크랩(scrape)할 수 있는 형식으로 제공
  • 서버의 OS 지표 수집을 위해서 OS 타입에 따라 Linux 서버를 위한 Node Exporter와 Windows 서버를 위한 Windows Exporter를 사용할 수 있음.
    • 대상
      • Virtual Server
      • GPU Server
      • Bare Metal Server
      • Multi-node GPU Cluster > GPU Node
  • GPU 지표를 위한 DCGM(NVIDIA Data Center GPU Manager) Exporter를 사용할 수 있음.
    • 대상
      • GPU Server
      • Multi-node GPU Cluster > GPU Node
Open Telemetry Collector분산 시스템의 메트릭, 로그와 같은 텔레메트리 데이터를 수집하고, 처리(필터링, 샘플링 등)한 후, 여러 백엔드(예: Prometheus, Jaeger, Elasticsearch 등)로 내보내는 중앙 집중식 수집기 역할
  • ServiceWatch Gateway로 데이터를 내보내어 ServiceWatch에서 지표 및 로그 데이터를 수집할 수 있도록 함.
  • 해당 가이드에서는 ServiceWatch에서 제공하는 Open Telemetry Collector 사용 방법에 대해 안내
표. Prometheus Exporter와 Open Telemetry Collector 설명
참고

ServiceWatch Agent를 통해 서버의 로그 파일을 ServiceWatch에 연계하기 위해서는 로그 그룹과 로그 그룹 내 로그 스트림을 먼저 생성해야 합니다.

  • 로그 그룹 생성 및 로그 스트림 생성에 대한 자세한 내용은 로그를 참고하세요.

ServiceWatch Agent를 위한 사전 환경 설정

ServiceWatch Agent와 ServiceWatch 간 통신을 위하여 Security Group과 Firewall 규칙을 추가해야 합니다.

참고
Bare Metal Server의 경우 Security Group을 지원하지 않습니다.
  1. Security Group 규칙 추가

    • Virtual Server/GPU Server에 설치된 ServiceWatch Agent에서 ServiceWatch로 수집된 데이터를 전송하기 위해 아래와 같이 Security Group에 규칙을 추가해야합니다.
      방향유형포트대상 주소
      Outbound사용자 지정 TCP443ServiceWatch OpenAPI Endpoint IP 주소
      표. ServiceWatch Agent 통신을 위한 Security Group 규칙
  2. Firewall 규칙 추가

    • VPC의 Internet Gateway에 방화벽을 사용으로 설정한 경우 아래와 같이 Firewall 규칙을 추가해야 합니다.
      방향유형포트동작출발지 주소목적지 주소
      OutboundTCP443AllowVirtual Server 생성 시, 할당된 Private IP 주소. Virtual Server Private IP 주소는 Virtual Server 상세 정보 확인하기에서 확인할 수 있습니다.ServiceWatch OpenAPI Endpoint IP 주소
      표. ServiceWatch Agent 통신을 위한 Internet Gateway Firewall 규칙

ServiceWatch OpenAPI Endpoint IP 주소

ServiceWatch Agent가 ServiceWatch로 수집된 데이터를 전송하기 위해 필요한 Endpoint IP 주소는 다음과 같습니다.

오퍼링리전URLIP 주소
For Enterprisekr-west1https://servicewatch.kr-west1.e.samsungsdscloud.com112.107.105.24
For Enterprisekr-east1https://servicewatch.kr-east1.e.samsungsdscloud.com112.107.105.68
표. ServiceWatch OpenAPI Endpoint 정보

ServiceWatch를 위한 Open Telemetry Collector 설정

서버에서 ServiceWatch 지표와 로그 수집을 위한 Open Telemetry Collector를 사용하기 위해 아래의 순서에 따라 설치합니다.

  1. ServiceWatch를 위한 Agent 파일을 다운로드 받을 수 있는 URL로 부터 Agent 파일을 다운로드 받습니다.
안내
ServiceWatch를 위한 Agent 설치를 위한 파일 다운로드 링크는 ServiceWatch의 Service Home > 시작 위젯에서 확인할 수 있습니다.
또한 ServiceWatch의 ShowAgentDownloadLink API로도 확인 가능합니다. 자세한 내용은 ServiceWatch API Reference를 참고하세요.
배경색 변경
wget [ServiceWatch Agent 파일 다운로드 URL]
wget [ServiceWatch Agent 파일 다운로드 URL]
코드블록. ServiceWatch를 위한 Agent 설치 파일 다운로드 명령어
  1. ServiceWatch를 위한 Open Telemetry Collector Agent 파일은 아래와 같이 확인할 수 있습니다.
    • ServiceWatch를 위한 Agent 파일을 압축 해제합니다.
      배경색 변경
      unzip ServiceWatch_Agent.zip
      unzip ServiceWatch_Agent.zip
      코드블록. ServiceWatch를 위한 Agent 파일 압축 해제
    • ServiceWatch Agent를 사용하는 환경이 Linux OS인 경우, 아래와 같이 실행 권한을 부여해야합니다.
      배경색 변경
      chmod +x agent/otelcontribcol_linux_amd64
      chmod +x agent/servicewatch-agent-manager-linux-amd64
      chmod +x agent/otelcontribcol_linux_amd64
      chmod +x agent/servicewatch-agent-manager-linux-amd64
      코드블록. ServiceWatch를 위한 Agent 파일 실행 권한 부여
      구분상세 설명
      examples예시 설정 파일 폴더. 각 폴더 안에 agent.json, log.json, metric.json 예시 파일이 존재함
      • os-metrics-min-examples: Node Exporter를 활용한 최소 지표 설정 예시
      • os-metrics-all-examples: Node Exporter를 활용한 memory/filesystem Collector 지표 설정 예시
      • gpu-metrics-min-examples: DCGM Exporter를 활용한 최소 지표 설정 예시
      • gpu-metrics-all-examples: DCGM Exporter를 활용한 주요 지표 설정 예시
      otelcontribcol_linux_amd64ServiceWatch용 Open Telemetry Collector for Linux
      otelcontribcol_windows_amd64.exeServiceWatch용 Open Telemetry Collector for Windows
      servicewatch-agent-manager-linux-amd64ServiceWatch Agent Manager for Linux
      servicewatch-agent-manager-windows-amd64.exeServiceWatch Agent Manager for Windows
      표. ServiceWatch를 위한 Agent 파일 구성
참고
ServiceWatch Agent Manager는 ServiceWatch와 연동되어 사용자 정의 지표와 로그를 효율적으로 전송하기 위해 Open Telemetry Collector 설정을 도와주는 도구입니다. 이를 통해 다양한 사용자 정의 지표와 로그 데이터를 ServiceWatch로 전달할 수 있습니다.
  1. ServiceWatch용 Open Telemetry Collector를 위해 ServiceWatch Agent Manager의 Agent 설정 파일을 정의합니다.

    구분상세 설명
    namespace사용자 정의 지표를 위한 사용자 정의 네임 스페이스
    • 네임스페이스는 지표를 구분하고 그룹화하기 위한 논리적인 구분으로 사용자 정의 지표를 구분하기 위한 사용자 정의 지표로 지정
    • 네임 스페이스는 영문, 숫자, 공백, 특수문자(_-/)를 포함하여 3~128자로 작성해야하며, 영문으로 시작해야 합니다.
    accessKeyIAM 인증키 Access Key
    accessSecretIAM 인증키 Secret Key
    resourceId서버의 Samsung Cloud Platform에서의 자원 ID
    • 예시: Virtual Server의 자원 ID
    openApiEndpoint리전/오퍼링별 ServiceWatch OpenAPI Endpoint
    • 예시: https://servicewatch.region.offering.samsungsdscloud.com
    • regionoffering 정보는 Samsung Cloud Platform Console 접속 URL에서 확인 가능
    telemetryPortServiceWatch Agent의 Telemetry Port
    • 보통 8888 Port로 사용. 8888 Port가 사용 중인 경우 변경 필요
    표. agent.json 설정 파일 항목
    배경색 변경
    {
       "namespace": "swagent-windows",     # 사용자 정의 지표를 위한 사용자 정의 네임 스페이스
       "accessKey": "testKey",             # IAM 인증키 Access Key
       "accessSecret": "testSecret",       # IAM 인증키 Secret Key
       "resourceId": "resourceID",         # 서버의 Samsung Cloud Platform에서의 자원 ID
       "openApiEndpoint": "https://servicewatch.kr-west1.e.samsungsdscloud.com",    # 리전/환경별 ServiceWatch OpenAPI Endpoint
       "telemetryPort": 8889               # ServiceWatch Agent의 Telemetry Port (보통 8888 Port로 사용. 8888 Port가 사용 중인 경우 변경 필요)
    }
    {
       "namespace": "swagent-windows",     # 사용자 정의 지표를 위한 사용자 정의 네임 스페이스
       "accessKey": "testKey",             # IAM 인증키 Access Key
       "accessSecret": "testSecret",       # IAM 인증키 Secret Key
       "resourceId": "resourceID",         # 서버의 Samsung Cloud Platform에서의 자원 ID
       "openApiEndpoint": "https://servicewatch.kr-west1.e.samsungsdscloud.com",    # 리전/환경별 ServiceWatch OpenAPI Endpoint
       "telemetryPort": 8889               # ServiceWatch Agent의 Telemetry Port (보통 8888 Port로 사용. 8888 Port가 사용 중인 경우 변경 필요)
    }
    코드블록. agent.json 설정 예시

  2. ServiceWatch용 지표 수집을 위한 Metric 설정 파일을 정의합니다.

    • Agent를 통해 지표 수집하고자 하는 경우 metric.json을 설정합니다.
      구분상세 설명
      prometheus > scrape_configs > targets지표 수집 대상의 Endpoint
      • 서버의 경우 같은 서버에 Prometheus Exporter 설치하므로 해당 endpoint로 설정
      • 예시: localhost:9100
      prometheus > scrape_configs > jobNameJob Name 설정. 보통 지표 수집 시 사용하는 Prometheus Exporter 종류로 설정
      • 예시: node-exporter
      metricMetas > metricName수집하고자 하는 지표 이름 설정. 지표명은 영문, 숫자, 특수문자(_)를 포함하여 3~128자로 작성해야하며, 영문으로 시작해야 합니다.
      • 예시: node_cpu_seconds_total
      metricMetas > dimensionsExporter의 지표 데이터의 출처를 식별하기 위해 제공하는 Collector의 레이블 중 Console에 시각화하여 보여주기 위한 레이블을 설정. 수집한 지표를 Console에 시각화하여 보여줄 때, 차원(dimensions) 설정에 따라 조합하여 표시.
      • 예시: Node Exporter의 Memory Collector의 지표와 같이 특별한 레이블을 제공하지 않는 경우에는 resource_id로 설정
      • 예시: Node Exporter의 Filesystem Collector 지표는 파일시스템이 시스템상에 마운트된 경로를 나타내는 mountpoint로 차원(dimensions) 설정할 수 있음
      metricMetas > unit지표의 단위 설정 가능
      • 예시: Bytes, Count 등
      metricMetas > aggregationMethod지정한 차원(dimensions) 기준으로 집계하는 방법
      • 예시: SUM, MAX, MIN, COUNT 중 선택
      metricMetas > descriptionKo수집하는 지표에 대한 국문 설명
      metricMetas > descriptionEn수집하는 지표에 대한 영문 설명
      표. metric.json 설정 파일 항목
      배경색 변경
      {
         "prometheus": {
            "scrape_configs": {
               "targets": [
                  "localhost:9100" # 서버 내 설치한 Prometheus Exporter의 Endpoint
               ],
               "jobName": "node-exporter" # 보통 설치한 Exporter의 이름으로 설정
            }
         },
         "metricMetas": [
            {
               "metricName": "node_memory_MemTotal_bytes",    # Prometheus Exporter로부터 수집되는 지표 중 ServiceWatch로 연계하고자 하는 지표명 설정
               "dimensions": [
                  [
                     "resource_id"        # Node Exporter의 지표 데이터의 출처를 식별하기 위해 제공하는 Collector의 레이블 중 Console에 시각화하여 보여주기 위한 레이블을 설정
                                          # 해당 Memory 관련 지표와 같이 특별한 레이블을 제공하지 않는 경우에는 resource_id로 설정
                  ]
               ],
               "unit": "Bytes",           # 수집 지표 데이터의 단위
               "aggregationMethod": "SUM",    # 집계 방법
               "descriptionKo": "서버의 총 물리적 메모리 크기",    # 지표의 국문 설명
               "descriptionEn": "node memory total bytes"      # 지표의 영문 설명
            },
            {
               "metricName": "node_filesystem_size_bytes",    # Prometheus Exporter로부터 수집되는 지표 중 ServiceWatch로 연계하고자 하는 지표명 설정
               "dimensions": [
                  [
                     "mountpoint"        # Node Exporter의 지표 데이터의 출처를 식별하기 위해 제공하는 Collector의 레이블 중 Console에 시각화하여 보여주기 위한 레이블을 설정
                                         # 해당 Filesystem 관련 지표의 파일시스템이 시스템상에 마운트된 경로를 나타내는 mountpoint로 차원(dimensions) 설정
                  ]
               ],
               "unit": "Bytes",
               "aggregationMethod": "SUM",
               "descriptionKo": "node filesystem size bytes",
               "descriptionEn": "node filesystem size bytes"
            },
            {
               "metricName": "node_memory_MemAvailable_bytes",
               "dimensions": [
                  [
                     "resource_id"
                  ]
               ],
               "unit": "Bytes",
               "aggregationMethod": "SUM",
               "descriptionKo": "node memory available bytes",
               "descriptionEn": "node memory available bytes"
            },
            {
               "metricName": "node_filesystem_avail_bytes",
               "dimensions": [
                  [
                     "mountpoint"
                  ]
               ],
               "unit": "Bytes",
               "aggregationMethod": "SUM",
               "descriptionKo": "node filesystem available bytes",
               "descriptionEn": "node filesystem available bytes"
            }
         ]
      }
      {
         "prometheus": {
            "scrape_configs": {
               "targets": [
                  "localhost:9100" # 서버 내 설치한 Prometheus Exporter의 Endpoint
               ],
               "jobName": "node-exporter" # 보통 설치한 Exporter의 이름으로 설정
            }
         },
         "metricMetas": [
            {
               "metricName": "node_memory_MemTotal_bytes",    # Prometheus Exporter로부터 수집되는 지표 중 ServiceWatch로 연계하고자 하는 지표명 설정
               "dimensions": [
                  [
                     "resource_id"        # Node Exporter의 지표 데이터의 출처를 식별하기 위해 제공하는 Collector의 레이블 중 Console에 시각화하여 보여주기 위한 레이블을 설정
                                          # 해당 Memory 관련 지표와 같이 특별한 레이블을 제공하지 않는 경우에는 resource_id로 설정
                  ]
               ],
               "unit": "Bytes",           # 수집 지표 데이터의 단위
               "aggregationMethod": "SUM",    # 집계 방법
               "descriptionKo": "서버의 총 물리적 메모리 크기",    # 지표의 국문 설명
               "descriptionEn": "node memory total bytes"      # 지표의 영문 설명
            },
            {
               "metricName": "node_filesystem_size_bytes",    # Prometheus Exporter로부터 수집되는 지표 중 ServiceWatch로 연계하고자 하는 지표명 설정
               "dimensions": [
                  [
                     "mountpoint"        # Node Exporter의 지표 데이터의 출처를 식별하기 위해 제공하는 Collector의 레이블 중 Console에 시각화하여 보여주기 위한 레이블을 설정
                                         # 해당 Filesystem 관련 지표의 파일시스템이 시스템상에 마운트된 경로를 나타내는 mountpoint로 차원(dimensions) 설정
                  ]
               ],
               "unit": "Bytes",
               "aggregationMethod": "SUM",
               "descriptionKo": "node filesystem size bytes",
               "descriptionEn": "node filesystem size bytes"
            },
            {
               "metricName": "node_memory_MemAvailable_bytes",
               "dimensions": [
                  [
                     "resource_id"
                  ]
               ],
               "unit": "Bytes",
               "aggregationMethod": "SUM",
               "descriptionKo": "node memory available bytes",
               "descriptionEn": "node memory available bytes"
            },
            {
               "metricName": "node_filesystem_avail_bytes",
               "dimensions": [
                  [
                     "mountpoint"
                  ]
               ],
               "unit": "Bytes",
               "aggregationMethod": "SUM",
               "descriptionKo": "node filesystem available bytes",
               "descriptionEn": "node filesystem available bytes"
            }
         ]
      }
      코드블록. metric.json 설정 예시
    • 자원명 표기를 위해서는 아래와 같이 commonLabels에 resource_name을 설정하고, metricMetas.dimensions에도 resource_name을 설정하면 ServiceWatch에서 지표 조회할 때 자원명을 함께 확인할 수 있습니다.
      배경색 변경
      ...
         "commonLabels": {
            "resource_name": "ResourceName" # User Console에서 확인 가능한 자원명
         },
         "metricMetas": [
            {
               "metricName": "metric_name", 
               "dimensions": [
                  [
                     "resource_id",
                     "resource_name"        # commonLabels에서 설정한 resource_name을 각 metric의 dimensions에 추가
      
                  ]
               ],
               "unit": "Bytes",
               "aggregationMethod": "SUM",
               "descriptionKo": "metric_name 설명",
               "descriptionEn": "metric_name description"
            },
         ...
         ]
      ...
      ...
         "commonLabels": {
            "resource_name": "ResourceName" # User Console에서 확인 가능한 자원명
         },
         "metricMetas": [
            {
               "metricName": "metric_name", 
               "dimensions": [
                  [
                     "resource_id",
                     "resource_name"        # commonLabels에서 설정한 resource_name을 각 metric의 dimensions에 추가
      
                  ]
               ],
               "unit": "Bytes",
               "aggregationMethod": "SUM",
               "descriptionKo": "metric_name 설명",
               "descriptionEn": "metric_name description"
            },
         ...
         ]
      ...
      코드블록. metric.json - 자원명 설정
  3. ServiceWatch용 로그 수집을 위한 Log 설정 파일을 정의합니다.

    • 로그 수집을 하고자 하는 경우 log.json 설정을 해야합니다.
      구분상세 설명
      fileLog > include수집할 로그 파일 위치
      fileLog > operators수집할 로그 메시지를 파싱하기 위해 정의
      fileLog > operators > regex로그 메시지 형식을 정규식으로 표현
      fileLog > operators > timestampServiceWatch로 전송될 로그 메시지의 Time Stamp의 형식
      logMetas > log_group_valueServiceWatch로 로그 전송을 위해 생성한 로그 그룹 이름
      logMetas > log_stream_valueServiceWatch 로그 그룹내 로그 스트림 이름
      표. log.json 설정 파일 항목
      배경색 변경
      {
         "fileLog": {
            "include": [
               "/var/log/syslog",        # ServiceWatch로 수집할 로그 파일
               "/var/log/auth.log"
            ],
            "operators": {
               "regex": "^(?P<timestamp>\\S+)\\s+(?P<hostname>\\S+)\\s+(?P<process>[^:]+):\\s+(?P<message>.*)$",    # 로그 파일 형식을 정규식으로 표현
               "timestamp": {            # 로그 메시지의 Time Stamp 형식 설정정
                  "layout_type": "gotime",
                  "layout": "2006-01-02T15:04:05.000000Z07:00"
               }
            }
         },
         "logMetas": {
            "log_group_value": "custom-log-group",    # 사전에 생성한 ServiceWatch의 로그 그룹명
            "log_stream_value": "custom-log-stream"   # 사전에 생성한 SerivceWatch 로그 그룹 내의 로그 스트림명
         }
      }
      {
         "fileLog": {
            "include": [
               "/var/log/syslog",        # ServiceWatch로 수집할 로그 파일
               "/var/log/auth.log"
            ],
            "operators": {
               "regex": "^(?P<timestamp>\\S+)\\s+(?P<hostname>\\S+)\\s+(?P<process>[^:]+):\\s+(?P<message>.*)$",    # 로그 파일 형식을 정규식으로 표현
               "timestamp": {            # 로그 메시지의 Time Stamp 형식 설정정
                  "layout_type": "gotime",
                  "layout": "2006-01-02T15:04:05.000000Z07:00"
               }
            }
         },
         "logMetas": {
            "log_group_value": "custom-log-group",    # 사전에 생성한 ServiceWatch의 로그 그룹명
            "log_stream_value": "custom-log-stream"   # 사전에 생성한 SerivceWatch 로그 그룹 내의 로그 스트림명
         }
      }
      코드블록. log.json 설정 예시
참고

ServiceWatch Agent를 통해 서버의 로그 파일을 ServiceWatch에 연계하기 위해서는 로그 그룹과 로그 그룹 내 로그 스트림을 먼저 생성해야합니다.

  • 로그 그룹 생성 및 로그 스트림 생성에 대한 자세한 내용은 로그를 참고하세요.

ServiceWatch를 위한 Open Telemetry Collector 실행

ServiceWatch Agent 실행 방법
[SerivceWatch Agent 실행파일] -action [run|stop] - dir [설정파일 위치] -collector [Open Telemetry Collector 실행파일 위치]
실행 옵션상세 설명
-action액션 설정 (run 또는 stop)
-diragent.json, metric.json, log.json 과 같은 ServiceWatch Agent 설정 파일 위치
-collectorOpen Telemetry Collector 실행파일 위치
표. log.json 설정 파일 항목

ServiceWatch Agent 실행 (for Linux)

참고
agent.json, metric.json, log.json 파일이 현재위치/agent/examples/os-metrics-min-examples에 있고, otelcontribcol_linux_amd64 파일은 현재위치/agent 에 있다고 가정했을 때 아래와 같이 실행합니다.
  1. ServiceWatch Agent를 실행합니다.

    • agent.json, metric.json, log.json 파일 위치와 servicewatch-agent-manager-linux-amd64,otelcontribcol_linux_amd64 파일의 위치를 확인하여 ServiceWatch Agent를 시작합니다.
      배경색 변경
      ./agent/servicewatch-agent-manager-linux-amd64 -action run -dir ./agent/examples/os-metrics-min-examples -collector ./agent/otelcontribcol_linux_amd64
      ./agent/servicewatch-agent-manager-linux-amd64 -action run -dir ./agent/examples/os-metrics-min-examples -collector ./agent/otelcontribcol_linux_amd64
      코드블록. ServiceWatch Agent 시작 - 지표/로그 모두 수집
    • 지표만 수집하고자 하는 경우, log.json 파일을 다른 파일명으로 변경하거나 agent.json, metric.json과 같은 디렉토리에 있지 않도록 옮기고, 아래와 같이 실행해주세요.
      배경색 변경
      ./agent/servicewatch-agent-manager-linux-amd64 -action run -dir ./agent/examples/os-metrics-min-examples -collector ./agent/otelcontribcol_linux_amd64
      ./agent/servicewatch-agent-manager-linux-amd64 -action run -dir ./agent/examples/os-metrics-min-examples -collector ./agent/otelcontribcol_linux_amd64
      코드블록. ServiceWatch Agent 시작 - 지표만 수집
    • 로그만 수집하고자 하는 경우, metric.json 파일을 다른 파일명으로 변경하거나 agent.json, log.json과 같은 디렉토리에 있지 않도록 옮기고, 아래와 같이 실행해주세요.
      배경색 변경
      ./agent/servicewatch-agent-manager-linux-amd64 -action run -dir ./agent/examples/os-metrics-min-examples -collector ./agent/otelcontribcol_linux_amd64
      ./agent/servicewatch-agent-manager-linux-amd64 -action run -dir ./agent/examples/os-metrics-min-examples -collector ./agent/otelcontribcol_linux_amd64
      코드블록. ServiceWatch Agent 시작 - 로그만 수집
  2. ServiceWatch Agent를 중지합니다.

    배경색 변경
    ./agent/servicewatch-agent-manager-linux-amd64 -action stop -dir ./agent/examples/os-metrics-min-examples
    ./agent/servicewatch-agent-manager-linux-amd64 -action stop -dir ./agent/examples/os-metrics-min-examples
    코드블록. ServiceWatch Agent 중지

ServiceWatch Agent 실행 (for Windows)

  1. ServiceWatch Agent를 실행합니다.

    배경색 변경
    servicewatch-agent-manager-windows-amd64.exe -action run -dir ./examples -collector otelcontribcol_windows_amd64.exe
    servicewatch-agent-manager-windows-amd64.exe -action run -dir ./examples -collector otelcontribcol_windows_amd64.exe
    코드블록. ServiceWatch Agent 시작

  2. ServiceWatch Agent를 중지합니다.

    배경색 변경
    servicewatch-agent-manager-windows-amd64.exe -action stop -dir ./examples
    servicewatch-agent-manager-windows-amd64.exe -action stop -dir ./examples
    코드블록. ServiceWatch Agent 중지