Logging&Audit

• 1: Overview
• 2: How-to guides
• 2.1: Trail 관리
• 3: API Reference
• 4: CLI Reference
• 5: Release Note

1 - Overview

서비스 개요

Logging&Audit은 사용자가 수행하는 모든 작업 내역을 저장하여 클라우드 자원에 대한 변경 추적, 문제 해결, 보안 검사 등에 활용할 수 있습니다. 수집된 작업 내역은 90일 동안 확인할 수 있으며, Trail 생성 및 관리를 통해 사용자의 Object Storage에 보관할 수 있습니다.

제공 기능

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

• 작업 내역 로그 수집: 발생하는 모든 로그는 실시간으로 수집하여 저장됩니다. 여러 서버들과 서비스에서 수집된 전체 로그에 대해서는 웹 기반의 Console을 통해 리소스 유형, 리소스명, 기간, 작업자명 등 다양한 조건으로 검색이 가능합니다.
• 활동 기록 감사: 기록된 모든 활동 내역은 90일간 보관되어 언제든지 Console을 통해 확인이 가능합니다.
• 로그 관리: 클라우드 서비스를 사용하면서 생성되는 수 많은 로그는 Trail을 생성하여 사용자의 Object Storage에 보관할 수 있습니다.
• 로그 무결성 검증: Trail 생성 후 Object Storage에 저장된 로그 파일이 변경, 수정, 삭제가 되었는지 로그 파일 검증 기능을 통해 확인이 가능합니다.

구성 요소

활동 내역

사용자가 수행하는 모든 활동 내역을 저장하여 클라우드 자원에 대한 변경 추적, 문제 해결, 보안 검사 등에 활용할 수 있습니다. 별도의 설정 없이 90일간의 활동 내역을 저장하며, 다양한 검색 기능을 활용하여 로그를 분석할 수 있어 효과적인 로그 관리가 가능합니다.

Trail

Trail은 Console과 API 호출을 통해 발생하는 사용자 활동 기록을 Object Storage와 연동하여 장기간 보관할 수 있습니다. 또한, 저장하고자 하는 서비스 및 계정을 선택하여 클라우드 자원에 대한 변경 추적, 문제 해결, 보안 검사 등에 활용할 수 있습니다.

선행 서비스

해당 서비스를 생성하기 전에 미리 구성되어 있어야 하는 서비스 목록입니다. 자세한 내용은 각 서비스 별로 제공되는 가이드를 참고하여 사전에 준비해주세요.

2 - How-to guides

사용자는 Samsung Cloud Platform Console을 통해 활동 내역을 확인하고, 해당 활동 내역을 Trail 서비스를 이용하여 기간 제약 없이 저장할 수 있습니다. 보안 위험, 자원 변경 내역 등 문제 발생 시 이 활동 내역을 확인하여 문제 발생 원인을 파악할 수 있습니다.

활동 내역 조회하기

사용자의 활동 내역 목록을 확인하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > Logging&Audit 메뉴를 클릭하세요. Logging&Audit의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 활동 내역 메뉴를 클릭하세요. 활동 내역 목록 페이지로 이동합니다.
3. 활동 내역 목록 페이지에서 활동 내역을 확인하세요.

   구분	상세 설명
   파일 다운로드	활동 내역 목록을 JSON 또는 CSV 파일 형식으로 저장
   기간 필터	목록 검색 기간 선택 전체, 최근30분, 최근1시간, 최근12시간, 직접 입력 중에서 선택 직접 입력: 시작 일시와 종료 일시를 입력 가능
   시간대	검색 가능한 시간대 선택
   검색 입력창	검색어를 입력하여 목록 검색
   상세 검색	카테고리별로 검색어를 입력하거나 정보를 선택하여 목록 검색
   설정 아이콘	목록에 표시할 칼럼 항목 설정

   표. 활동 내역 목록 항목

활동 내역 비교

활동 내역 목록의 작업 이력을 5개까지 선택하여 정보를 비교할 수 있습니다.
비교하려는 작업 이력을 체크하여 선택하면, 활동 내역 비교 페이지에 추가되고 정보를 비교하여 확인할 수 있습니다.

활동 내역 상세 정보 확인하기

전체 활동 내역 목록과 상세 정보를 확인할 수 있습니다. 활동 내역 상세 페이지에서는 작업 이력 상세, 작업 내역 상세 탭으로 구성되어 있습니다.

활동 내역의 상세 정보를 확인하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > Logging&Audit 메뉴를 클릭하세요. Logging&Audit의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 활동 내역 메뉴를 클릭하세요. 활동 내역 목록 페이지로 이동합니다.
3. 활동 내역 목록 페이지에서 상세 정보를 확인할 활동 내역을 클릭하세요. 활동 내역 상세 페이지로 이동합니다.
   • 활동 내역 상세 페이지에는 작업 이력 상세, 작업 내역 상세 탭으로 구성됩니다.

