보관처리된 백업의 작업 로그 백업 및 복원

이 페이지에서는 Cloud Logging에서 보관된 백업의 백업 및 복원 작업 로그를 확인하는 방법을 설명합니다. 이러한 백업은 백업 계획을 사용하여 보호되는 리소스용입니다. 관리 콘솔에서 백업 템플릿을 사용하여 보호되는 백업 및 복원 작업 로그를 보려면 백업 및 복구 작업 로그를 참고하세요.

권한 및 역할

백업 및 복원 작업 로그를 보려면 IAM 권한 roles/logging.viewer이 필요합니다. Logs Viewer 역할은 지정된 프로젝트에서 백업 계획으로 보호되는 모든 리소스의 백업 및 복원 작업 로그를 볼 수 있는 읽기 전용 액세스 권한을 부여합니다. 백업 및 복원 작업이 다른 프로젝트에서 실행되는 경우 관리자에게 로그를 볼 프로젝트에 roles/logging.viewer 권한을 할당해 달라고 요청하세요. 로그 데이터에 대한 액세스를 제어하는 IAM 권한 및 역할에 대한 자세한 내용은 IAM으로 액세스 제어를 참고하세요.

백업 및 복원 작업 로그 보기

Google Cloud 콘솔과 Google Cloud CLI를 사용하여 Cloud Logging에서 보관된 백업의 백업 및 복원 작업 로그를 볼 수 있습니다. 백업 작업을 보려면 백업이 실행된 Backup Vault 프로젝트 또는 리소스 프로젝트를 선택합니다. 복원 작업을 보려면 백업 볼트 프로젝트 또는 리소스가 복원된 프로젝트를 선택합니다.

콘솔

Google Cloud 콘솔에서 로그 탐색기를 사용하여 보관된 백업의 백업 및 복원 로그 항목을 검색할 수 있습니다.

  1. Google Cloud 콘솔에서 Logging > 로그 탐색기로 이동합니다.
  2. 기존 Cloud 프로젝트를 선택합니다.
  3. 쿼리 빌더 창의 로그 이름 선택 드롭다운에서 bdr_backup_restore_jobs를 선택합니다.

gcloud

Google Cloud CLI는 로깅 API에 명령줄 인터페이스를 제공합니다. 프로젝트의 백업 및 복원 로그 항목을 읽으려면 다음 명령어를 실행합니다.

```none
 gcloud logging read "logName:bdr_backup_restore_jobs" --project=PROJECT_ID
```

다음을 바꿉니다.

  • PROJECT_ID: 프로젝트의 이름입니다. 백업 작업을 보려면 백업이 실행된 백업 볼트 프로젝트 또는 리소스 프로젝트를 입력하면 됩니다. 복원 작업을 보려면 백업 볼트 프로젝트 또는 리소스가 복원된 프로젝트를 입력하면 됩니다.

백업 및 복원 작업 로그 형식

백업 및 복원 로그 항목에는 다음 필드가 포함됩니다.

필드 설명
jobId 작업과 연결된 ID입니다.
sourceResourceName 보호된 리소스의 상대 이름입니다.
jobCategory 작업의 카테고리입니다(SCHEDULED_BACKUP, ON_DEMAND_BACKUP, RESTORE 중 하나).
sourceResourceId 보호된 리소스의 ID입니다.
resourceType 리소스 유형 예를 들어 Compute Engine 인스턴스입니다.
jobStatus 작업의 상태입니다. SUCCESSFUL, FAILED, RUNNING, SKIPPED 중 하나일 수 있습니다.
backupRule 백업 작업을 트리거한 백업 규칙의 이름입니다.
backupVaultName 백업이 저장된 백업 보관소의 상대 이름입니다.
startTime 작업의 시작 시간입니다. YYYY-MM-DD HH:MM:SS.SSS UTC 형식입니다.
backupPlanName 리소스와 연결된 백업 계획의 상대 이름입니다. 복원 작업의 경우 백업 계획 이름 필드는 Null로 유지됩니다.
errorCode 실패한 작업과 연결된 오류 코드입니다. 작업에 오류가 발생하지 않은 경우 오류 코드가 Null로 표시됩니다.
errorType 오류 유형의 이름입니다. 예를 들면 PERMISSION_DENIED입니다. 작업에 오류가 발생하지 않으면 오류 유형이 Null으로 표시됩니다.
errorMessage 실패한 작업의 오류 메시지입니다. 작업에 오류가 발생하지 않으면 오류 메시지가 Null로 표시됩니다.
restoreResourceName 복원이 완료된 후 생성되는 리소스의 상대 이름입니다.
backupName 백업 작업의 경우 백업 이름은 UUID 형식의 백업에 대해 시스템에서 생성된 이름입니다. 복원 작업의 경우 백업 이름은 복원을 실행하는 데 사용된 백업의 이름입니다.

