이 페이지는 Cloud Translation API를 통해 번역되었습니다.

보관처리된 리소스에 대한 로그 기반 알림 구성

이 페이지에서는 Google Cloud 콘솔의 로그 탐색기 페이지에서 보관처리된 리소스에 대한 로그 기반 알림을 구성하는 방법을 설명합니다.

로그 탐색기 페이지에서는 로그 기반 알림을 만들고 수정하는 다음 단계를 안내합니다.

알림의 이름과 설명 입력
알림을 수신할 로그를 선택합니다.
알림 사이의 시간 간격을 설정합니다.
이슈 자동 종료 시간을 설정합니다.
알림을 받을 대상을 지정합니다.

작업 카테고리(SCHEDULED_BACKUP, ON_DEMAND_BACKUP, RESTORE)에 대한 알림을 구성할 수 있습니다. 작업 상태(SUCCESSFUL, FAILED, SKIPPED, RUNNING)에 대한 알림을 설정할 수도 있습니다.

알림이 발생할 때 알림을 수신하도록 Google Chat, 이메일, SMS, 채팅 프로그램 채널과 같은 하나 이상의 알림 채널을 구성할 수 있습니다. 자세한 내용은 알림 채널 만들기 및 관리를 참고하세요.

시작하기 전에

로그 기반 알림 정책에 대한 권한을 할당합니다.

로그 기반 알림 만들기

알림을 전송하려면 알림 채널이 있어야 합니다. 알림 채널은 알림을 만들기 전이나 만들 때 만들 수 있습니다.

다음 안내에 따라 로그 기반 알림을 만듭니다.

Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.

로그 탐색기로 이동
쿼리 창에서 알림을 받으려는 알림을 정의합니다.

다음 쿼리는 예약된 백업 작업이 실패할 때마다 알림을 받는 예시입니다.
```
  logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbdr_backup_restore_jobs"
  jsonPayload.jobCategory="SCHEDULED_BACKUP"
  jsonPayload.jobStatus="FAILED"
```
다음을 바꿉니다.
- PROJECT_ID: 프로젝트의 이름입니다.
쿼리 결과 창의 헤더에서 알림 만들기를 클릭합니다.
알림 세부정보 섹션에서 다음을 수행합니다.
1. 알림 정책 이름 입력란에 알림 이름을 입력합니다. 이 이름은 알림 헤더에 표시됩니다.
2. 문서 필드에 알림에 대한 설명을 입력합니다. 이 필드의 콘텐츠 형식 지정 및 세부 조정 방법에 대한 자세한 내용은 문서 템플릿에서 마크다운 및 변수 사용을 참고하세요.
다음을 클릭합니다.
알림에 포함할 로그 선택 섹션에서 다음을 수행합니다.
1. 로그 미리보기를 클릭하여 쿼리와 결과를 확인합니다. 필요한 경우 이 창에서 쿼리를 수정할 수도 있습니다.
2. 라벨 추가를 클릭하고 다음을 수행합니다. 라벨을 사용하면 알림을 맞춤설정하고 더 많은 정보를 제공할 수 있습니다.
  1. 표시 이름 필드에 라벨 이름을 입력합니다.
  2. 로그 필드 이름 목록에서 로그 필드 이름을 선택합니다. 이 필드는 선택한 쿼리 결과를 기반으로 표시됩니다.
  3. 정규 표현식 필드에 정규 표현식 그룹이 정확히 1개 포함되어야 하는 필드에서 값을 추출하는 표현식을 입력합니다.
다음을 클릭합니다.
알림 빈도 및 자동 종료 기간 설정 섹션에서 다음을 수행합니다.
1. 알림 시간 간격 목록에서 알림 사이의 최소 시간을 선택합니다. 이 값을 사용하면 알림이 여러 번 트리거될 때 이 알림으로부터 받는 알림 수를 컨트롤할 수 있습니다.
2. 이슈 자동 종료 기간 목록에서 일치하는 로그 항목이 없을 때 이슈가 자동으로 종료되는 기간을 선택합니다.
다음을 클릭합니다.
알림 채널 목록에서 알림을 받을 알림 채널을 하나 이상 선택합니다. 알림 채널이 구성되어 있지 않으면 알림 채널 관리를 클릭하여 만듭니다. 자세한 내용은 알림 채널 만들기 및 관리를 참고하세요.
저장을 클릭합니다.

로그 기반 알림 테스트

만든 로그 기반 알림을 테스트하려면 쿼리와 일치하는 로그 항목을 수동으로 작성하면 됩니다.

다음 안내에 따라 로그 항목을 작성합니다.

logEntries.write 참조 페이지로 이동하세요.

logEntries.write로 이동

PROJECT_ID 변수를 프로젝트 ID로 변경하여 다음 로그 항목을 구성합니다.

      {
        "entries": [
          {
            "jsonPayload": {
              "jobCategory": "SCHEDULED_BACKUP",
              "jobStatus": "FAILED"
            }
          }
        ],
        "resource": {
          "type": "backupdr.googleapis.com/BackupDRProject"
        },
        "logName": "projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbdr_backup_restore_jobs"
      }

다음을 바꿉니다.

PROJECT_ID: 프로젝트의 이름입니다.

이전에 구성한 로그 항목을 복사합니다.
API 사용해 보기 창에서 다음 단계를 따르세요.
1. 요청 본문 필드에서 내용을 이전 단계에서 복사한 로그 항목으로 바꿉니다.
2. 실행을 클릭합니다. 메시지가 표시되면 인증 과정을 수행합니다.
logEntries.write 호출이 성공하면 HTTP 200 응답 코드와 빈 응답 본문 {}가 표시됩니다. API 탐색기에 관한 자세한 내용은 API 탐색기 사용을 참고하세요.

로그 항목은 다음과 같은 방법으로 알림에 지정된 필터와 일치합니다.
- logName 값은 Cloud 프로젝트의 백업 또는 복원 작업 로그를 지정합니다.
- jsonPayload에는 실패한 작업 카테고리 SCHEDULED_BACKUP가 포함되어 있으며, 이는 로그가 백업 계획에 의해 예약된 백업과 관련이 있음을 나타냅니다.
- jsonPayload에는 작업 상태 필드가 FAILED로 포함되어 있습니다. 이는 작업이 실패했음을 나타냅니다.
로그 항목을 작성하면 다음과 같은 시퀀스가 발생합니다.
1. 새로운 로그 항목이 로그 탐색기에 나타나고 알림을 트리거합니다.
2. Cloud Monitoring 페이지에서 이슈가 열립니다.
3. 해당 이슈에 대한 알림을 받습니다. 이메일 알림 채널을 구성한 경우 알림이 표시됩니다.
  
  이메일에서 이슈 보기를 클릭하여 Cloud Monitoring 페이지에서 이슈를 볼 수 있습니다. 확인 및 종료 방법을 비롯한 이슈에 관한 자세한 내용은 로그 기반 알림의 이슈 관리를 참고하세요.