ServiceWatch

• 1: Overview
• 1.1: 지표
• 1.2: 경보
• 1.3: 로그
• 1.4: 이벤트
• 1.5: ServiceWatch 연계 서비스
• 1.6: 사용자 정의 지표와 로그
• 2: How-to guides
• 2.1: 대시보드 및 위젯 관리하기
• 2.2: 경보
• 2.3: 지표
• 2.4: 로그
• 2.5: 이벤트
• 2.6: ServiceWatch Agent 사용하기
• 3: API Reference
• 4: CLI Reference
• 5: ServiceWatch Event Reference
• 5.1: ServiceWatch Event
• 5.1.1: Multi-node GPU Cluster
• 5.1.2: MySQL(DBaaS)
• 5.1.3: Global CDN
• 5.1.4: Data Flow
• 5.1.5: GSLB
• 5.1.6: Cloud Control
• 5.1.7: Cloud WAN
• 5.1.8: Object Storage
• 5.1.9: VPC
• 5.1.10: GPU Server
• 5.1.11: Virtual Server
• 5.1.12: Firewall
• 5.1.13: ID Center
• 5.1.14: Microsoft SQL Server(DBaaS)
• 5.1.15: Block Storage(BM)
• 5.1.16: Resource Groups
• 5.1.17: Cloud Functions
• 5.1.18: AI&MLOps Platform
• 5.1.19: Event Streams
• 5.1.20: Security Group
• 5.1.21: Archive Storage
• 5.1.22: API Gateway
• 5.1.23: Load Balancer
• 5.1.24: Data Ops
• 5.1.25: Scalable DB(DBaaS)
• 5.1.26: Cloud LAN-Campus
• 5.1.27: EPAS(DBaaS)
• 5.1.28: PostreSQL(DBaaS)
• 5.1.29: Logging&Audit
• 5.1.30: Search Engine
• 5.1.31: DNS
• 5.1.32: VPN
• 5.1.33: Secrets Manager
• 5.1.34: Quick Query
• 5.1.35: File Storage
• 5.1.36: CacheStore(DBaaS)
• 5.1.37: Secret Vault
• 5.1.38: Queue Service
• 5.1.39: Kubernetes Engine
• 5.1.40: Config Inspection
• 5.1.41: Cloud LAN-Datacenter
• 5.1.42: Identity Access Management
• 5.1.43: Bare Metal Server
• 5.1.44: ServiceWatch
• 5.1.45: MariaDB(DBaaS)
• 5.1.46: Container Registry
• 5.1.47: Vertica(DBaaS)
• 5.1.48: Backup
• 5.1.49: Organization
• 5.1.50: Cloud ML
• 5.1.51: Certificate Manager
• 5.1.52: Key Management Service
• 5.1.53: Direct Connect
• 5.1.54: Support Center
• 6: Release Note

1 - Overview

서비스 개요

ServiceWatch는 Samsung Cloud Platform에서 생성한 자원의 지표, 로그, 이벤트 등을 수집하여 모니터링하고 성능, 운영 상태 등 자원 전반에 대한 관찰성을 제공하는 여러 가지 도구를 제공하는 서비스입니다.

특장점

다음과 같은 특장점을 제공하고 있습니다.

• 자원 모니터링: 자원의 성능 지표(CPU Usage 등)를 수집하고 시각화합니다. 또한 여러 지표를 한 곳에서 시각적으로 확인할 수 있는 대시보드를 생성하여 한눈에 파악할 수 있습니다.
• 경보 정책 설정 및 자동 알림: 사전에 설정한 조건과 임곗값을 설정하여 경보 정책을 생성할 수 있고, 임곗값을 초과하게 되면 알림을 수신할 수 있어 자원의 상태에 대해 빠르게 확인하고 대응할 수 있습니다.
• 로그 분석 및 저장: 자원에서 발생한 로그를 수집하여 손쉽게 조회하고 검색할 수 있습니다. 수집한 로그는 로그 그룹에 보관하여 관리하며, 로그 그룹은 5GB까지 무료로 저장할 수 있습니다. 또한, 로그 보관 정책을 설정하여 로그 보관 기간을 지정할 수 있으며, 보관 기간이 지난 로그는 별도로 관리하지 않아도 됩니다.
• 비용 효율성: ServiceWatch는 사용한 만큼 비용을 지불하는 유연한 요금제를 제공하여 비용 효율적으로 사용할 수 있습니다. 또한 무료 이용 범위를 제공함으로써 무료로 사용해 본 후, 필요한 만큼 유료로 확장할 수 있습니다.

제공 기능

다음과 같은 기능을 제공하고 있습니다.

• 지표 모니터링
  • 지표: ServiceWatch는 Samsung Cloud Platform의 서비스들이 ServiceWatch에 지표 데이터를 제공하고, ServiceWatch는 지표 데이터를 수집 및 저장하여 사용자에게 제공합니다.
  • 대시보드: 단일 리전의 지표를 시각화하여 자원에 대한 통합된 뷰를 제공합니다. ServiceWatch에서는 서비스별로 자동으로 생성되는 서비스 대시보드와 사용자가 직접 생성하는 사용자 대시보드로 구분됩니다.
  • 경보: 사용자가 정의한 임곗값에 따라 지표의 변화를 확인할 수 있는 경보 기능을 제공하고 임곗값을 넘어갈 경우 알림을 제공합니다.
• 로그 모니터링
  • ServiceWatch는 로그 관리 기능을 제공합니다. Samsung Cloud Platform 서비스로부터 수집된 로그는 로그 그룹에 저장되어 관리할 수 있습니다. 로그 보관 정책을 설정하여 로그 보관 기간을 관리할 수 있습니다. 또한 콘솔을 통해 로그 데이터를 조회 및 검색할 수 있고 로그 그룹을 Object Storage로 저장할 수 있는 기능을 제공합니다.
• ServiceWatch Agent
  • ServiceWatch Agent를 통해 Virtual Server, GPU Server, Bare Metal Server 등에서 프로세스, CPU, 메모리, 디스크 사용량 및 네트워크 성능에 대한 자세한 지표를 수집할 수 있습니다. 또한 GPU 성능 지표도 수집할 수 있습니다. 그리고 Agent를 통해 자원에서 발생한 로그도 수집할 수 있습니다. (25년 12월 예정)
• 이벤트 모니터링
  • ServiceWatch는 Samsung Cloud Platform에서 생성된 자원의 변경 사항에 대한 시스템 이벤트로부터 이벤트 규칙을 생성하여 특정 조건에 알림을 수신할 수 있습니다.

구성 요소

지표

지표란 시스템의 성능 데이터를 말합니다. 기본적으로 ServiceWatch와 연계된 서비스의 자원에 대해서는 무료 지표 기반으로 기본 모니터링을 제공합니다. 추가로 Virtual Server와 같은 서비스는 세부 모니터링을 활성화하여 유료 지표를 제공할 수 있습니다.

지표 데이터는 최대 15개월(455일) 동안 확인할 수 있습니다.

지표와 관련된 자세한 내용은 지표를 참고하세요.

로그

Virtual Server의 자원, Kubernetes Engine 등 Samsung Cloud Platform의 서비스에서 사용하는 시스템, 애플리케이션 및 서비스의 로그를 수집하고 저장하고 조회할 수 있습니다.

로그와 관련된 자세한 내용은 로그를 참고하세요.

이벤트

이벤트는 Samsung Cloud Platform 서비스에서 환경의 변화를 나타냅니다. 다음은 이벤트의 예제입니다.

• Virtual Server의 상태가 Stopped에서 Running으로 변경될 때 이벤트를 생성합니다.
• Object Storage에 새로운 버킷이 생성되었을 때 이벤트를 생성합니다.
• IAM 사용자를 사용자 그룹에서 제외하였을 때 이벤트를 생성합니다.