다음 샘플은 Compute Engine 인스턴스에서 예약된 백업의 로그 항목 예시입니다.

        {
        "insertId": "696883be-582d-4af4-b2b8-a4c497e49489",
        "jsonPayload": {
          "jobId": "696883be-582d-4af4-b2b8-a4c497e49489",
          "@type": "type.googleapis.com/google.cloud.backupdr.logging.v1.BDRBackupRestoreJobLog",
          "sourceResourceName": "projects/Source_project_ID/zones/asia-east1-c/instances/Instance_name",
          "jobCategory": "SCHEDULED_BACKUP",
          "sourceResourceId": "6114243930178522357",
          "resourceType": "Compute Engine",
          "jobStatus": "RUNNING",
          "backupRule": "backup-rule-1",
          "backupVaultName": "projects/Backupvault_project_ID/locations/asia-east1/backupVaults/Backupvault_name",
          "startTime": "2024-09-10T06:37:00.303416182Z",
          "backupPlanName": "projects/Backupplan_project_ID/locations/asia-east1/backupPlans/Backupplan_Name"
        },
        "resource": {
          "type": "backupdr.googleapis.com/BackupDRProject",
          "labels": {
            "resource_container": "projects/223618678509",
            "location": "asia-east1"
          }
        },
        "timestamp": "2024-09-10T06:37:00.303416182Z",
        "logName": "projects/Backupvault_Name/logs/backupdr.googleapis.com%2Fbdr_backup_restore_jobs",
        "receiveTimestamp": "2024-09-10T06:37:01.818767274Z"
      }

샘플 쿼리

선택한 로그를 보려면 쿼리 섹션에서 맞춤 쿼리를 작성하면 됩니다.

다음 쿼리를 사용하여 실패한 작업을 확인합니다.

    logName:"bdr_backup_restore_jobs" jsonPayload.jobStatus="FAILED"

다음 쿼리를 사용하여 백업 볼트에 저장된 작업을 확인합니다.

    logName:"bdr_backup_restore_jobs" jsonPayload.backupVaultName:"backupVaults/BACKUPVAULT_NAME"

다음 쿼리를 사용하여 백업 계획으로 생성된 작업을 확인합니다.

    logName:"bdr_backup_restore_jobs" jsonPayload.backupPlanName:"backupPlans/BACKUPPLAN_NAME"

백업 계획 세부정보 로그 보기

Google Cloud 콘솔 및 Google Cloud CLI를 사용하여 Cloud Logging에서 백업 계획 세부정보 로그를 볼 수 있습니다. 백업 작업을 보려면 백업 계획이 생성된 프로젝트를 선택합니다.

콘솔

Google Cloud 콘솔에서 로그 탐색기를 사용하여 백업 계획 세부정보 로그 항목을 검색할 수 있습니다.

  1. Google Cloud 콘솔에서 Logging > 로그 탐색기로 이동합니다.
  2. 기존 Cloud 프로젝트를 선택합니다.
  3. 쿼리 빌더 창의 로그 이름 선택 드롭다운에서 bdr_backup_plan_details를 선택합니다.

