백업 및 DR 이벤트 로그

이 페이지에서는 Cloud Logging에서 백업/복구 어플라이언스에 생성된 이벤트 로그를 보는 방법을 설명합니다. 이벤트 로그는 시스템 이벤트나 오류와 같은 백업/복구 어플라이언스에 대한 유용한 정보를 제공합니다.

권한 및 역할

IAM 권한과 역할에 따라 백업 및 DR 서비스의 이벤트 로그 데이터에 액세스할 수 있는지 여부가 결정됩니다.

이벤트 로그를 보려면 roles/logging.viewer 권한이 필요합니다. 로그 뷰어 역할은 지정된 프로젝트의 모든 백업/복구 어플라이언스의 이벤트 로그를 볼 수 있는 읽기 전용 액세스 권한을 부여합니다. 이벤트 로그 데이터에 적용되는 IAM 권한과 역할에 대한 자세한 내용은 IAM으로 액세스 제어를 참고하세요.

이벤트 로그 보기

Google Cloud 콘솔 및 Google Cloud CLI를 사용하여 Cloud Logging에서 백업 및 DR 이벤트 로그를 볼 수 있습니다.

콘솔

Google Cloud 콘솔에서 로그 탐색기를 사용하여 백업/복구 어플라이언스의 백업 및 DR 이벤트 로그 항목을 검색할 수 있습니다.

  1. Google Cloud 콘솔에서 Logging > Logs Explorer로 이동합니다.
  2. 기존 Cloud 프로젝트를 선택합니다.
  3. 쿼리 빌더 창에서 다음 단계를 따르세요.

    1. 리소스 드롭다운에서 백업 복구 어플라이언스를 선택합니다.
    2. 로그 이름 선택 드롭다운에서 backup_recovery_appliance_events를 선택하여 백업/복구 어플라이언스의 이벤트 로그를 확인합니다.

gcloud

Google Cloud CLI는 Logging API에 명령줄 인터페이스를 제공합니다. 각 로그 이름에 유효한 리소스 식별자를 제공합니다. 프로젝트에서 백업/복구 어플라이언스의 이벤트 로그 항목을 읽으려면 다음 명령어를 실행합니다.

```gcloud
gcloud logging read "logName : projects/PROJECT_ID/logs/backup_recovery_appliance_events"\
 --project=PROJECT_ID
 ```

API

프로젝트에서 백업/복구 어플라이언스의 감사 로그 항목을 보려면 다음 단계를 따르세요.

  1. entries.list 메서드 문서의 API 사용해 보기 섹션으로 이동합니다.
  2. API 사용해 보기 양식의 요청 본문 부분에 다음을 입력합니다. 이 미리 채워진 양식을 클릭하면 요청 본문이 자동으로 입력되지만 각 로그 이름 필드에 유효한 PROJECT_ID를 입력해야 합니다.

    ```API
    {
      "resourceNames": [
        "projects/PROJECT_ID"
      ],
      "pageSize": 5,
      "filter": "logName : projects/PROJECT_ID/logs/backupdr_audit_log"
    }
    ```
    
  3. 실행을 클릭합니다.

이벤트 로그 형식

백업 및 DR 이벤트 로그 항목에는 다음 필드가 포함됩니다.

  • appName: 이 필드에는 이벤트와 연결된 애플리케이션의 이름이 표시됩니다.
  • srcid: 이 필드에는 백업/복구 어플라이언스에서 발생한 이벤트의 고유 ID가 표시됩니다.
  • jobName: 이 필드에는 이벤트와 연결된 작업의 이름이 표시됩니다.
  • appType: 이 필드는 이벤트와 연결된 애플리케이션 유형을 표시합니다.
  • eventId: 이 필드에는 오류와 연결된 고유 ID가 표시됩니다.
  • component: 이 필드는 이벤트의 소스를 표시합니다.
  • eventTime: 이 필드에는 이벤트가 보고된 시간이 표시됩니다.
  • errorMessage: 이 필드는 이벤트와 관련된 자세한 오류를 설명합니다.

다음 샘플은 실패한 스냅샷 작업에 대해 백업/복구 어플라이언스 ba-1-52973에 기록된 로그 항목의 예입니다.

    {
    "insertId": "aop2oko38hsami1c",
    "jsonPayload": {
    "appName": "instance-2",
    "srcid": "111428",
    "jobName": "Job_0110906c",
    "appType": "GCPInstance",
    "eventId": 43901,
    "component": "udp",
    "eventTime": "2023-02-06T20:24:52.450Z",
    "errorMessage": "Failed snapshot Job_0110906c for application instance-2 on host instance-2, Error: 1249: Failed to get VM details , sltname: pd snaps, slpname: ba-1-52973_Profile. "
    },
    "resource": {
    "type": "backupdr.googleapis.com/BackupRecoveryAppliance",
    "labels": {
    "backup_recovery_appliance_id": "test-backup-recovery-appliances",
    "resource_container": "projects/1234567",
    "management_server_id": "abcd-efgh-1234-5678-6789",
    "location": ""
    }
    },
    "timestamp": "2023-02-06T20:24:55.275029393Z",
    "severity": "ERROR",
    "logName": "projects/project1/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events",
    "receiveTimestamp": "2023-02-06T20:24:56.388937247Z"
    }

샘플 쿼리

쿼리 섹션에서 맞춤 이벤트 쿼리를 작성하여 원하는 이벤트 로그를 볼 수 있습니다.

다음 쿼리를 사용하여 지정된 PROJECT_ID의 백업/복구 어플라이언스와 연결된 모든 이벤트 로그를 확인합니다.

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"

특정 백업/복구 어플라이언스의 이벤트 로그를 찾는 경우 다음 백업/복구 어플라이언스 이름을 추가합니다.

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    resource.labels.backup_recovery_appliance_id= "backup/recovery appliance name"

특정 이벤트 ID의 이벤트 로그를 찾는 경우 다음 로그 쿼리를 사용하세요. 대문자 AND를 사용해야 합니다.

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    AND jsonPayload.eventId = event ID

여러 특정 이벤트 ID의 이벤트 로그를 찾는 경우 다음 로그 쿼리를 사용하세요. 대문자 ANDOR을 사용해야 합니다.

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    AND jsonPayload.eventId = (event ID 1 OR event ID 2 OR event ID 3)

이벤트 로그를 찾고 특정 이벤트 ID를 제외하려면 다음 로그 쿼리를 사용하세요. 대문자 AND NOTOR을 사용해야 합니다.

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    AND NOT jsonPayload.eventId = (event ID 1 OR event ID 2 OR event ID 3)

특정 애플리케이션의 이벤트 로그를 찾는 경우 다음 로그 쿼리를 사용하세요. 대문자 AND를 사용해야 합니다.

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" AND jsonPayload.app_name = appname

다음 단계