How-to guides

• 1: 대시보드 및 위젯 관리하기
• 2: 경보
• 3: 지표
• 4: 로그
• 5: 이벤트
• 6: ServiceWatch Agent 사용하기

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

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

대시보드 생성하기

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

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

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

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
3. 대시보드 목록 페이지에서 대시보드 생성 버튼을 클릭하세요.
4. 대시보드의 이름을 입력하세요.
   • 대시보드의 이름은 영문, 숫자, 특수 문자(-_)를 사용하여 3~40자 이내로 입력하세요.
5. 대시보드를 구성할 위젯을 추가하세요. 위젯 추가 방법에 따라 해당하는 팝업창이 열립니다.
   • 개별 위젯 추가: 지표, 자원을 조합한 단일 위젯을 추가할 수 있습니다. 버튼을 클릭하면 개별 위젯 추가 팝업창이 열립니다.

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

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

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

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

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

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

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

   • 대시보드의 이름은 영문, 숫자, 특수 문자(-_)를 사용하여 3~40자 이내로 입력하세요.

5. 대시보드를 구성할 위젯을 추가하세요. 위젯 추가 방법에 따라 해당하는 팝업창이 열립니다.

   • 다중 위젯 추가: 지표 단위로 원하는 자원을 선택하여 여러 개의 위젯을 한 번에 추가할 수 있습니다. 버튼을 클릭하면 다중 위젯 추가 팝업창이 열립니다.

     구분	필수 여부	상세 설명
     네임스페이스 및 자원 목록	필수	지표를 추가할 자원을 선택 네임스페이스 및 자원 앞의 + 버튼을 클릭하여 하위 자원 및 지표 목록 확인 지표 목록에서 위젯에 추가할 지표를 체크하면 선택 지표 및 선택된 자원 영역 표시 여러 개의 지표 선택 가능
     선택 지표	필수	네임스페이스 및 자원 목록에서 선택한 지표 목록 표시 지표를 클릭하면 선택된 자원 영역에 해당 지표에 포함된 자원 목록 표시
     선택된 자원	필수	선택 지표 목록에서 선택한 지표에 자원 추가 선택 버튼을 클릭한 후, 해당 지표에 추가할 수 있는 자원을 선택하여 최대 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 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
3. 대시보드 목록 페이지에서 상세 정보를 확인할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.

대시보드 관리하기

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

대시보드 수정하기

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

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

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
3. 대시보드 목록 페이지에서 상세 정보를 확인할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
4. 대시보드 상세 페이지의 우측 상단에 있는 수정 버튼을 클릭하세요. 대시보드 수정 페이지로 이동합니다.
5. 대시보드의 정보나 위젯을 수정한 후, 저장 버튼을 클릭하세요.

   구분	상세 설명
   대시보드 이름	대시보드의 이름 수정 가능 영문, 숫자, 특수 문자(-_)를 사용하여 34자 이내로 입력 기존에 등록된 대시보드 이름 사용 불가
   위젯 이름	위젯 이름 수정 가능 영문, 숫자, 공백, 특수 문자(-_.|)를 사용하여 3 ~ 255자 이내로 입력
   위젯 관리	위젯에 마우스 커서를 위치하면 위젯 테두리 우측에 관리 버튼이 표시 수정: 위젯 수정 팝업창에서 위젯의 지표 및 자원 수정 가능 위젯 수정에 자세한 내용은 위젯 관리하기의 개별 위젯 수정 참고 복제: 현재 위젯을 복제하여 대시보드에 추가 삭제: 현재 위젯을 대시보드에서 삭제 확장: 현재 위젯의 크기를 확장하여 표시 축소: 확장하여 표시한 경우, 다시 클릭하면 위젯의 크기를 축소
   위젯 추가	대시보드에 새로운 위젯을 추가 개별 위젯 추가: 지표, 자원을 조합한 단일 위젯을 추가 다중 위젯 추가: 지표 단위로 원하는 자원을 선택하여 여러 개의 위젯을 한 번에 추가 대시보드 불러오기: 다른 대시보드의 위젯을 불러와서 추가 위젯 추가 방법에 대한 자세한 내용은 위젯 생성하기 참고

   표. 대시보드 수정 항목

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

대시보드에 대한 상세 정보를 확인할 수 있습니다.

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

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. 대시보드 상세 페이지의 우측 상단에 있는 더보기 > 복제 버튼을 클릭하세요. 대시보드 복제 팝업창이 열립니다.
5. 대시보드 복제 방법을 선택한 후 필수 정보를 입력하세요. 복제 방법에 따라 필수 정보가 달라집니다.

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

대시보드 삭제하기

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

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

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

위젯 관리하기

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

