릴리스 노트
제품 공지
로그 관리 개요
소개
로그 관리 기능은 버킷을 더 편리하게 관리할 수 있도록 지정한 원본 버킷의 액세스 상세 정보를 기록하고 해당 정보를 로그 파일 포맷으로 지정할 수 있습니다.
대상 버킷에서 로그 기록 경로는 다음과 같습니다.
대상 버킷/경로 접두사{YYYY}/{MM}/{DD}/{time}_{random}_{index}
로그는 5분마다 생성되어 한 줄씩 기록됩니다. 모든 기록은 여러 개의 필드를 포함하고 각 필드는 빈칸으로 분할됩니다. 주의할 점은 단일 로그 파일의 최대 크기가 256MB이며, 5분 이내 발생된 로그량이 256MB을 초과할 경우 로그는 여러 개의 로그 파일로 분할된다는 것입니다. 현재 지원하는 로그 필드는 다음과 같습니다.
필드 시리얼 넘버 | 이름 | 의미 | 예시 |
1 | eventVersion | 기록 버전 | 1.0 |
2 | bucketName | 버킷 이름 | examplebucket-1250000000 |
3 | qcsRegion | 요청 리전 | ap-beijing |
4 | eventTime | 이벤트 시간(요청 종료 시간, UTC 0시 타임스탬프) | 2018-12-01T11:02:33Z |
5 | eventSource | 사용자의 액세스 도메인 | examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com |
6 | eventName | UploadPart | |
7 | remoteIp | 출처 IP | 192.168.0.1 |
8 | userSecretKeyId | 사용자 액세스 KeyId | ************************************ |
9 | reservedFiled | 예약된 필드 | 예약된 필드는 -로 나타납니다. |
10 | reqBytesSent | 요청 바이트 수(Bytes) | 83886080 |
11 | deltaDataSize | 스토리지 양 변경 요청(Bytes) | 808 |
12 | reqPath | 요청한 파일 경로 | /folder/text.txt |
13 | reqMethod | 요청 방법 | put |
14 | userAgent | 사용자 UA | cos-go-sdk-v5.2.9 |
15 | resHttpCode | HTTP 반환 코드 | 404 |
16 | resErrorCode | 에러 코드 | NoSuchKey |
17 | resErrorMsg | 에러 정보 | The specified key does not exist. |
18 | resBytesSent | 반환 바이트 수(Bytes) | 197 |
19 | resTotalTime | 요청 총 소요 시간(밀리 초, 마지막 바이트 응답 시간-첫 바이트 요청 시간에 해당) | 4295 |
20 | logSourceType | 로그 소스 유형 | USER(사용자 액세스 요청), CDN(CDN 원본 요청) |
21 | storageClass | 스토리지 유형 | STANDARD, STANDARD_IA, ARCHIVE |
22 | accountId | 버킷 소유자 ID | 100000000001 |
23 | resTurnAroundTime | 요청 서버 소요 시간(밀리초, 첫 바이트 응답 시간-마지막 바이트 요청 시간에 해당) | 4295 |
24 | requester | 방문자 계정. 방문자가 루트 계정인 경우, 계정 형식은 루트 계정 UIN:루트 계정 UIN입니다.방문자가 서브 계정인 경우, 계정 형식은 루트 계정 UIN:서브 계정 UIN입니다.익명으로 접근하는 경우 -로 표시됩니다. | 100000000001:100000000001 |
25 | requestId | 요청 ID | NWQ1ZjY4MTBfMjZiMjU4NjRfOWI1N180NDBiYTY= |
26 | objectSize | 객체 크기(Bytes) | 808, 멀티파트 업로드를 사용할 경우 objectSize 필드는 업로드를 완료했을 때만 나타나며, 각 멀티파트 업로드 기간에 해당 필드는 -로 나타남 |
27 | versionId | 객체 버전 ID | 랜덤 문자열 |
28 | targetStorageClass | 대상 스토리지 유형, 복사 작업 요청을 시작하면 해당 필드를 기록함 | STANDARD, STANDARD_IA, ARCHIVE |
29 | referer | 요청 HTTP referer | *.example.com 또는 111.111.111.1 |
30 | requestUri | 요청 URI | "GET /fdgfdgsf%20/%E6%B5%AE%E7%82%B9%E6%95%B0 HTTP/1.1" 설명: 서명이 query_string 형식으로 되어 있는 경우, requestUri에 서명이 표시되며 그렇지 않으면 requestUri에 서명 정보가 포함되지 않습니다. |
31 | vpcId | VPC 요청 ID | "0"(VPC 아님)/"12345"(VPC, "0"이 아닌string) |
주의：
COS의 로그 관리 기능이 현재 지원하는 리전은 베이징, 난징, 상하이, 광저우, 청두, 충칭, 선전 금융, 상하이 금융, 중국 홍콩, 싱가포르, 서울, 방콕, 도쿄, 실리콘밸리, 버지니아 및 프랑크푸르트입니다.
로그 관리 기능은 소스 버킷과 대상 버킷이 반드시 같은 리전에 있어야 합니다.
로그를 보관한 대상 버킷은 소스 버킷 자체가 될 수 있지만, 권장하지는 않습니다.
현재 XML API 및 XML API 기반으로 구현된 SDK, 툴 등에서 버킷 액세스를 요청했을 경우에만 로그가 기록됩니다. JSON API 및 JSON API 기반으로 구현된 SDK, 툴 등에서의 액세스는 로그를 기록하지 않습니다.
사용자의 필요 및 업무 진행 상황에 따라 COS는 액세스 로그 중 필드를 추가할 수 있으므로 로그 리졸브 시 해당 프로세스를 진행하십시오.
COS는 로그 데이터의 100% 정확성을 보장하지 않으며 참고용으로만 제공되며 측정 및 과금 기준으로 사용되지 않습니다.
로그 관리 활성화
콘솔 사용
1. COS 콘솔에 로그인합니다.
2. 왼쪽 사이드바에서 버킷 리스트를 선택합니다.
3. 로그 관리를 활성화해야 하는 버킷을 찾아 해당 버킷 이름을 클릭하여 버킷 관리 페이지로 이동합니다.
4. 왼쪽 사이드바에서 로그 관리 > 로그 스토리지를 선택하고 편집을 클릭한 후 현재 상태를 ‘활성화’로 변경합니다.
5. 다음 설명을 참고하여 로그 저장 설정 항목을 설정합니다.
타깃 버킷: 로그 관리를 활성화한 원본 버킷과 로그를 저장한 타깃 버킷은 동일 리전에 있어야 합니다. COS에서 원본 버킷을 로그 저장용 타깃 버킷으로 설정하는 것은 권장하지 않습니다.
경로 접두사: 로그를 편리하게 조회할 수 있도록 사용자 정의 경로 접두사를 입력합니다. 이를 입력하지 않을 경우, 타깃 버킷의 루트 경로가 기본값으로 설정됩니다.
서비스 라이선스: 로그 저장 기능을 처음 시작할 때, CLS 제품 서비스가 귀하의 버킷에 액세스 로그를 전달할 수 있도록 권한을 부여해야 합니다. 안내에 따라 권한 부여를 완료하면 됩니다.
6. 입력한 정보에 이상이 없으면 저장을 클릭하여 로그 관리 기능 활성화를 완료합니다.
설명：
로그 저장 기능을 시작한 후, 첫 번째 로그 전달이 완료되기까지 약 1시간이 소요될 것으로 예상됩니다. 이후에는 5분마다 한 번씩 로그가 생성되며, 로그 전달의 구체적인 시간은 데이터 양에 따라 달라집니다.
7. 로그 저장용으로 설정한 타깃 버킷을 검색하면 생성된 로그 파일을 확인할 수 있습니다.
8. 로그 파일을 다운로드한 후 필드 설명에 따라 조회할 수 있습니다. 자세한 내용은 로그 관리 개요를 참고하십시오.
주의：
현재 버킷 소유자만 로그 저장소를 설정할 수 있으며 다른 사용자 로그인 콘솔에는 로그 저장소 구성 항목이 표시되지 않습니다.
관련 설명
로그 관리 기능을 활성화할 때 CAM 콘솔에서 타깃 버킷의 로그에 대한 읽기/쓰기 작업 수행이 가능한 로그 역할을 생성해야 합니다.
로그 관리 기능은 비활성화하였지만 로그 역할을 삭제하지 않는 경우, 타깃 버킷 로그에 대한 해당 역할의 읽기/쓰기 작업 권한은 여전히 유효합니다.
API 사용
API를 사용해 지정 버킷에 로그 관리 기능을 활성화할 경우 다음 순서를 참고하십시오.
1. 로그 역할 생성
{"version": "2.0","statement": [{"action": "name/sts:AssumeRole","effect": "allow","principal":{"service": "cls.cloud.tencent.com"}}]}
2. 로그 역할 바인딩 권한
policyName은 QcloudCOSAccessForCLSRole.roleName은 1단계의 CLS_QcsRole 또는 roleName 생성 시 반환된 roleID를 사용할 수 있습니다.
3. 로그 관리 활성화
인터페이스 호출 및 로그 관리 기능 활성화와 구체적인 인터페이스 정보는 PUT Bucket logging을 참고하십시오. 로그를 보관한 대상 버킷과 소스 버킷은 같은 리전에 있어야 합니다.
피드백