gcloud

Google Cloud CLI는 로깅 API에 명령줄 인터페이스를 제공합니다. 프로젝트의 백업 및 복원 로그 항목을 읽으려면 다음 명령어를 실행합니다.

 ```none
 gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
 ```

다음을 바꿉니다.

  • PROJECT_ID: 백업 계획이 생성된 프로젝트의 이름입니다.

백업 계획 세부정보 로그 형식

백업 및 복원 로그 항목에는 다음 필드가 포함됩니다.

필드 설명
backupPlanName 백업 계획의 상대 이름입니다.
ruleName 백업 작업에 사용되는 백업 규칙의 이름입니다.
recurrence 백업 반복 유형입니다. 시간, 일, 주, 월 또는 연 단위일 수 있습니다.
recurrenceSchedule 백업 규칙에 따른 백업의 반복 일정입니다.
backupWindow 백업 작업을 시작할 수 있는 기간입니다.
retentionDays 백업을 보관해야 하는 기간(일)입니다.
backupWindowTimezone 백업 기간에 적용되는 표준 시간대입니다.
backupVaultName 백업 계획과 연결된 백업 보관소의 상대 이름입니다.
resourcesProtectedCount 백업 계획으로 보호되는 리소스 수입니다.
protectedDataVolumeGib 백업 계획으로 보호되는 소스 데이터의 총 크기(GiB)입니다.

다음 샘플은 bdr_backup_plan_details 로그 항목의 예입니다.

        {
          "insertId": "15792541403682418506",
          "jsonPayload": {
            "resourcesProtectedCount": 3,
            "protectedDataVolumeGib": 30,
            "@type": "type.googleapis.com/google.cloud.backupdr.logging.v1.BDRBackupPlanDetailsLog",
            "backupVaultName": "projects/hk-staging-saas-report-1/locations/us-central1/backupVaults/hk-bv-1",
            "backupPlanName": "projects/hk-staging-saas-report-1/locations/us-central1/backupPlans/hk-bp-2",
            "backupRuleDetails": [
              {
                "retentionDays": 10,
                "recurrence": "Daily",
                "recurrenceSchedule": "Every day",
                "backupWindow": "00:00 to 24:00",
                "ruleName": "hk-br-2",
                "backupWindowTimezone": "Asia/Calcutta"
              }
            ]
          },
          "resource": {
            "type": "staging-backupdr.sandbox.googleapis.com/BackupPlan",
            "labels": {
              "location": "us-central1",
              "resource_container": "838468076466",
              "backup_plan_id": "hk-bp-2"
            }
          },
          "timestamp": "2025-06-09T08:04:10Z",
          "severity": "INFO",
          "logName": "projects/hk-staging-saas-report-1/logs/staging-backupdr.sandbox.googleapis.com%2Fbdr_backup_plan_details",
          "receiveTimestamp": "2025-06-09T09:40:14.711832094Z"
        }

샘플 쿼리

선택한 로그를 보려면 쿼리 섹션에서 맞춤 쿼리를 작성하면 됩니다.

다음 쿼리를 사용하여 특정 백업 계획과 연결된 백업 계획을 확인합니다.

    logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"

다음 쿼리를 사용하여 특정 백업 보관소와 연결된 백업 계획을 확인합니다.

    logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"

다음 쿼리를 사용하여 특정 규칙 이름을 포함하는 백업 계획을 확인합니다.

    logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME

Vault에 저장된 백업의 백업 계획 보고서 보기

Google Cloud 콘솔과 Google Cloud CLI를 사용하여 Cloud Logging에서 백업 계획 세부정보 로그를 볼 수 있습니다. 백업 작업을 보려면 백업 계획이 생성된 프로젝트를 선택합니다.

콘솔