작업 이력 상세

작업 이력 상세 페이지에서 작업 이력의 상세 정보를 확인할 수 있습니다.

작업 내역 상세

작업 내역 상세 페이지에서 작업 내역의 상세 정보를 확인할 수 있습니다.

2.1 - Trail 관리

사용자는 Samsung Cloud Platform Console을 통해 활동 내역을 확인하고, 해당 활동 내역을 Trail 서비스를 이용하여 기간 제약 없이 저장할 수 있습니다. 활동 내역은 90일 동안 보관되므로 장기간 보관을 위해서는 Trail 서비스를 생성하여 Object Storage에 보관해야 합니다.

Trail 생성하기

Samsung Cloud Platform Console에서 Logging&Audit의 Trail 서비스를 이용하여 활동 내역을 기간 제약 없이 저장할 수 있습니다.

Trail을 생성하려면 다음의 절차를 따르세요.

1. 모든 서비스 > Management > Logging&Audit 메뉴를 클릭하세요. Logging&Audit의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Trail 메뉴를 클릭하세요. Trail 목록 페이지로 이동합니다.
3. Trail 목록 페이지에서 Trail 생성 버튼을 클릭하세요. Trail 생성 페이지로 이동합니다.
   • 서비스 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

     구분	필수 여부	상세 설명
     Trail명	필수	Trail 이름 영문, 숫자와 특수문자(-)를 사용하여 5~26자로 입력
     대상 리전	필수	활동 내역이 발생한 리전 리전을 지정하지 않고 생성하는 서비스들은 대상 리전을 전체로 선택 특정 리전 선택이 필요하면, 리전 목록에서 선택 대상 리전은 생성 후, 변경 가능
     대상 자원 유형	필수	Trail에 저장할 활동 내역의 자원 유형 기본값: 전체 특정 자원 유형만 지정하도록 변경을 원할 경우 선택 버튼을 클릭하여 저장할 자원 유형을 선택 선택 가능한 자원 유형은 서비스 별 자원 유형 목록을 참고 대상 자원 유형은 생성 후, 변경 가능
     대상 사용자	필수	Trail에 저장할 활동 내역의 사용자 기본값: 전체 특정 사용자만 지정하도록 변경을 원할 경우 선택 버튼을 클릭하여 저장할 사용자를 선택 대상 사용자는 생성 후, 변경 가능
     저장 버킷 리전	필수	활동 내역을 저장할 Object Storage 버킷의 위치(리전) 저장 버킷은 생성 후, 변경 불가
     저장 버킷	필수	활동 내역을 저장할 Object Stroage 버킷명 저장 버킷은 생성 후, 변경 불가
     저장 형식	필수	저장할 파일 유형 (JSON, CSV) 저장 형식은 생성 후, 변경 가능
     로그파일 검증	선택	로그파일 검증 사용 여부 사용을 선택하면, Trail 로그파일의 변경 및 삭제 여부를 검증하기 위해 동일한 버킷에 Digest 파일을 저장 로그파일 검증 사용 여부는 생성 후, 변경 가능

     표. Trail 서비스 정보 입력 항목
   • 추가 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

     구분	필수 여부	상세 설명
     설명	선택	Trail에 대한 추가 정보나 설명 입력
     태그	선택	태그 추가 자원 당 최대 50개까지 추가 가능 태그 추가 버튼을 클릭한 후 Key, Value 값을 입력 또는 선택

     표. Trail 추가 정보 입력 항목

4. 요약 패널에서 생성한 상세 정보와 예상 청구 금액을 확인하고, 완료 버튼을 클릭하세요.
   • 생성이 완료되면, Trail 목록 페이지에서 생성한 자원을 확인하세요.

Trail 상세 정보 확인하기

Trail 서비스는 전체 목록과 상세 정보 확인하고 수정할 수 있습니다. Trail 상세 페이지에서는 상세 정보, 태그, 작업 이력 탭으로 구성되어 있습니다.

Trail 상세 정보를 확인하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > Logging&Audit 메뉴를 클릭하세요. Logging&Audit의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Trail 메뉴를 클릭하세요. Trail 목록 페이지로 이동합니다.
3. Trail 목록 페이지에서 상세 정보를 확인할 자원을 클릭하세요. Trail 상세 페이지로 이동합니다.
   • Trail 상세 페이지에는 상태 정보 및 부가 기능 정보가 표시되며, 상세 정보, 태그, 작업 이력 탭으로 구성됩니다.

     구분	상세 설명
     Trail 상태	사용자가 생성한 Trail의 상태 Active: Trail 작동 중 Stopped: Trail 작동 중지
     Trail 제어	Trail 상태를 변경할 수 있는 버튼 시작: 중지된 Trail을 시작합니다. Trail을 시작한 날의 활동 내역부터 다시 저장됩니다. 중지: 가동 중인 Trail을 중지합니다. 활동 내역 기록을 중지하고, 기존 저장된 활동 내역은 유지됩니다.
     Trail 삭제	Trail을 삭제하는 버튼

     표. Trail 상태 정보 및 부가 기능