이벤트와 관련된 자세한 내용은 이벤트를 참고하세요.

대시보드

ServiceWatch에는 서비스별로 자동으로 사전 구축된 서비스 대시보드가 제공되며, 사용자가 직접 대시보드를 생성할 수도 있습니다.

ServiceWatch Agent

ServiceWatch Agent는 Virtual Server, GPU Server 및 On-Prem. 서버 등 에서 지표, 로그를 수집하는 소프트웨어 구성 요소입니다. 이를 통해 기본적으로 제공되는 기본 모니터링보다 더 세밀한 인프라와 애플리케이션을 모니터링할 수 있습니다.

제약 사항

ServiceWatch의 제약 사항은 다음과 같습니다.

다음은 ServiceWatch의 월별 무료 제공 내역입니다.

리전별 제공 현황

ServiceWatch은 아래의 환경에서 제공 가능합니다.

선행 서비스

ServiceWatch의 선행 서비스는 없습니다.

1.1 - 지표

지표

지표는 시스템 성능에 대한 데이터입니다. 기본적으로 많은 서비스에서 자원(예시: Virtual Server, File Storage 등)에 대한 무료 지표를 제공하며 이는 ServiceWatch를 통해 기본 모니터링으로 제공됩니다. Virtual Server와 같은 일부 자원에 대한 세부 모니터링을 사용할 수 있습니다.

지표 데이터는 15개월(455일) 동안 보관되기 때문에 최신 데이터와 이력 데이터를 모두 볼 수 있습니다.

네임스페이스

네임스페이스는 ServiceWatch의 지표를 구분하고 그룹화하기 위한 논리적인 구분입니다. Samsung Cloud Platform 서비스의 네임스페이스는 대부분 서비스 이름과 동일하게 사용하며, ServiceWatch 연계 서비스 목록에서 확인 가능합니다.

사용자 정의 지표의 경우 ServiceWatch에서 다른 지표들과 구분할 수 있는 네임스페이스를 사용자가 정의할 수 있으며 ServiceWatch Agent 설정 또는 OpenAPI를 통해 정의할 수 있습니다. 사용자 정의 지표와 로그에 대한 자세한 내용은 사용자 정의 지표 및 로그에서 확인할 수 있습니다.

지표(메트릭)

지표는 ServiceWatch에 수집되는 시간순으로 정렬된 데이터 포인트 집합을 나타냅니다. 데이터 포인트는 타임스탬프와 수집된 데이터, 데이터의 단위로 구성되어 있습니다.

예를 들어, 특정 Virtual Server 서버의 CPU 사용률은 Virtual Server에서 제공하는 기본 모니터링 지표 중 하나입니다. 데이터 포인트 자체는 데이터를 수집하는 모든 애플리케이션이나 활동에서 발생할 수 있습니다.

기본적으로 ServiceWatch와 연계된 Samsung Cloud Platform 서비스는 자원에 대한 지표를 무료로 제공합니다. 일부 자원에 대한 상세 모니터링을 유료로 제공하며 각 서비스에서 활성화할 수 있습니다.

지표는 생성된 리전에서만 조회 가능합니다. 지표는 임의로 사용자가 삭제할 수 없습니다. 다만, 새로운 데이터가 ServiceWatch로 게시되지 않으면 15개월 후 자동으로 만료됩니다. 15개월(455일)이 지난 데이터 포인트는 순차적으로 만료되며, 새로운 데이터 포인트가 추가되면 15개월(455일)이 지난 데이터는 삭제됩니다.

타임 스탬프

데이터 포인트의 타임 스탬프는 데이터 포인트가 기록된 시간을 나타내는 시간 정보입니다. 각 지표 데이터 포인트는 시간인 타임스탬프와 데이터로 구성되어있습니다.

타임스탬프는 시간, 분, 초와 날짜로 구성되어 있습니다.

지표 보존 기간

ServiceWatch 지표 데이터를 다음과 같이 유지합니다.

• 수집 주기가 60초(1분)로 설정된 데이터 포인트는 15일까지 사용 가능
• 수집 주기가 300초(5분)로 설정된 데이터 포인트는 63일까지 사용 가능
• 수집 주기가 3600초(1시간)로 설정된 데이터 포인트는 455일(15개월)까지 사용 가능

처음 짧은 수집 주기로 수집되었던 데이터 포인트는 장기 보관을 위해 다운샘플링하여 저장합니다.

예를 들어 1분 주기로 데이터를 수집한 경우, 1분 단위로 15일 동안 유지됩니다. 15일이 지난 후에도 이 데이터는 계속 유지되지만, 5분 단위로만 검색할 수 있습니다. 63일이 지난 후에는 이 데이터가 다시 집계되어 1시간 단위로 제공됩니다. 지표 보존 기간보다 더 오랫동안 지표의 데이터 포인트를 보관해야 하는 경우 파일 다운로드 또는 Object Storage 내보내기 기능을 통해 별도 보관할 수 있습니다.

차원(Dimensions)

지표에 대한 고유 식별자 역할을 하는 키-값 쌍으로, 이를 통해 데이터 포인트를 분류하고 필터링할 수 있습니다.

예를 들어 Virtual Server의 지표의 resource_id 차원을 이용하여 특정 서버에 대한 지표들을 식별할 수 있습니다.

수집 주기

각 서비스의 지표에 대한 데이터 포인트를 수집하는 주기를 의미하며, 각 서비스에서 사전 정의한 수집 주기로 제공됩니다.

각 서비스의 지표 수집 주기는 각 서비스의 ServiceWatch 지표 페이지를 참고하세요.

예를 들어 Virtual Server는 기본 모니터링일때 수집 주기를 5분으로 제공하며, 세부 모니터링을 활성화하면 1분으로 제공합니다.

통계

통계는 지정된 기간 동안의 지표 데이터 집계하는 방법입니다. ServiceWatch는 각 서비스에서 ServiceWatch에 제공한 지표 데이터 포인트를 기반으로 통계로 집계한 데이터 제공합니다. 집계는 지정된 집계 기간 내에 네임스페이스, 지표 이름, 차원 및 데이터 포인트 단위를 사용하여 수행됩니다.

제공되는 통계는 합계, 평균, 최소, 최대입니다.

• 합계: 해당 기간 동안 수집된 모든 데이터 포인트 값의 합계
• 평균: 지정된 기간 동안 (해당 기간 동안 모든 데이터 포인터 값의 합)/(해당 기간 동안 데이터 포인터 수) 값
• 최소: 지정된 기간 동안 관찰된 가장 낮은 값
• 최대: 지정된 기간 동안 관찰된 가장 높은 값

단위

각 통계에는 측정 단위가 있습니다. 단위의 예로는 Bytes, Second, Count, Percent 등 이 있습니다.

집계 기간

각 통계는 선택한 집계 기간동안 수집된 지표의 데이터 포인터를 계산합니다. 집계 기간은 1분, 5분, 15분, 30분, 1시간, 3시간, 6시간, 12시간, 1일 중에 선택할 수 있으며, 기본값은 5분입니다. 집계 기간은 지표 데이터 포인트의 수집 주기와 밀접한 관련이 있으며, 정상적인 집계 결과를 얻으려면 집계 기간이 수집 주기보다 길거나 같아야 합니다.

예를 들어 통계는 평균, 집계 기간은 5분을 선택하고, 수집 주기가 1분인 지표를 선택한 경우, 1분 간격으로 데이터 포인트를 수집하여 5분 동안 수집된 데이터 포인트에 대해 평균을 계산하여 나타냅니다. 반대로 수집 주기보다 집계 기간이 더 짧으면 정상적인 집계 결과를 얻을 수 없음을 의미합니다.