위젯 수정하기

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

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

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
3. 대시보드 목록 페이지에서 위젯을 수정할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
4. 대시보드 상세 페이지에서 수정할 위젯의 우측 상단에 있는 더보기 > 위젯 수정 버튼을 클릭하세요. 위젯 수정 팝업창이 열립니다.
5. 위젯의 지표와 자원을 수정한 후, 확인 버튼을 클릭하세요. 위젯 수정이 완료됩니다.

위젯 복제하기

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

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

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
3. 대시보드 목록 페이지에서 복제할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
4. 대시보드 상세 페이지에서 복제할 위젯의 우측 상단에 있는 더보기 > 위젯 복제 버튼을 클릭하세요. 위젯 복제 팝업창이 열립니다.
5. 위젯 복제 방법을 선택한 후 필수 정보를 입력하세요. 복제 방법에 따라 필수 정보가 달라집니다.

6. 필수 정보 입력이 끝나면 완료 버튼을 클릭하세요. 위젯 추가를 알리는 팝업창이 열립니다.
7. 팝업창의 확인 버튼을 클릭하세요. 해당 대시보드에 위젯이 복제되어 추가됩니다.

위젯 파일 다운로드하기

위젯 정보를 파일 형태로 다운로드할 수 있습니다.

위젯 정보를 다운로드하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 대시보드 > 대시보드 목록 메뉴를 클릭하세요. 대시보드 목록 페이지로 이동합니다.
3. 대시보드 목록 페이지에서 위젯 정보를 다운로드할 대시보드를 클릭하세요. 대시보드 상세 페이지로 이동합니다.
4. 대시보드 상세 페이지에서 위젯 정보를 다운로드할 위젯의 우측 상단에 있는 더보기 > 파일 다운로드 버튼을 클릭하세요. 파일 다운로드 팝업창이 열립니다.
5. 파일 다운로드 방식을 선택한 후, 확인 버튼을 클릭하세요. 다운로드가 시작됩니다.
   • 다운로드 방식은 동시에 선택할 수 있습니다.

위젯 지표 상세보기

위젯의 자원 및 지표 정보를 지표 페이지에서 확인할 수 있습니다

위젯 지표를 지표 페이지에서 확인하려면 다음 절차를 따르세요.

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

위젯 소스 정보

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

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

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

2 - 경보

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

경보 정책 생성하기

지표에 대한 경보 정책을 생성하여 경보 발생 기준을 설정할 수 있습니다.

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

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 경보 > 경보 정책 메뉴를 클릭하세요. 경보 정책 목록 페이지로 이동합니다.
3. 경보 정책 목록 페이지에서 경보 정책 생성 버튼을 클릭하세요. 경보 정책 생성 페이지로 이동합니다.
4. 기본 정보 입력 영역에서 경보 정책의 이름과 설명을 입력한 후, 지표 선택 버튼을 클릭하세요. 지표 선택 팝업창이 열립니다.
5. 지표 선택 팝업창에서 경보 정책을 생성할 지표를 선택한 후, 확인 버튼을 클릭하세요. 지표 및 조건 설정 영역이 표시됩니다.

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

7. 알림 설정 영역에서 경보 발생 시 알림을 전달받을 사용자를 선택하세요.
   • 로그인 이력이 있는 사용자(이메일, 휴대전화 번호 등록 사용자)만 알림 수신자로 추가할 수 있습니다.
   • 알림 수신자는 최대 100명까지 추가할 수 있습니다.

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

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

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

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

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

상세 정보

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

알림

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

경보 이력

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

태그

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

작업 이력

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

경보 정책 수정하기

경보 정책의 대상 지표와 정책 설정을 수정할 수 있습니다.

경보 정책을 수정하려면 다음 절차를 따르세요.

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

경보 정책 삭제하기

사용하지 않는 경보 정책을 삭제할 수 있습니다.

경보 정책을 삭제하려면 다음 절차를 따르세요.

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

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. 위젯 추가 방법을 선택한 후 필수 정보를 입력하세요. 추가 방법에 따라 필수 정보가 달라집니다.

6. 필수 정보 입력이 끝나면 완료 버튼을 클릭하세요. 위젯 추가를 알리는 팝업창이 열립니다.
7. 팝업창의 확인 버튼을 클릭하세요. 해당 대시보드에 위젯이 추가됩니다.

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

모니터링 차트 정보를 파일 형태로 다운로드할 수 있습니다.

모니터링 차트 정보를 다운로드하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 지표 메뉴를 클릭하세요. 지표 페이지로 이동합니다.
3. 지표 페이지의 지표 목록에서 모니터링할 지표를 선택하세요. 선택한 지표에 대한 모니터링 차트가 하단의 선택된 지표 영역에 표시됩니다.
4. 선택된 지표 영역의 모니터링 차트에서 표 영역을 설정한 후, 더보기 > 파일 다운로드 버튼을 클릭하세요. 파일 다운로드 팝업창이 열립니다.
5. 파일 다운로드 방식을 선택한 후, 확인 버튼을 클릭하세요. 다운로드가 시작됩니다.
   • 다운로드 방식은 동시에 선택할 수 있습니다.

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. 선택된 지표 영역의 모니터링 차트에서 표 영역을 설정한 후, 더보기 > 소스 보기 버튼을 클릭하세요. 위젯 소스 보기 팝업창이 열립니다.

