VPC용 백업에 대한 이벤트 알림 활성화하기
VPC용 백업( IBM Cloud® Event Notifications ) 작업이 실패할 때 알림을 받을 수 있도록 VPC용 백업을 구성합니다. 이메일, SMS 또는 웹훅을 통해 알림을 전송하여 백업 스냅샷 생성, 보존 실패 및 일관성 그룹 문제를 모니터링합니다.
Event Notifications로 정보를 전송하려면 IBM Cloud Backup for VPC 인스턴스를 Event Notifications에 연결해야 합니다. Event Notifications 관련 작업에 대한 자세한 정보는 Event Notifications 시작하기를 참조하십시오.
이벤트가 수집되고 전송되는 방식 IBM Cloud Backup for VPC
백업 작업은 두 가지 유형의 작업을 수행합니다. 한 작업은 예정된 대로 백업 스냅샷을 생성하고, 다른 작업은 기존 백업을 관리하고 백업에 보존 규칙을 적용합니다. 백업 작업이 실패하면 IBM Cloud Backup for VPC가 연결된 Event Notifications 인스턴스와 통신하여 지원 대상 에 알림을 전달합니다.
IBM Cloud Backup for VPC에 대한 이벤트
다음 표에는 IBM Cloud Backup for VPC 이벤트가 나와 있습니다.
| 이벤트 유형 | 설명 |
|---|---|
|
볼륨 백업 작업 생성 실패
|
이러한 이벤트는 권한이 없거나 기존 스냅샷이 너무 많거나 소스 볼륨이 사용 중일 때 백업 작업에서 백업 스냅샷을 만들 수 없을 때 생성됩니다. 자세한 내용은 스냅샷 제한, 스냅샷 수명 주기 상태 및 서비스 간 인증 를 참조하세요. 가능한 수정 사항에 대한 자세한 내용은 백업 문제 해결 항목을 참조하세요. |
|
볼륨 백업 작업 보존 실패
|
이러한 이벤트는 권한이 누락되었거나 스냅샷이 pending 또는 bad 상태여서 백업 작업에서 백업 스냅샷을 삭제할 수 없을 때 생성됩니다. 자세한 내용은 스냅샷 수명 주기 상태 및 서비스 간 권한 부여 를 참조하세요. |
|
인스턴스 백업 작업 생성 실패
|
이러한 이벤트는 다양한 이유로 인해 백업 작업에서 일관성 그룹의 스냅샷을 만들 수 없을 때 생성됩니다. 예를 들어, 권한이 누락되었거나 볼륨이 연결된 인스턴스를 사용할 수 없거나 암호화 키에 액세스할 수 없거나 볼륨 크기 또는 스냅샷 수에 대한 서비스 제한에 도달한 경우 등이 있습니다. 자세한 내용은 스냅샷 수명 주기 상태 및 서비스 간 권한 부여 를 참조하세요. 가능한 수정 사항에 대한 자세한 내용은 백업 문제 해결 항목을 참조하세요. |
|
인스턴스 백업 작업 보존 실패
|
이러한 이벤트는 권한이 누락되어 백업 작업에서 일관성 그룹의 일부인 백업 스냅샷을 삭제할 수 없거나 스냅샷이 pending 상태인 경우 생성됩니다. 자세한 내용은 스냅샷 수명 주기 상태 및 서비스 간 권한 부여 를 참조하세요. 가능한 수정 사항에 대한 자세한 내용은 백업 문제 해결 항목을 참조하세요. |
이러한 알림이 표시되면 API 또는 CLI 를 사용하여 실패한 상태의 원인을 확인할 수 있습니다.
문제 해결 방법에 대한 자세한 내용은 VPC용 백업 문제 해결 를 참조하세요.
알림 사용
IBM Cloud Backup for VPC 서비스 인스턴스에서 생성된 이벤트는 동일한 계정 내에 있는 Event Notifications 서비스 인스턴스로 전달될 수 있습니다. Event Notifications 서비스 인스턴스 하나당 백업 서비스 소스는 하나만 구성할 수 있습니다.
IBM Cloud Backup for VPC와 Event Notifications 사이의 IAM 권한이 계정에 아직 없는 경우, 이벤트 소스 관리자 역할로 생성하세요. 자세한 내용은 서비스 간 인증 설정하기 를 참조하세요.
IBM Cloud Backup for VPC에 대한 알림을 사용 설정하려면 먼저 Event Notifications 서비스 인스턴스 인스턴스와 동일한 계정에 IBM Cloud Backup for VPC가 있는지 확인해야 합니다.
그런 다음, ‘ IBM Cloud Backup ’ 정책 세부 정보 페이지의 ‘작업 > 이벤트 알림’ 섹션을 사용하여 서비스를 연결할 수 있습니다.
그런 다음, 이벤트 알림 API를 호출하여 프로그래밍 방식으로 Event Notifications 에 연결할 수 있습니다.
콘솔에서 Event Notifications 에 연결하기
-
IBM Cloud 콘솔에서 탐색 메뉴 아이콘
아이콘 > 인프라
> 스토리지 > 백업 정책을 클릭합니다.
-
정책 이름을 클릭합니다.
-
작업
를 클릭하고 이벤트 알림를 선택합니다.
-
다음에 연결 Event Notifications 사이드 패널에서 연결에 대한 소스 세부 정보를 검토하고 설명을 입력합니다.
-
연결할 리소스 그룹과 ‘ Event Notifications ’ 서비스 인스턴스를 선택하십시오.
계정에 IBM Cloud Backup for VPC 및 Event Notifications 간의 IAM 인증이 없는 경우 Event Notifications 에 대한 서비스 간 인증 사용 설정의 단계에 따라 설정하세요. 권한을 설정하려면 AIM 관리자 역할이 필요합니다.
-
연결을 확인하려면 ‘저장’을 클릭하세요.
CLI에서 Event Notifications에 연결하기
CLI에서 IBM Cloud Backup for VPC 소스를 연결하려면 ibmcloud event-notifications sources-create 명령을 사용합니다.
ibmcloud event-notifications sources-create --instance-id INSTANCE-ID --name NAME --source BACKUP POLICY CRN --description DESCRIPTION [--enabled ENABLED]
자세한 내용은 이벤트 알림 CLI 참조를 참조하세요.
API를 사용하여 Event Notifications에 연결
다음 예제는 IBM Cloud Backup for VPC 소스 정보를 Event Notifications 에 등록하는 데 사용할 수 있는 쿼리를 보여줍니다. API를 호출할 때, ID 변수와 IAM 토큰을 사용자의 IBM Cloud Backup for VPC 인스턴스에 해당하는 값으로 대체하십시오.
리소스 목록 페이지로 이동한 후 ‘ Event Notifications ’ 인스턴스 행을 클릭하면 콘솔에서 ‘ event_notifications_instance_crn ’ 값을 확인할 수 있습니다.
curl -X POST "{base_url}/v1/instances/{instance_id}/sources"
-H "Authorization: Bearer {iam_token}"
-H "Content-Type: application/json"
-d '{
"name":"Event Notification Source - Backup policy",
"source" : "crn:v1:bluemix:public:is:us-south:a/{{account_id}}::backup-policy:",
"description":"Backup policy service registration. This source provides notifications for backup job failures.",
"enabled":true,
"event_notifications_instance_crn": "crn:v1:bluemix:public:event-notifications:<region>:a/<account-id>:<service-instance>::"
}'
응답이 성공하면 연결된 ‘ Event Notifications ’ 서비스 인스턴스의 CRN 값이 반환됩니다. 필수 및 선택 요청 매개변수에 대한 자세한 내용은 이벤트 알림 API 문서 를 참조하세요.
테라폼으로 Event Notifications에 연결하기
IBM Cloud Backup for VPC 서비스를 Event Notifications에 연결하려면, ibm_en_source 리소스를 사용하세요. 인수 및 속성에 대한 자세한 내용은 ibm_en_source 리소스에 대한 테라폼 참조를 참조하세요.
resource "ibm_en_source" "en_source" {
instance_guid = ibm_resource_instance.en_terraform_test_resource.guid
name = "EN Source for Backup jobs"
source = "crn:v1:bluemix:public:is:us-south:a/{{account_id}}::backup-policy:"
description = "API source for Event notification destinations"
enabled = true
}
선택한 대상에 알림 전달
IBM Cloud Backup for VPC 에 대한 알림을 활성화한 후, Event Notifications 에서 토픽과 구독을 생성하여 알림이 전달되어 선택한 수신처로 전송될 수 있도록 하십시오.
지원되는 대상의 전체 목록은 Event Notifications 문서를 참조하십시오.
이메일 알림
IBM Cloud email service 을 이벤트 알림의 전달 채널로 IBM Cloud Backup for VPC을 사용할 수 있습니다. 기존 주제와 IBM Cloud 이메일 서비스 간에 Event Notifications 구독을 작성하여 여러 수신인에게 이메일로 경보를 전달하십시오.
IBM Cloud에서 IBM Cloud Backup for VPC 이벤트에 대한 정보가 포함된 이메일은 다음 예와 유사합니다:
Email Title: Volume Backup Job Creation Failure
Email Body:
Volume Backup Job Creation Failure. Resource: crn:v1:bluemix:public:is:us-south-1:a/be09dae34250437f96fc8b27ae7d233b::volume:r006-f6583aac-8ba9-4d04-ab7a-acfe7b420016. BackupJobID: r006-899ab8fb-3b71-4fc8-bca5-1544cb425e4f. Reason: Snapshot quota per volume reached.
Notification details:
{
"backup_policy": "r006-306fd8f6-b14c-410d-8f29-f05282b6daa9",
"backup_policy_job": "r006-899ab8fb-3b71-4fc8-bca5-1544cb425e4f",
"backup_policy_plan": "r006-444bb07f-3399-42d5-b895-febcaca8d1bc",
"match_resource_type" : "volume",
"job_type" : "creation",
"reasons": [
{
"more_info": "https://cloud.ibm.com/docs/vpc?topic=vpc-troubleshooting-backup-for-vpc",
"status": "source_volume_too_large"
}
],
"resource": "crn:v1:bluemix:public:is:us-south-1:a/be09dae34250437f96fc8b27ae7d233b::volume:r006-f6583aac-8ba9-4d04-ab7a-acfe7b420016"
}
이벤트 알림에 대한 자세한 정보를 이메일로 수신하려면 Event Notifications 구독을 작성할 때 알림 페이로드 추가 옵션을 선택하십시오. 이메일에 이벤트와 연관된 알림 페이로드 세부사항이 표시됩니다.
웹훅
앱 또는 서비스에서 프로그래밍 방식으로 수신 알림을 이용할 수 있도록 웹훅 대상을 구성할 수 있습니다. 웹훅 설정에 대한 자세한 정보는 Event Notifications 문서를 참조하십시오.
알림 페이로드 세부사항
IBM Cloud Backup for VPC 에서 생성된 성공 이벤트에는 이벤트의 출처와 세부 정보를 파악하는 데 도움이 되는 다양한 필드가 포함되어 있습니다.
IBM Cloud Backup for VPC 에서 전송되는 이벤트 알림에는 리소스의 이름이나 식별자 같은 메타데이터 속성만 포함됩니다. 민감한 데이터(예: API 키 또는 비밀번호)는 생성된 이벤트에 포함되지 않습니다.
Event Notifications 로 전송되는 속성은 이벤트 유형에 따라 다릅니다. 예를 들어, Backup job creation failed 이벤트가 발생하면 IBM Cloud Backup for VPC는 다음 예와 유사한 알림 페이로드를 Event Notifications로 전송합니다.
{
"ibmendefaultlong": "{\"status\":\"Backup job creation / retention failed\",
\"backup_policy\": r006-6da51cfe-6f7b-4638-a6ba-00e9c327b178,
\"backup_policy_plan\":\"r006-076191ba-49c2-4763-94fd-c70de73ee2e6\",
\"status_reason\": \"source_volume_busy: The source volume has busy set (after multiple retries)\",
\"match_resource_type\": \"instance\",
\"job_type\": \"creation\",
\"more_info\": \"https://cloud.ibm.com/docs/vpc?topic=vpc-baas-troubleshoot\"}",
"ibmendefaultshort": "Backup Job creation / retention failed",
"id": "b2198eb8-04b1-48ec-a78c-ee87694dd845",
"time": "2024-04-22T20:59:34Z",
"ibmenseverity": "medium",
"type": "com.ibm.cloud.is.backup-policy.backup-volume-creation",
"source": "com.ibm.cloud.is.backup-policy",
"specversion": "1.0",
"ibmensourceid": "41cdb7d4-db3e-496b-b7df-d4ead362c412:api"
}