지표 데이터의 장기 보관을 위해 다운샘플링이 적용됩니다. 예를 들어 1분 주기로 데이터를 수집한 경우, 15일이 지나면 이 데이터는 5분 단위로만 검색할 수 있습니다. 이런 지표에 대해 집계 기간을 5분에서 30분으로 설정하면 다운 샘플링한 데이터를 정상적으로 조회하기 위해서 최대 5분의 시간이 소요될 수 있습니다. 이후 63일이 지난 후에는 이 데이터가 다시 집계되어 1시간 단위로 제공됩니다. 이때 1시간부터 1일까지의 집계 기간을 선택하면 정상적인 데이터 조회를 위해 최대 1시간의 시간이 소요될 수 있습니다. 이는 지표 데이터를 다운 샘플링하여 집계하는 시간이 소요되어 집계 지연이 발생할 수 있습니다.

경보

경보 정책을 생성할 때 입력한 평가 범위 동안 하나의 지표에 대해 평가하여 임곗값을 기준으로 설정한 조건에 충족될 경우 사용자에게 경보 알림으로 안내할 수 있습니다.

경보 상태는 Alert(경보), Normal(정상), Insufficient data(데이터 없음)로 구분됩니다.

• Alert(경보): 지표가 설정된 조건에 충족하는 경우
• Normal(정상): 지표가 설정된 조건에 충족하지 않은 경우
• Insufficient data(데이터 없음): 지표 데이터가 존재하지 않거나, 지표 데이터가 누락되었거나, 지표 데이터가 아직 도착하지 않은 경우

경보 상태가 Alert일때, 경보 평가하여 조건에서 벗어나는 경우 다시 경보 상태가 Normal로 변경됩니다.

경보에 대한 자세한 내용은 경보 항목을 참조하세요.

기본 모니터링과 세부 모니터링

ServiceWatch는 기본 모니터링과 세부 모니터링, 두 종류의 모니터링을 제공합니다.

ServiceWatch와 연계된 Samsung Cloud Platform 서비스는 ServiceWatch에 기본 지표 세트를 무료로 게시하여 기본 모니터링을 제공합니다. 기본적으로 해당 서비스를 하나라도 사용하면 기본 모니터링을 자동으로 활성화되어 ServiceWatch에서 확인 가능합니다.

세부 모니터링은 일부 서비스에서만 제공되며 요금이 부과됩니다. 세부 모니터링을 사용하려면 해당 서비스 상세에서 활성화해야합니다.

세부 모니터링 옵션은 제공하는 서비스에 따라 다릅니다.

• Virtual Server의 기본 모니터링은 수집 주기가 5분입니다. 세부 모니터링을 활성화하면 기본 모니터링으로 제공되는 지표에 대해서 5분 → 1분 주기로 수집합니다.
• Object Storage의 기본 모니터링은 기본 지표에 대해 제공되며, 복제 지표를 활성화하면 추가로 복제 지표가 제공됩니다.

다음은 세부 모니터링을 제공하는 서비스와 가이드가 포함되어 있습니다.

1.2 - 경보

경보

지표를 감시해 알림을 보내는 경보를 생성할 수 있습니다. 예를 들면, Virtual Server 서버의 CPU 사용량과 디스크 읽기 및 쓰기를 모니터링한 다음에 증가한 로드를 처리하기 위해 사용자에게 알림을 보냅니다.

• 경보 정책
  • 경보 상태
  • 경보 평가
    • 평가 범위
    • 조건
  • 경보 알림
  • 경보 평가 시 누락 데이터 처리 방법
• 경보 이력

경보 정책

경보 정책은 동일한 Account의 지표를 감시할 수 있으며, 하나의 지표에 대해 경보 평가합니다. 이러한 경보 정책은 지정된 임곗값과 지표 조건을 비교하여 조건에 충족하는 경우 알림을 발송합니다.

경보 정책을 비활성화하면 경보 정책에 대한 평가는 지속되지만, 지정된 알림 수신자에게 알림 발송은 제한할 수 있습니다. 경보 정책이 설정된 자원에 대해 일시적으로 알림 발송을 중단하고자 하는 경우, 경보 정책 비활성화를 활용할 수 있습니다.

경보 정책을 활성화하면 경보 정책에 대한 평가가 시작되고, 설정된 조건에 따라 경보 상태가 Alert으로 변경되고 경보 상태가 변경될 때마다 알림을 발송합니다.

경보 정책 상태는 경보 정책에 대한 활성화/비활성화 여부를 확인할 수 있습니다.

경보 정책에 대해서 경보 단계를 설정할 수 있습니다. 경보 단계에 따라 경보에 대한 색(빨간색/분홍색/보라색)을 다르게 표현하여 색깔로 단계를 시각적으로 구분할 수 있도록 합니다. 경보 정책의 경보 단계에 맞게 필터링하여 경보 단계별로 경보 정책을 조회할 수 있습니다.

경보 상태

경보 상태는 경보 정책의 경보 평가에 따라 상태가 변경됩니다. 경보 상태는 Normal(정상), Insufficient data(데이터 부족), Alert(경보) 세 가지 상태로 나뉩니다.

경보 평가

예를 들어, 1분 수집 주기를 가진 지표에 대해 1분 평가 범위로 5번의 평가 횟수 중 위반 횟수 4번으로 설정하는 경우 평가 간격은 5분입니다. 5분 수집 주기를 가진 지표에 대해 10분의 평가 범위로 3번의 평가 횟수 중 3번으로 위반 횟수를 설정하는 경우 평가 간격은 30분입니다.

평가 범위

경보 정책의 평가 범위는 경보 평가를 위한 평가 시간 범위입니다.

• 지표의 수집 주기 또는 수집 주기의 배수로 설정하는 것을 권장합니다.
• 최대 604,800(7일)초 까지 입력할 수 있습니다.

조건

경보 평가를 하기 위한 조건은 조건 연산자와 임곗값 설정이 필요합니다.

네임스페이스가 Virtual Server이고, 지표가 CPU Usage(단위: %)인 경우, 아래와 같이 경보 평가 조건이 완성됩니다.

경보 알림

경보 평가 조건에 만족하는 경우 경보 상태를 Alert로 변경하고, 경보 정책에 설정된 알림 수신자에게 알림을 발송합니다.

경보 평가 시, 누락 데이터 처리 방법

일부 자원은 특정 조건에서 지표 데이터를 ServiceWatch로 전송하지 못할 수 있습니다. 예를 들어, 특정 자원이 비활성 상태이거나, 자원이 존재하지 않는 경우 ServiceWatch로 전송하지 않습니다. 일정 기간 동안 지표가 수집되지 않으면 경보 평가에 의해 경보 상태는 Insufficient data로 변경됩니다.

ServiceWatch에서는 경보 평가 시 누락 데이터를 처리하는 방법을 제공합니다. 누락 데이터 처리 방법은 다음과 같습니다:

• Ignore: 현재의 경보 상태를 유지합니다. (기본값)
• Missing: 누락 데이터 포인트를 누락으로 처리합니다. 평가 범위 내의 모든 데이터 포인트가 누락이면, 경보 상태는 Insufficient data 상태로 전환합니다.
• Breaching: 누락 데이터 포인트에 대해 임곗값 조건에 만족하는 것으로 처리합니다.
• Not breaching: 누락 데이터 포인트에 대해 임곗값 조건에 만족하지 않는 정상으로 처리합니다.

경보 이력

경보 상태에 대한 변경 이력은 경보 이력에 기록됩니다. 경보 이력은 30일 동안 조회 가능합니다.

1.3 - 로그

로그

ServiceWatch의 로그를 사용하면 로그를 제공하는 서비스의 자원으로부터 수집된 로그 파일을 모니터링, 저장하고 액세스할 수 있습니다.