상세 정보

Trail 목록 페이지에서 선택한 자원의 상세 정보를 확인하고, 필요한 경우 정보를 수정할 수 있습니다.

태그

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

작업 이력

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

Trail 자원 제어하기

Trail의 상태에 따라 시작, 중지를 할 수 있습니다. Trail의 자원 제어를 하려면 다음 절차를 따르세요.

Trail 시작하기

중지(Stopped)된 Trail을 시작할 수 있습니다. Trail을 시작한 날 의 활동 내역부터 다시 저장됩니다.

1. 모든 서비스 > Management > Logging&Audit 메뉴를 클릭하세요. Logging&Audit의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Trail 메뉴를 클릭하세요. Trail 목록 페이지로 이동합니다.
3. Trail 목록 페이지에서 중지된 Trail을 다시 시작할 자원(Trail)을 클릭하세요. Trail 상세 페이지로 이동합니다.
4. Trail 상세 페이지에서 상단의 시작 버튼을 클릭하여, 서버를 시작합니다. 상태 표시 항목에서 변경된 Trail의 상태를 확인하세요.
   • Trail 시작이 완료되면 상태가 Stopped에서 Active로 변경됩니다.
   • Trail 상태에 대한 자세한 내용은 Trail 상세 정보 확인하기를 참고하세요.

Trail 중지하기

작동(Active)중인 Trail을 중지할 수 있습니다. Trail에 활동 내역 기록을 중지하고, 기존 저장된 활동 내역은 유지됩니다.

1. 모든 서비스 > Management > Logging&Audit 메뉴를 클릭하세요. Logging&Audit의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Trail 메뉴를 클릭하세요. Trail 목록 페이지로 이동합니다.
3. Trail 목록 페이지에서 작동을 중지할 자원(Trail)을 클릭하세요. Trail 상세 페이지로 이동합니다.
4. Trail 상세 페이지에서 상단의 중지 버튼을 클릭하여, 서버를 중지합니다. 상태 표시 항목에서 변경된 Trail의 상태를 확인하세요.
   • Trail 중지가 완료되면 상태가 Active에서 Stopped로 변경됩니다.
   • Trail 상태에 대한 자세한 내용은 Trail 상세 정보 확인하기를 참고하세요.

Trail 자원 관리하기

생성된 Trail 자원의 제어 및 관리 기능이 필요한 경우, Trail 상세 페이지에서 작업을 수행할 수 있습니다.

대상 리전 수정하기

Trail의 대상 리전을 수정할 수 있습니다. Trail의 대상 리전을 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > Logging&Audit 메뉴를 클릭하세요. Logging&Audit의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Trail 메뉴를 클릭하세요. Trail 목록 페이지로 이동합니다.
3. Trail 목록 페이지에서 대상 리전을 변경할 자원(Trail)을 클릭하세요. Trail 상세 페이지로 이동합니다.
4. Trail 상세 페이지에서 대상 리전의 수정 버튼을 클릭하세요. 대상 리전 수정 팝업창으로 이동합니다.
5. 리전 목록에서 변경할 대상 리전을 선택하고, 확인 버튼을 클릭하세요. Trail 상세 페이지로 이동합니다.
6. Trail 상세 페이지에서 변경된 대상 리전을 확인하세요.

대상 자원 유형 수정하기

Trail의 대상 자원 유형을 수정할 수 있습니다. Trail의 대상 자원 유형을 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > Logging&Audit 메뉴를 클릭하세요. Logging&Audit의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Trail 메뉴를 클릭하세요. Trail 목록 페이지로 이동합니다.
3. Trail 목록 페이지에서 대상 자원 유형을 변경할 자원(Trail)을 클릭하세요. Trail 상세 페이지로 이동합니다.
4. Trail 상세 페이지에서 대상 자원 유형의 수정 버튼을 클릭하세요. 대상 자원 유형 수정 팝업창으로 이동합니다.
5. 대상 자원 유형을 추가 또는 변경하여 선택하고, 선택한 자원 유형이 하단 선택 항목에 표시되는지 확인하세요.
   • 선택 가능한 자원 유형은 서비스 별 자원 유형 목록을 참고하세요.
6. 대상 자원 유형의 추가 또는 변경을 완료하였다면, 확인 버튼을 클릭하세요. Trail 상세 페이지로 이동합니다.
7. Trail 상세 페이지에서 변경된 대상 자원 유형을 확인하세요.

대상 사용자 수정하기

