Storage Transfer Service용 Cloud Logging

이 페이지에서는 Storage Transfer Service 로그를 위해 Cloud Logging을 구성하고 보는 방법을 설명합니다.

Storage Transfer Service용 Cloud Logging은 모든 전송에서 지원됩니다. FIND 작업은 에이전트 기반 전송에 대해 로깅되지 않습니다.

파일 시스템 전송에서 추가로 파일 시스템 전송 로그를 구성할 수 있습니다.

시작하기 전에

시작하기 전 Cloud Logging에 액세스할 수 있는지 확인합니다. 로그 뷰어(roles/logging.viewer) Identity and Access Management 역할이 권장됩니다. Logging 액세스에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.

다음은 IAM 액세스 권한을 확인하고 부여하는 방법에 대한 설명입니다.

• 현재 액세스 권한 보기를 통해 각 주 구성원의 액세스 권한을 확인합니다.
• 프로젝트의 관련 주 구성원에게 역할을 부여합니다.

로깅 가능한 작업

다음 작업을 로깅할 수 있습니다.

• FIND: 디렉터리의 파일 나열, 버킷의 객체 나열 또는 버킷의 관리형 폴더 나열과 같이 할 일을 찾는 작업입니다. 에이전트 기반 전송에는 지원되지 않습니다.
• COPY: Cloud Storage에 파일 또는 객체를 복사하는 작업입니다.
• DELETE: 소스 또는 대상에서 파일 또는 객체를 삭제하는 작업입니다. 두 파일 시스템 간 전송의 경우 중간 Cloud Storage 버킷에서 파일 삭제도 로깅합니다.

로깅 가능한 상태

작업마다 다음 상태 중 하나 이상을 로깅할 수 있습니다.

• SUCCEEDED: 작업이 성공했습니다.
• FAILED: 작업에 실패했습니다.
• SKIPPED: COPY 작업에만 적용되며 에이전트 기반 전송 작업에만 지원됩니다. gcloud 또는 REST API를 사용하여 설정해야 합니다. 이 상태는 복사가 건너뛰었음을 의미합니다. 이 상태는 싱크에 파일이 이미 있고 전송 작업이 기존 파일을 무시하도록 구성된 경우에 발생합니다.

로깅 사용 설정

로깅을 사용 설정하려면 로깅할 작업과 상태를 지정합니다.

gcloud transfer jobs create SOURCE DESTINATION \
  --log-actions=copy,delete,find \
  --log-action-states=succeeded,failed,skipped

{
  "name":"transferJobs/myFirstTransfer",
  "status": "ENABLED",
  "projectId": "test-id-001",
  "loggingConfig": {
     "logActions": ["FIND", "DELETE", "COPY"],
     "logActionStates": ["SUCCEEDED", "FAILED", "SKIPPED"], #SKIPPED is only supported for agent-based transfers
  },
  "transferSpec": {
      "awsS3DataSource":