로그 그룹

로그 그룹은 동일한 보존 정책 설정을 공유하는 로그 스트림들의 컨테이너입니다. 각 로그 스트림은 하나의 로그 그룹에 속해야 합니다. 예를 들어, Kubernetes Engine의 각 클러스터의 로그에 대해 별도의 로그 스트림이 있으면 로그 스트림을 /scp/ske/{클러스터 이름} 라는 하나의 로그 그룹으로 묶을 수 있습니다.

로그 보관 정책

로그 보존 정책은 ServiceWatch에 로그 이벤트를 보관하는 기간을 설정할 수 있습니다. 기간이 만료된 로그 이벤트는 자동으로 삭제됩니다. 로그 그룹에 할당된 보존 기간은 로그 그룹에 속한 로그 스트림과 로그 이벤트에 적용됩니다.

보존 기간은 다음 중에서 선택할 수 있으며, 일 단위로 설정됩니다.

로그 스트림

로그 스트림은 동일한 소스에서 발생한 순서대로 정렬된 로그 이벤트들의 모음입니다. 예를 들어, 특정 Kubernetes Engine 클러스터에서 발생하는 모든 로그 이벤트는 하나의 로그 스트림을 구성할 수 있습니다.

로그 이벤트

로그 이벤트는 자원에서 발생하는 로그의 기록한 개별 레코드입니다. 로그 이벤트 레코드에는 이벤트가 발생한 시점에 대한 타임스탬프와 로그 메시지, 두 개의 속성이 포함되어 있습니다. 각 메시지는 UTF-8로 인코딩되어야 합니다.

로그 패턴

로그 패턴을 생성하여 패턴에 일치하는 로그 데이터를 필터링할 수 있습니다. 로그 패턴은 ServiceWatch가 수집한 로그 데이터에서 검색할 단어 또는 패턴을 정의하고 로그 발생에 대한 현황을 그래프로 확인할 수 있고, 경보 정책을 생성할 수 있는 지표로 생성합니다.

로그 패턴은 데이터를 소급하여 적용하지 않습니다. 로그 패턴을 생성한 이후에 수집되는 로그 이벤트에 대해 적용됩니다.

로그 패턴 네임스페이스

네임스페이스는 지표를 구분하고 그룹화하기 위한 논리적인 구분입니다. ServiceWatch에서는 서비스와 연계된 네임스페이스, 사용자 정의 지표를 위한 네임스페이스, 로그 패턴을 위한 네임스페이스로 구분됩니다.

• Virtual Server 등 서비스와 연계된 네임스페이스
• 사용자 정의 지표로 이루어진 네임스페이스로 사용자 정의 지표 API 또는 ServiceWatch Agent를 통해 수집된 지표의 네임스페이스
• 로그 패턴에 의해서 만들어진 지표의 네임스페이스

로그 패턴에서 로그 패턴에 대한 지표를 생성할 때 로그 패턴을 위한 네임스페이스로 신규 생성하거나, 생성되어 있는 로그 패턴 네임스페이스 중 선택할 수 있습니다.

지표명

모니터링된 로그 정보가 ServiceWatch의 생성되는 지표의 이름입니다. 지표가 존재하게될 네임스페이스 안에 지표명이 중복되지 않도록 설정해야합니다.

지표값

패턴에 일치하는 로그가 발견될 때마다 지표에 게시하는 숫자 값입니다. 예를 들어, 특정 단어(예: Error)의 출현 횟수를 계산할 경우 각 출현마다 이 값이 1이 됩니다. 전송된 바이트를 계산하는 경우 로그 이벤트에서 발견된 실제 바이트 수만큼 증가시킬 수 있습니다.

기본값

로그 수집할 때 일치하는 로그를 찾을 수 없는 기간 동안 로그 패턴에 기록되는 값입니다. 기본값을 0으로 설정하면 이러한 모든 기간에서 일치하는 데이터가 없는 기간 때문에 지표가 불규칙해지는 것을 방지할 수 있습니다.

로그 패턴으로 생성한 지표에 차원을 설정하는 경우 해당 지표에 기본값을 설정할 수 없습니다.

차원

차원은 지표를 추가로 정의하는 키-값 쌍입니다. 로그 패턴에서 생성된 지표에 차원을 추가할 수 있습니다. 차원은 지표에 대한 고유한 식별자의 일부이므로 로그에서 고유한 이름/값 쌍을 추출할 때마다 해당 지표의 새로운 변형이 생성되는 것입니다.

로그 패턴 형식을 공백 구분 패턴과 JSON 형식 패턴을 선택한 경우에 차원을 설정할 수 있으며, 패턴에서 설정한 파라미터 중 하나로 설정 가능합니다. 지표에 차원을 최대 3개까지 할당할 수 있습니다. 기본값이 설정되어있는 경우 차원을 설정할 수 없습니다. 차원을 설정하려면 기본값을 사용하지 않도록 설정해야합니다.

패턴 형식

ServiceWatch가 각 로그 이벤트에서 데이터를 해석하는 방법을 설명한 것입니다. 패턴 형식은 아래와 같이 3가지 중에 선택할 수 있습니다.

• 문자열 패턴: 특정 문자열이 포함된 로그
• 공백 구분 패턴: 타임스탬프, IP 주소, 문자열 등 공백으로 구분되는 로그
• JSON 형식 패턴: 특정 JSON 필드를 포함하는 로그

사용 가능한 정규식 구문

정규식을 사용하여 로그 데이터를 검색하고 필터링하는 경우 표현식을 %로 묶어야 합니다.

정규식을 포함하는 패턴에는 다음만 포함할 수 있습니다.

• 영숫자 - 영숫자는 문자(A~Z 또는 a~z) 또는 숫자(0~9)에 해당하는 문자입니다.
  • A-Z, a-z, 0-9와 같이 사용할 수 있습니다.
• 지원되는 기호 문자는 다음과 같습니다.
  • :, _, #, =, @, /, ;, ,, -
  • 예를 들어, %servicewatch!%은 !이 지원되지 않으므로 사용할 수 없습니다.
• 지원되는 연산자는 다음과 같습니다.
  • 여기에는 ^, $, ?, [, ], {, }, |, \, *, +, .가 포함됩니다.
  • (, ) 연산자는 지원되지 않습니다.

문자열 패턴

정규식을 이용한 문자열 패턴

정규식 앞뒤에 %(백분율)로 묶인 정규식 문자열 패턴을 사용하여 로그 이벤트에서 일치하는 패턴을 검색할 수 있습니다. 다음은 ERROR 키워드로 구성된 모든 로그 이벤트를 검색하는 패턴의 예시입니다. 사용 가능한 정규식 구문을 참고바랍니다.

%ERROR%

위 패턴은 아래와 같은 로그 이벤트 메시지와 매칭됩니다.

• [2026-02-13 14:22:01] ERROR 500 POST /api/v1/checkout (192.168.1.10) - NullPointerException at com.app.controller.CheckoutController.java:55
• [ERROR] Configuration file not found: /etc/app/config.yaml

형식이 없는 로그 이벤트에서의 문자열 패턴

JSON 등과 같은 형식이 아닌 로그 이벤트에서 문자열을 검색하기 위한 문자열 패턴입니다. 아래는 로그 이벤트 메시지 예시이며, 다양한 문자열 패턴 구분에 맞게 매칭되는 로그 이벤트를 확인할 수 있습니다.

ERROR CODE 400 BAD REQUEST
ERROR CODE 401 UNAUTHORIZED REQUEST
ERROR CODE 419 MISSING ARGUMENTS
ERROR CODE 420 INVALID ARGUMENTS

공백 구분 패턴