4 - 로그

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

로그 그룹 생성하기

지표에 대한 로그 그룹을 생성할 수 있습니다.

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

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 로그 > 로그 그룹 메뉴를 클릭하세요. 로그 그룹 목록 페이지로 이동합니다.
3. 로그 그룹 목록 페이지에서 로그 그룹 생성 버튼을 클릭하세요. 로그 그룹 생성 페이지로 이동합니다.
4. 로그 그룹 생성에 필요한 기본 정보와 태그 정보를 입력한 후, 완료 버튼을 클릭하세요. 로그 그룹 생성을 알리는 팝업창이 열립니다.

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

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

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

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

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

상세 정보

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

로그 스트림

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

태그

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

작업 이력

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

로그 스트림 관리하기

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

로그 스트림 생성하기

로그 그룹에 새로운 로그 스트림을 생성할 수 있습니다.

호그 스트림을 생성하려면 다음 절차를 따르세요.

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. 확인 버튼을 클릭하세요. 로그 그룹이 삭제됩니다.

로그 그룹 내보내기

로그 그룹 데이터를 Object Storage에 저장할 수 있습니다.

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

1. 모든 서비스 > Management > ServiceWatch 메뉴를 클릭하세요. Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 로그 > 로그 그룹 내보내기 메뉴를 클릭하세요. 로그 그룹 내보내기 목록 페이지로 이동합니다.
3. 로그 그룹 내보내기 목록 페이지에서 로그 그룹 내보내기 버튼을 클릭하세요. 로그 그룹 내보내기 페이지로 이동합니다.

5. 데이터를 저장할 버킷을 선택한 후, 완료 버튼을 클릭하세요. 데이터 저장을 알리는 팝업창이 열립니다.
6. 팝업창에서 확인 버튼을 클릭하세요. 데이터 내보내기가 시작됩니다.
   • 진행 사항은 로그 그룹 내보내기 목록 페이지에서 확인할 수 있습니다.

로그 그룹 삭제하기

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

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

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 코드 형식으로 입력됩니다.

6. 알림 설정 영역에서 이벤트 발생 시 알림을 전달받을 사용자를 선택하세요.
   • 로그인 이력이 있는 사용자(이메일, 휴대전화 번호 등록 사용자)만 알림 수신자로 추가할 수 있습니다.
   • 알림 수신자는 최대 100명까지 추가할 수 있습니다.

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

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

이벤트 규칙에 대한 상세 정보를 확인하고 관리할 수 있습니다.

이벤트 규칙에 대한 상세 정보를 확인하려면 다음 절차를 따르세요.

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

상세 정보

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

알림

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

태그

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

작업 이력

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

이벤트 패턴 수정하기

이벤트 패턴을 수정할 수 있습니다.

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

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

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

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

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

ServiceWatch를 위한 Open Telemetry Collector 실행

ServiceWatch Agent 실행 (for Linux)

1. ServiceWatch Agent를 실행합니다.

   • agent.json, metric.json, log.json 파일 위치와 servicewatch-agent-manager-linux-amd64,otelcontribcol_linux_amd64 파일의 위치를 확인하여 ServiceWatch Agent를 시작합니다.
     Sample Code Download

     Copy Code

     배경색 변경

     ./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

   • 지표만 수집하고자 하는 경우, log.json 파일을 다른 파일명으로 변경하거나 agent.json, metric.json과 같은 디렉토리에 있지 않도록 옮기고, 아래와 같이 실행해주세요.
     Sample Code Download

     Copy Code

     배경색 변경

     ./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

   • 로그만 수집하고자 하는 경우, metric.json 파일을 다른 파일명으로 변경하거나 agent.json, log.json과 같은 디렉토리에 있지 않도록 옮기고, 아래와 같이 실행해주세요.
     Sample Code Download

     Copy Code

     배경색 변경

     ./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

2. ServiceWatch Agent를 중지합니다.

   Sample Code Download

   Copy Code

   배경색 변경

   ./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 실행 (for Windows)

1. ServiceWatch Agent를 실행합니다.

   Sample Code Download

   Copy Code

   배경색 변경

   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

2. ServiceWatch Agent를 중지합니다.

   Sample Code Download

   Copy Code

   배경색 변경

   servicewatch-agent-manager-windows-amd64.exe -action stop -dir ./examples

   servicewatch-agent-manager-windows-amd64.exe -action stop -dir ./examples