Google Cloud 콘솔에서 로그 탐색기를 사용하여 백업 계획 세부정보 로그 항목을 검색할 수 있습니다.

  1. Google Cloud 콘솔에서 Logging > 로그 탐색기로 이동합니다.
  2. 기존 Cloud 프로젝트를 선택합니다.
  3. 쿼리 빌더 창의 로그 이름 선택 드롭다운에서 bdr_backup_plan_details를 선택합니다.

gcloud

Google Cloud CLI는 로깅 API에 명령줄 인터페이스를 제공합니다. 프로젝트의 백업 및 복원 로그 항목을 읽으려면 다음 명령어를 실행합니다.

 ```none
 gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
 ```

다음을 바꿉니다.

  • PROJECT_ID: 백업 계획이 생성된 프로젝트의 이름입니다.

백업 계획 보고서 형식

이 보고서는 구성된 백업 계획에 대한 포괄적인 통계를 제공하며, 규칙, 연결된 백업 볼트, 보호하는 리소스의 통계를 자세히 설명합니다.

보고서에는 다음 필드가 포함됩니다.

  • date: 백업 계획 정보가 업데이트된 가장 최근 날짜입니다.
  • backup_plan_name: 백업 계획의 지정된 이름입니다.
  • backup_plan_location: 백업 계획의 지리적 위치입니다.
  • backup_rules: 계획 내 각 백업 규칙의 세부정보를 포함하는 반복 레코드 (배열)입니다. 각 규칙 레코드는 다음으로 구성됩니다.
    • backup_rules.rule_name: 백업 규칙의 지정된 이름입니다.
    • backup_rules.recurrence: 백업에 지정된 반복 유형입니다(예: 'hourly', 'daily', 'weekly', 'monthly', 'yearly')
    • backup_rules.recurrence_schedule: 백업 규칙에 정의된 반복 일정입니다 (예: '매일 10시', '매주 월요일'
    • backup_rules.backup_window: 백업 작업이 시작될 수 있는 정의된 기간 (24시간 시계 형식)입니다 (예: "02:00-08:00").
    • backup_rules.backup_window_time_zone: 백업이 예약된 시간대입니다 (예: 'UTC', 'America/Los_Angeles')
    • backup_rules.retention_days: 이 규칙에 따라 백업을 보관할 지정된 기간 (일)입니다.
  • backup_vault_name: 백업 계획에 내재적으로 연결된 백업 볼트의 이름입니다.
  • backup_vault_location: 백업 계획과 연결된 Backup Vault의 지리적 위치입니다.
  • resources_protected_count: 이 특정 백업 계획으로 보호되는 리소스의 수입니다.
  • protected_data_volume_gib: 이 백업 계획으로 보호되는 리소스의 집계 데이터 볼륨 (GiB로 표시)입니다.
  • minimum_enforced_retention_days: 이 백업 계획과 연결된 백업에 적용되는 최소 필수 보관 기간(일)입니다.
  • effective_date_for_enforced_retention_lock: 적용된 보관 잠금의 정확한 시행일입니다.

  • lock_on_enforced_retention: 보관이 잠긴 상태인지 여부를 나타냅니다. 이 필드는 다음 로직에 따라 동적으로 생성됩니다.

    • effective_date_for_enforced_retention_lock 타임스탬프가 있고 현재 시간 또는 과거 시간에 해당하는 경우 값은 '잠김'으로 지정됩니다.
    • 이 조건을 충족하지 않으면 값이 '잠금 해제됨'으로 지정됩니다.

샘플 쿼리

선택한 로그를 보려면 쿼리 섹션에서 맞춤 쿼리를 작성하면 됩니다.

다음 쿼리를 사용하여 특정 백업 계획과 연결된 백업 계획을 확인합니다.

    logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"

다음 쿼리를 사용하여 특정 백업 보관소와 연결된 백업 계획을 확인합니다.

    logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"

다음 쿼리를 사용하여 특정 규칙 이름을 포함하는 백업 계획을 확인합니다.

    logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME

다음 단계