공백으로 구분된 로그 이벤트에서 일치하는 문자열을 검색하도록 패턴을 생성합니다.

공백 구분 패턴 예시(1)

다음은 공백으로 구분된 로그 이벤트의 예시입니다.

2023-10-27T10:00:01Z [INFO] 1234 login success 192.168.1.1

위 로그 이벤트는 timestamp, logLevel, user_id, action, status, ip를 포함한 공백으로 구분되는 로그 이벤트입니다. 대괄호([]) 와 큰따옴표("") 사이의 문자는 단일 필드로 간주됩니다.

공백으로 구분된 로그 이벤트에서 일치하는 문자열을 검색하는 패턴을 생성하려면 패턴을 대괄호([])로 묶고 쉼표(,)로 이름이 구분된 필드를 지정합니다. 다음 패턴은 6개의 필드를 구문 분석합니다.

[timestamp, logLevel, user_id, action, status = success, ip]와 같은 패턴은 5번째 필드인 status가 success인 로그 이벤트를 찾을 수 있습니다.

공백 구분 패턴 예시(2)

abc xxx.log james 2023-10-27T10:00:01Z POST 400 1024
abc xxx.log name 2023-10-27T10:00:02Z POST 410 512

위 로그 이벤트는 host, logName, user, timestamp, request, statusCode, size를 포함하는 공백으로 구분되는 로그 이벤트입니다.

[host, logName, user, timestamp, request, statusCode=4*, size]와 같은 패턴은 6번째 필드인 statusCode가 4로 시작하는 로그 이벤트를 찾을 수 있습니다.

공백으로 구분된 로그 이벤트에서 필드 수를 정확히 알지 못하는 경우 말줄임표(…)를 사용할 수 있습니다. […, statusCode=4*, size]와 같은 패턴은 처음 5개의 필드를 말줄임표로 표현한 패턴입니다.

AND(&&) 연산자와 OR(||) 연산자를 사용하여 복합 표현식을 만들 수도 있습니다. […, statusCode=400 || statusCode=410, size]와 같은 패턴은 6번째 필드인 statusCode가 400 이거나 410인 로그 이벤트를 찾을 수 있습니다.

정규식으로 사용하여 패턴에 조건을 제공할 수 있습니다. [host, logName, user, timestamp, request, statusCode=%4[0-9]{2}%, size]와 같은 패턴은 6번째 필드인 statusCode가 4로 시작하는 숫자인 로그 이벤트를 찾을 수 있습니다.

JSON 형식 패턴

JSON 로그 이벤트에서 일치하는 문자열 또는 숫자값을 검색하도록 패턴을 생성할 수 있습니다. 패턴은 중괄호({})로 묶습니다.

문자열 기반 JSON 형식 패턴

• $.를 활용하여 JSON의 필드를 표현합니다.
• 연산자는 = 또는 !=를 사용할 수 있습니다.
• 필드와 비교할 문자열은 큰따옴표("")로 묶을 수 있습니다. 영숫자 이외의 형식과 밑줄 기호가 포함된 문자열은 큰따옴표로 묶어야 합니다. 별표(*)를 와일드카드로 사용하여 텍스트와 일치시킵니다.

{ $.resourceType = "trail" }
{ $.resourceType = "%trail%" }
{ $.arrayKey[0] = "value" }

숫자 값을 검색하는는 JSON 형식 패턴

• $.를 활용하여 JSON의 필드를 표현합니다.
• 숫자 연산자를 사용할 수 있습니다.
  • 보다 큼(>), 보다 작음(<), 같음(=), 같지 않음(!=), 이상(>=), 이하(<=)
• 더하기(+) 또는 빼기(-) 기호를 포함할 수 있습니다. 별표(*)를 와일드카드로 사용할 수 있습니다.

{ $.errorCode = 400} 
{ $.errorCode >= 400} 
{ $.errorCode != 500 }
{ $.sourceIPAddress != 123.123.* }

로그 그룹 내보내기

로그 그룹에서 Object Storage로 로그 데이터를 내보내서 로그 보관 및 로그 분석에 사용할 수 있습니다. 동일한 Account에 있는 로그 데이터에 대해 로그 그룹 내보낼 수 있습니다.

로그 그룹 내보내기를 시작하려면 Object Storage 버킷을 생성해서 로그 데이터를 저장해야 합니다.

로그 그룹 내보내기 작업은 로그 양에 따라 시간이 오래 걸릴 수 있습니다. 로그 그룹 내보내기할 때 로그 그룹 내에 특정 스트림을 지정하거나, 시간 범위를 지정하여 로그 그룹 내보내기 작업 시간을 줄일 수 있습니다.

로그 그룹 내보내기는 동일한 Account에 한 번에 1건만 실행할 수 있습니다. 다른 로그 그룹 내보내기를 실행하려면 현재 진행중인 내보내기 작업이 완료되어야 합니다.

로그 그룹 내보내기 이력을 삭제는 내보내기 성공 또는 내보내기 취소 완료 후, 삭제할 수 있습니다. 로그 그룹 내보내기 취소는 로그 그룹을 내보낸 저장 파일이 삭제되는 것은 아닙니다. 로그 그룹을 내보낸 저장 파일을 삭제하려면 Object Storage에서 저장된 파일을 직접 삭제하세요.

1.4 - 이벤트

이벤트는 Samsung Cloud Platform 서비스에서 환경의 변화를 나타냅니다.

대부분의 Samsung Cloud Platform 서비스에서 생성된 이벤트를 ServiceWatch가 수신합니다. 각 서비스의 이벤트는 동일한 Account의 ServiceWatch에서 확인하고 처리할 수 있습니다.

ServiceWatch로 이벤트를 전송하는 서비스 목록과 해당 서비스가 전송하는 이벤트는 ServiceWatch Event Reference를 참조하세요.

각 서비스는 Best Effort 전달을 기반으로 ServiceWatch에 이벤트를 전송합니다. Best Effort 전달이란 서비스가 모든 이벤트를 ServiceWatch로 보내려고 시도하지만 드물게 이벤트가 전달되지 않는 경우가 있음을 의미합니다.

유효한 이벤트가 ServiceWatch에 전달되면 ServiceWatch는 해당 이벤트를 규칙과 비교한 후 이벤트 규칙에 설정된 알림 수신자에게 알림을 전송합니다.

이벤트 규칙

각 서비스로부터 ServiceWatch로 전달된 이벤트에 대해 ServiceWatch가 수행하는 작업을 지정할 수 있습니다. 이를 위해 이벤트 규칙을 생성합니다. 이벤트 규칙은 어떤 이벤트를 어떤 대상으로 전달할지를 지정합니다.

이벤트 규칙은 이벤트가 도착하면 이벤트를 평가합니다. 각 이벤트 규칙은 이벤트가 규칙의 패턴과 일치하는지 확인합니다. 이벤트가 일치하면 ServiceWatch는 이벤트를 처리합니다.

이벤트 데이터 기준(이벤트 패턴이라고 함)을 기반으로 들어오는 이벤트에 대해 일치하는 규칙을 생성할 수 있습니다. 이벤트가 이벤트 패턴에 정의된 기준과 일치하는 경우는 규칙에 지정된 대상에 이벤트를 전달합니다.

• 이벤트 규칙은 기본적으로 이벤트가 발생하였을 때 알림을 수신할 알림 수신자를 지정할 수 있습니다.
• 이벤트 규칙은 추가로 이벤트 발생 시 이벤트를 수신할 대상을 Samsung Cloud Platform의 여러 서비스들로 확대 예정입니다. (26년 예정)

이벤트 규칙을 생성하기 위해서는 How-to Guides > 이벤트 규칙 생성하기을 참조하세요.

이벤트 소스