Trail의 대상 사용자를 수정할 수 있습니다. Trail의 대상 사용자를 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > Logging&Audit 메뉴를 클릭하세요. Logging&Audit의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Trail 메뉴를 클릭하세요. Trail 목록 페이지로 이동합니다.
3. Trail 목록 페이지에서 대상 사용자를 변경할 자원(Trail)을 클릭하세요. Trail 상세 페이지로 이동합니다.
4. Trail 상세 페이지에서 대상 사용자의 수정 버튼을 클릭하세요. 대상 사용자 수정 팝업창이 열립니다.
5. 대상 사용자를 추가 또는 변경하여 선택하고, 선택한 사용자가 하단 선택 항목에 표시되는지 확인하세요.
6. 대상 사용자의 추가 또는 변경을 완료하였다면, 확인 버튼을 클릭하세요. Trail 상세 페이지로 이동합니다.
7. Trail 상세 페이지에서 변경된 대상 사용자를 확인하세요.

저장 형식 수정하기

Trail의 버킷에 저장하는 로그 파일 형식을 수정할 수 있습니다. Trail의 저장 형식을 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > Logging&Audit 메뉴를 클릭하세요. Logging&Audit의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Trail 메뉴를 클릭하세요. Trail 목록 페이지로 이동합니다.
3. Trail 목록 페이지에서 로그 파일 저장 형식을 변경할 자원(Trail)을 클릭하세요. Trail 상세 페이지로 이동합니다.
4. Trail 상세 페이지에서 저장 형식의 수정 버튼을 클릭하세요. 저장 형식 수정 팝업창이 열립니다.
5. 파일 형식을 변경하고, 확인 버튼을 클릭하세요. Trail 상세 페이지로 이동합니다.
6. Trail 상세 페이지에서 변경된 저장 형식을 확인하세요.

로그파일 검증 수정하기

Trail의 로그파일 검증 사용 여부를 수정할 수 있습니다. Trail의 로그파일 검증 사용 여부를 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > Logging&Audit 메뉴를 클릭하세요. Logging&Audit의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Trail 메뉴를 클릭하세요. Trail 목록 페이지로 이동합니다.
3. Trail 목록 페이지에서 로그 파일 저장 형식을 변경할 자원(Trail)을 클릭하세요. Trail 상세 페이지로 이동합니다.
4. Trail 상세 페이지에서 로그파일 검증의 수정 버튼을 클릭하세요. 로그파일 검증 수정 팝업창으로 이동합니다.
5. 사용을 선택하면, Trail 로그파일의 변경 및 삭제 여부를 검증하기 위해 동일한 버킷에 Digest 파일을 저장합니다. 사용 여부를 선택하고, 확인 버튼을 클릭하세요. Trail 상세 페이지로 이동합니다.
6. Trail 상세 페이지에서 변경된 저장 형식을 확인하세요.

Trail 설명 수정하기

Trail의 설명을 수정할 수 있습니다. Trail의 설명을 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Management > Logging&Audit 메뉴를 클릭하세요. Logging&Audit의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Trail 메뉴를 클릭하세요. Trail 목록 페이지로 이동합니다.
3. Trail 목록 페이지에서 설명을 수정할 변경할 자원(Trail)을 클릭하세요. Trail 상세 페이지로 이동합니다.
4. Trail 상세 페이지에서 설명의 수정 버튼을 클릭하세요. 설명 수정 팝업창이 열립니다.
5. 설명 수정을 완료하고, 확인 버튼을 클릭하세요. Trail 상세 페이지로 이동합니다.
6. Trail 상세 페이지에서 변경된 설명을 확인하세요.

Trail 삭제하기

사용하지 않는 Trail을 삭제하여 운영 비용을 절감할 수 있습니다. 단, Trail을 삭제하면 운영 중인 서비스가 즉시 중단될 수 있으므로 서비스 중단 시 발생하는 영향을 충분히 고려한 후 해지 작업을 진행해야 합니다.

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

1. 모든 서비스 > Management > Logging&Audit 메뉴를 클릭하세요. Logging&Audit의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Trail 메뉴를 클릭하세요. Trail 목록 페이지로 이동합니다.
3. Trail 목록 페이지에서 삭제하려는 자원(Trail)을 클릭하세요. Trail 상세 페이지로 이동합니다.
4. Trail 상세 페이지에서 Trail 삭제 버튼을 클릭하세요.
5. 삭제가 완료되면, Trail 목록 페이지에서 자원이 삭제되었는지 확인하세요.

서비스 별 자원 유형 목록

서비스 별 자원 유형 목록입니다. Trail 생성 및 대상 자원 유형 수정 시, 선택할 수 있는 대상 자원 유형 목록입니다.

3 - API Reference

4 - CLI Reference

5 - Release Note

Logging&Audit