ServiceWatch에서 이벤트 소스는 Samsung Cloud Platform 서비스명으로 선택 가능합니다. 수신하고자 하는 이벤트의 서비스명을 이벤트 소스로 선택할 수 있습니다.

이벤트 유형

Samsung Cloud Platform 서비스는 각각 자원 유형을 가지고 있습니다. 이벤트 유형은 자원 유형과 동일하게 분류되며 이벤트 규칙에 사용할 이벤트 소스의 이벤트의 유형을 선택합니다.

다음은 Virtual Server의 이벤트 유형입니다.

그 외 ServiceWatch에서 사용 가능한 이벤트 유형은 ServiceWatch Event를 참고하세요.

이벤트

이벤트는 이벤트 소스의 이벤트 유형에서 발생하는 전체 이벤트를 선택할 수 있고, 특정 이벤트를 선택할 수 있습니다.

다음은 Virtual Server의 Server 이벤트 유형의 이벤트의 일부입니다.

그 외 ServiceWatch에서 사용 가능한 이벤트는 ServiceWatch Event를 참고하세요.

적용 자원

모든 자원 또는 특정 자원에서 선택한 이벤트에 대해 이벤트 패턴을 설정합니다.

이벤트 패턴

이벤트 소스, 이벤트 유형, 이벤트, 적용 자원을 모두 선택하면 이벤트 규칙을 위한 이벤트 패턴 설정 완료됩니다.

다음은 ServiceWatch의 이벤트 규칙에 설정된 이벤트 패턴의 예시입니다.

{
	"source": [ // 네임스페이스
		"Virtual Server" 
	],
	"detail-type": [ // 이벤트 유형
		"Server" 
	],
	"detail": {
		"event": [ // 개별 이벤트
			"Compute Virtual Server Create End"
		]
	},
	"resources": [ // 개별 자원
		"srn:{offerring}::{account_id}:{region}::virtualserver:server/{resource_id}"
	]
}

{
	"source": [ // 네임스페이스
		"Virtual Server" 
	],
	"detail-type": [ // 이벤트 유형
		"Server" 
	],
	"detail": {
		"event": [ // 개별 이벤트
			"Compute Virtual Server Create End"
		]
	},
	"resources": [ // 개별 자원
		"srn:{offerring}::{account_id}:{region}::virtualserver:server/{resource_id}"
	]
}

이벤트 규칙을 생성하기 위해서는 How-to Guides > 이벤트 규칙 생성하기을 참조하세요.

이벤트 알림

이벤트 패턴에 만족하는 경우 이벤트 규칙에 설정된 알림 수신자에게 알림을 발송합니다.

1.5 - ServiceWatch 연계 서비스

ServiceWatch와 연계하는 서비스를 확인할 수 있습니다.

지표와 로그 모니터링

아래는 ServiceWatch와 지표와 로그 모니터링을 연계하는 서비스를 확인할 수 있습니다.

이벤트

아래는 ServiceWatch와 이벤트를 연계하는 서비스를 확인할 수 있습니다.

1.6 - 사용자 정의 지표와 로그

ServiceWatch는 사용자가 직접 정의한 사용자 정의 지표를 수집할 수 있고 사용자가 생성한 자원으로부터 로그 파일을 수집할 수 있습니다.

사용자 정의 지표와 로그를 수집할 수 있는 방법은 2가지로 제공됩니다.

첫번째는 ServiceWatch Agent를 자원에 직접 설치하여 수집할 자원을 설정하여 수집할 수 있습니다.
두번째는 ServiceWatch에서 제공하는 OpenAPI/CLI를 통해 사용자 정의 지표와 로그를 수집할 수 있습니다.

ServiceWatch Agent

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

ServiceWatch Agent 제약 사항

ServiceWatch Agent 네트워크 환경

ServiceWatch Agent는 기본적으로 OpenAPI를 사용하여 수집하는 구조로 설계되었으며 따라서 서버 자원에 설치하여 사용하기 위해서는 인터넷 통한 외부 통신이 가능해야합니다. 자원이 위치한 VPC에 Internet Gateway를 생성하고 서버 자원에 NAT IP를 설정하여 외부와 통신할 수 있도록 설정하시기 바랍니다.

ServiceWatch Agent 지원 OS Image

ServiceWatch Agent를 사용 가능한 OS Image는 다음과 같습니다.

Virtual Server 제공 OS Image와 동일하게 제공합니다. Virtual Server > OS Image 제공 버전을 참고하세요.

ServiceWatch Agent 사용을 위한 Quick Guide

아래에서는 Linux 환경에서 Virtual Server의 OS 지표와 로그 수집을 위한 Quick guide를 소개합니다.

Node Exporter 설치 및 설정하기

1. Node Exporter 설치를 참고하여 서버에 사용자 정의 지표 수집을 위한 Node Exporter를 설치합니다.
   • Node Exporter를 설치하면 ServiceWatch에서 기본 모니터링으로 제공하는 지표 이외에 Node Exporter를 통해 OS 지표를 수집할 수 있습니다.
2. ServiceWatch Agent 설정을 참고하여 ServiceWatch_Agent 압축파일을 다운로드 받은 뒤, ServiceWatch Manager 설정 및 실행합니다.
   • 압축파일 내의 examples/os-metric-min-examples 폴더를 참고하면 최소(2개) 지표를 설정하여 ServiceWatch Agent를 실행할 수 있습니다.

ServiceWatch 사용자 정의 지표 및 로그 API

ServiceWatch에서 제공하는 OpenAPI/CLI를 통해 사용자 정의 지표와 로그를 수집할 수 있습니다.

사용자 정의 지표 데이터와 사용자 정의 로그를 ServiceWatch OpenAPI/CLI를 통해 ServiceWatch로 전달하여 Console에서 시각화된 정보를 확인할 수 있습니다.

사용자 정의 지표 메타 데이터 생성

Samsung Cloud Platform의 서비스(예시: Virtual Server 등)에서 제공하는 지표가 아닌 사용자의 자원이나 애플리케이션에서 발생하는 지표 데이터를 ServiceWatch로 수집하기 위해서 사용자 정의 지표 메타 데이터를 생성해야 합니다.

사용자 정의 지표 메타 데이터 생성을 위한 자세한 내용은 CreateCustomMetricMetas를 참고하세요.

사용자 정의 지표 생성

사용자 정의 지표 메타 데이터를 생성한 후 발생한 지표 데이터를 CreateCustomMetrics API를 사용하여 ServiceWatch로 전달할 수 있습니다.

전달된 지표 데이터는 설정한 네임스페이스로 구분되어 조회할 수 있습니다.

사용자 정의 지표 데이터 생성을 위한 자세한 내용은 CreateCustomMetrics를 참고하세요.

지표 데이터 조회

사용자 정의 지표를 포함한 지표 데이터 Console과 ListMetricInfos, ListMetricInfos API를 사용하여 조회할 수 있습니다.

지표 데이터 조회를를 위한 자세한 내용은 ListMetricInfos와 ListMetricData를 참고하세요.

로그 스트림 생성

사용자 정의 로그 수집을 위해서는 ServiceWatch 로그 그룹이 필요합니다. 로그 그룹은 Console에서만 생성할 수 있습니다. 미리 로그 그룹을 생성한 후 로그 스트림 생성 API를 사용하여 ServiceWatch로 전달할 로그 스트림을 생성할 수 있습니다.

로그 스트림 생성을 위한 자세한 내용은 CreateCustomLogStream을 참고하세요.

로그 이벤트 생성

사용자 정의 로그 수집을 위해 로그 그룹과 로그 스트림을 생성한 후 개별 로그 메시지(로그 이벤트)를 ServiceWatch로 전달하기 위해서 로그 이벤트 생성 API를 사용합니다.

로그 이벤트 생성을 위한 자세한 내용은 CreateCustomLogEvents을 참고하세요.

2 - 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를 설치하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Agent Setup & Guideline 버튼을 클릭하세요. Agent Setup & Guideline 팝업창이 열립니다.
3. Agent Setup & Guideline 팝업창의 설치 파일 URL을 복사하여 해당 주소로 이동하세요. Agent, 매니저, 설정 파일을 다운로드할 수 있습니다.
   • ServiceWatch Agent 설치에 대한 자세한 내용은 ServiceWatch Agent 사용하기를 참고하세요.

2.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
   SRN	Samsung Cloud Platform에서의 고유 자원 ID ServiceWatch에서는 대시보드의 SRN을 의미
   자원명	자원 이름 ServiceWatch에서는 대시보드의 이름 의미
   자원 ID	서비스에서의 고유 자원 ID
   생성자	대시보드를 생성한 사용자
   생성 일시	대시보드를 생성한 일시
   수정자	대시보드 정보를 수정한 사용자
   수정 일시	대시보드 정보를 수정한 일시

   표. 대시보드 상세 - 상세 정보 팝업창 항목

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

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

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

   구분	상세 설명
   소스 정보	대시보드 소스 코드를 JSON 형식으로 표시
   코드 복사	소스 코드를 클립보드에 복사

   표. 대시보드 상세 - 대시보드 소스 보기 팝업창 항목

대시보드 복제하기

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

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

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일 중 선택 가능 삭제: 해당 범례를 삭제

   표. 개별 위젯 추가 항목

위젯 복제하기

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

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

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에 저장하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
3. 대시보드 목록 페이지에서 위젯 정보를 다운로드할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
4. 대시보드 상세 페이지에서 위젯 정보를 다운로드할 위젯의 우측 상단에 있는 더보기 > Object Storage 내보내기 버튼을 클릭하세요. Object Storage 내보내기 팝업창이 열립니다.
5. 위젯 정보를 저장할 버킷을 선택한 후, 완료 버튼을 클릭하세요. 저장을 알리는 팝업창이 열립니다.
6. 팝업창에서 확인 버튼을 클릭하세요. 데이터 내보내기가 시작됩니다.

2.2 - 경보

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

경보 정책 생성하기

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

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명까지 추가할 수 있습니다.

8. 추가 정보 입력 영역에서 태그 정보를 추가하세요.
9. 요약 정보를 확인한 후, 생성 버튼을 클릭하세요. 경보 정책 생성을 알리는 팝업창이 열립니다.
10. 확인 버튼을 클릭하세요. 경보 정책 생성이 완료됩니다.

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

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

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 경보 > 경보 정책 메뉴를 클릭하세요. 경보 정책 목록 페이지로 이동합니다.
   • 경보 정책 메뉴에 표시된 경보 단계 버튼을 클릭하여 해당 경보 단계에 해당하는 경보 정책 목록만 필터링하여 볼 수도 있습니다.
3. 경보 정책 목록 페이지에서 상세 정보를 확인할 경보 정책명을 클릭하세요. 경보 정책 상세 페이지로 이동합니다.

   구분	상세 설명
   경보 정책 상태	경보 정책의 상태 Active: 경보 정책이 활성화된 상태 Inactive: 경보 정책이 비활성화된 상태 활성화 또는 비활성화 버튼을 클릭하여 변경 가능
   경보 정책 삭제	해당하는 경보 정책을 삭제
   경보 상태	현재 경보 상태 Normal: 지표가 설정된 조건에 충족하지 않은 경우 Insulfficient data: 지표 데이터를 확인할 수 없는 경우(누락, 미존재, 미도착) Alert: 지표가 설정된 조건에 충족하는 경우 경보 상태가 Alert 상태인 경우, 경보 단계(>High, Middle, Low)를 함께 표시
   지표 모니터링 차트	설정한 기간 동안의 지표 모니터링 차트 모니터링 차트에 대한 자세한 내용은 지표 모니터링하기 참고
   정보 구분 탭	경보 정책에 대한 정보 구분 탭 상세 정보, 알림, 경보 이력, 태그, 작업 이력 각 탭을 클릭하면 해당 정보 확인 가능

   표. 경보 상세 항목

상세 정보

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

알림

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

경보 이력

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

태그

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

작업 이력

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

경보 정책 수정하기

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

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 경보 > 경보 정책 메뉴를 클릭하세요. 경보 정책 목록 페이지로 이동합니다.
3. 경보 정책 목록 페이지에서 상세 정보를 확인할 경보 정책명을 클릭하세요. 경보 정책 상세 페이지로 이동합니다.
4. 경보 정책 상세 페이지의 상세 정보 탭에서 지표 정보의 수정 버튼을 클릭하세요. 지표 정보 수정 팝업창이 열립니다.
5. 지표 정보 및 정책 설정을 수정한 후, 확인 버튼을 클릭하세요. 지표 수정을 알리는 팝업창이 열립니다.
   • 지표 수정 항목에 대한 자세한 내용은 경보 정책 생성하기를 참고하세요.
6. 확인 버튼을 클릭하세요. 경보 정책 수정이 완료됩니다.

경보 정책 비활성화하기

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

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

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

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 경보 > 경보 정책 메뉴를 클릭하세요. 경보 정책 목록 페이지로 이동합니다.
3. 경보 정책 상세 페이지에서 비활성화 버튼을 클릭하세요. 경보 정책 비활성화 알림 팝업창이 열립니다.
4. 확인 버튼을 클릭하세요. 경보 정책의 상태를 확인하세요.

경보 정책 활성화하기

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

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 경보 > 경보 정책 메뉴를 클릭하세요. 경보 정책 목록 페이지로 이동합니다.
3. 경보 정책 상세 페이지에서 활성화 버튼을 클릭하세요. 경보 정책 활성화 알림 팝업창이 열립니다.
4. 확인 버튼을 클릭하세요. 경보 정책의 상태를 확인하세요.

경보 정책 삭제하기

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

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

2.3 - 지표

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

지표 확인하기

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

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 지표 메뉴를 클릭하세요. 지표 페이지로 이동합니다.
3. 지표 페이지의 지표 목록에서 지표를 확인하세요.

지표 차트 관리하기

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

위젯으로 추가하기

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

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

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에 저장하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 지표 메뉴를 클릭하세요. 지표 페이지로 이동합니다.
3. 지표 페이지의 지표 목록에서 모니터링할 지표를 선택하세요. 선택한 지표에 대한 모니터링 차트가 하단의 선택된 지표 영역에 표시됩니다.
4. 선택된 지표 영역의 모니터링 차트에서 표 영역을 설정한 후, 더보기 > Object Storage 내보내기 버튼을 클릭하세요. Object Storage 내보내기 팝업창이 열립니다.
5. 데이터를 저장할 버킷을 선택한 후, 완료 버튼을 클릭하세요. 데이터 저장을 알리는 팝업창이 열립니다.
6. 팝업창에서 확인 버튼을 클릭하세요. 데이터 내보내기가 시작됩니다.

모니터링 차트 소스 보기

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

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

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

   구분	상세 설명
   소스 정보	모니터링 차트의 소스 코드를 JSON 형식으로 표시
   코드 복사	소스 코드를 클립보드에 복사

   표. 모니터링 차트 소스 보기 항목

2.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. 모든 서비스 > 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. 팝업창에서 확인 버튼을 클릭하세요. 데이터 내보내기가 시작됩니다.

   • 진행 사항은 로그 그룹 내보내기 목록 페이지에서 확인할 수 있습니다.

로그 그룹 삭제하기

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

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

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

2.5 - 이벤트

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

이벤트 규칙 생성하기

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

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

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

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

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

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

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

   표. 이벤트 패턴 설정 항목

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

   • 로그인 이력이 있는 사용자(이메일, 휴대전화 번호 등록 사용자)만 알림 수신자로 추가할 수 있습니다.
   • 알림 수신자는 최대 100명까지 추가할 수 있습니다.

7. 추가 정보 입력 영역에서 태그 정보를 추가하세요.
8. 요약 정보를 확인한 후, 생성 버튼을 클릭하세요. 이벤트 규칙 생성을 알리는 팝업창이 열립니다.
9. 확인 버튼을 클릭하세요. 이벤트 규칙 생성이 완료됩니다.

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

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

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 이벤트 규칙 메뉴를 클릭하세요. 이벤트 규칙 목록 페이지로 이동합니다.
3. 이벤트 규칙 목록 페이지에서 상세 정보를 확인할 이벤트명을 클릭하세요. 이벤트 규칙 상세 페이지로 이동합니다.

   구분	상세 설명
   이벤트 규칙 상태	이벤트 규칙의 상태 Active: 이벤트 규칙이 활성화된 상태 Inactive: 이벤트 규칙이 비활성화된 상태 활성화 또는 비활성화 버튼을 클릭하여 변경 가능
   이벤트 규칙 삭제	해당하는 이벤트 규칙을 삭제
   정보 구분 탭	경보 정책에 대한 정보 구분 탭 상세 정보, 알림, 태그, 작업 이력 각 탭을 클릭하면 해당 정보 확인 가능

   표. 이벤트 규칙 상세 항목

상세 정보

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

알림

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

태그

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

작업 이력

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

이벤트 패턴 수정하기

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

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

이벤트 규칙 삭제하기

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

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

2.6 - ServiceWatch Agent 사용하기

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

ServiceWatch Agent

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

ServiceWatch Agent를 위한 사전 환경 설정

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

1. Security Group 규칙 추가

   • Virtual Server/GPU Server에 설치된 ServiceWatch Agent에서 ServiceWatch로 수집된 데이터를 전송하기 위해 아래와 같이 Security Group에 규칙을 추가해야합니다.

     방향	유형	포트	대상 주소
     Outbound	사용자 지정 TCP	443	ServiceWatch OpenAPI Endpoint IP 주소

     표. ServiceWatch Agent 통신을 위한 Security Group 규칙

2. Firewall 규칙 추가

   • VPC의 Internet Gateway에 방화벽을 사용으로 설정한 경우 아래와 같이 Firewall 규칙을 추가해야 합니다.

     방향	유형	포트	동작	출발지 주소	목적지 주소
     Outbound	TCP	443	Allow	Virtual 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 주소는 다음과 같습니다.

ServiceWatch를 위한 Open Telemetry Collector 설정

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

1. ServiceWatch를 위한 Agent 파일을 다운로드 받을 수 있는 URL로 부터 Agent 파일을 다운로드 받습니다.

wget [ServiceWatch Agent 파일 다운로드 URL]

wget [ServiceWatch Agent 파일 다운로드 URL]

2. ServiceWatch를 위한 Open Telemetry Collector Agent 파일은 아래와 같이 확인할 수 있습니다.
   • ServiceWatch를 위한 Agent 파일을 압축 해제합니다.
     Sample Code Download

     Copy Code

     배경색 변경

     unzip ServiceWatch_Agent.zip

     unzip ServiceWatch_Agent.zip

   • ServiceWatch Agent를 사용하는 환경이 Linux OS인 경우, 아래와 같이 실행 권한을 부여해야합니다.
     Sample Code Download

     Copy Code

     배경색 변경

     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

     구분	상세 설명
     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_amd64	ServiceWatch용 Open Telemetry Collector for Linux
     otelcontribcol_windows_amd64.exe	ServiceWatch용 Open Telemetry Collector for Windows
     servicewatch-agent-manager-linux-amd64	ServiceWatch Agent Manager for Linux
     servicewatch-agent-manager-windows-amd64.exe	ServiceWatch Agent Manager for Windows

     표. ServiceWatch를 위한 Agent 파일 구성

3. ServiceWatch용 Open Telemetry Collector를 위해 ServiceWatch Agent Manager의 Agent 설정 파일을 정의합니다.

   구분	상세 설명
   namespace	사용자 정의 지표를 위한 사용자 정의 네임 스페이스 네임스페이스는 지표를 구분하고 그룹화하기 위한 논리적인 구분으로 사용자 정의 지표를 구분하기 위한 사용자 정의 지표로 지정 네임 스페이스는 영문, 숫자, 공백, 특수문자(_-/)를 포함하여 3~128자로 작성해야하며, 영문으로 시작해야 합니다.
   accessKey	IAM 인증키 Access Key
   accessSecret	IAM 인증키 Secret Key
   resourceId	서버의 Samsung Cloud Platform에서의 자원 ID 예시: Virtual Server의 자원 ID
   openApiEndpoint	리전/오퍼링별 ServiceWatch OpenAPI Endpoint 예시: https://servicewatch.region.offering.samsungsdscloud.com region과 offering 정보는 Samsung Cloud Platform Console 접속 URL에서 확인 가능
   telemetryPort	ServiceWatch Agent의 Telemetry Port 보통 8888 Port로 사용. 8888 Port가 사용 중인 경우 변경 필요

   표. agent.json 설정 파일 항목
   Sample Code Download

   Copy Code

   배경색 변경

   {
      "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가 사용 중인 경우 변경 필요)
   }

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

   • Agent를 통해 지표 수집하고자 하는 경우 metric.json을 설정합니다.

     구분	상세 설명
     prometheus > scrape_configs > targets	지표 수집 대상의 Endpoint 서버의 경우 같은 서버에 Prometheus Exporter 설치하므로 해당 endpoint로 설정 예시: localhost:9100
     prometheus > scrape_configs > jobName	Job Name 설정. 보통 지표 수집 시 사용하는 Prometheus Exporter 종류로 설정 예시: node-exporter
     metricMetas > metricName	수집하고자 하는 지표 이름 설정. 지표명은 영문, 숫자, 특수문자(_)를 포함하여 3~128자로 작성해야하며, 영문으로 시작해야 합니다. 예시: node_cpu_seconds_total
     metricMetas > dimensions	Exporter의 지표 데이터의 출처를 식별하기 위해 제공하는 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 설정 파일 항목
     Sample Code Download

     Copy Code

     배경색 변경

     {
        "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"
           }
        ]
     }

   • 자원명 표기를 위해서는 아래와 같이 commonLabels에 resource_name을 설정하고, metricMetas.dimensions에도 resource_name을 설정하면 ServiceWatch에서 지표 조회할 때 자원명을 함께 확인할 수 있습니다.
     Sample Code Download

     Copy Code

     배경색 변경

     ...
        "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"
           },
        ...
        ]
     ...

5. ServiceWatch용 로그 수집을 위한 Log 설정 파일을 정의합니다.

   • 로그 수집을 하고자 하는 경우 log.json 설정을 해야합니다.

     구분	상세 설명
     fileLog > include	수집할 로그 파일 위치
     fileLog > operators	수집할 로그 메시지를 파싱하기 위해 정의
     fileLog > operators > regex	로그 메시지 형식을 정규식으로 표현
     fileLog > operators > timestamp	ServiceWatch로 전송될 로그 메시지의 Time Stamp의 형식
     logMetas > log_group_value	ServiceWatch로 로그 전송을 위해 생성한 로그 그룹 이름
     logMetas > log_stream_value	ServiceWatch 로그 그룹내 로그 스트림 이름

     표. log.json 설정 파일 항목
     Sample Code Download

     Copy Code

     배경색 변경

     {
        "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 로그 그룹 내의 로그 스트림명
        }
     }