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

알림 구성 및 관리

선택한 Cloud Monitoring 알림 채널로 오류 알림을 전송하도록 Error Reporting을 구성할 수 있습니다.

Error Reporting은 다음 경우에 알림을 전송합니다.

Google Cloud 프로젝트에서 오류가 처음 발생했을 때 이전 오류와 함께 그룹화할 수 없는 경우
해결됨으로 표시된 오류가 다시 발생하는 경우.

알림 채널 관리

Monitoring에서 알림 채널을 생성, 수정, 삭제합니다. 알림 채널을 만든 후 이를 사용하도록 Error Reporting을 구성할 수 있습니다.

Error Reporting을 사용하면 이메일, 모바일, Slack, 웹훅이라는 4가지 유형의 알림 채널 중에서 선택할 수 있습니다.

시작하기 전에

Google Cloud 콘솔을 사용하여 알림 채널을 보고 구성하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대해 Monitoring 편집자(roles/monitoring.editor) IAM 역할을 부여해달라고 요청합니다. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

Cloud Monitoring 역할에 대한 자세한 내용은 Identity and Access Management로 액세스 제어를 참조하세요.

알림 채널 만들기

Google Cloud Console을 사용하여 알림 채널을 만들려면 다음 표에 포함된 채널별 안내를 따르세요.

이메일

이메일 알림 채널을 추가하려면 다음 안내를 따르세요.

Google Cloud 콘솔에서 알림 페이지로 이동합니다.
알림으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
알림 채널 수정을 클릭합니다.
이메일 섹션에서 새로 추가를 클릭합니다.
단일 이메일 주소와 설명을 입력합니다.
저장을 클릭합니다.

그룹 이메일 주소를 알림 정책의 알림 채널로 사용하는 경우 ErrorReportingNotifications-noreply@google.com의 메일을 수락하도록 그룹을 구성합니다.

모바일 앱

Google Cloud 콘솔 모바일 앱을 사용하여 어디서나 Google Cloud 콘솔 리소스 및 모니터링 정보를 모니터링합니다. Google Cloud 콘솔 모바일 앱 알림은 특정 기기 또는 특정 사용자에게 전송됩니다.

Google Cloud 콘솔 모바일 앱 알림 채널 목록

기기는 알림 채널을 만든 특정 기기로만 알림이 전송됨을 나타냅니다. 기기 범위의 알림 채널의 경우 표시 이름 필드에 기기 정보가 포함됩니다.
사용자는 Google Cloud 콘솔 모바일 앱이 설치된 모든 기기로 알림이 전송되었음을 나타냅니다.

Cloud Monitoring에서 채널을 만들 때 알림 범위를 결정합니다. 범위를 직접 선택하거나 변경할 수는 없습니다.

특정 Google Cloud 프로젝트에 대해 Google Cloud 콘솔 모바일 앱 알림 채널을 구성하려면 다음을 수행합니다.

휴대기기의 앱 스토어에서 Google Cloud 콘솔 모바일 앱을 설치하세요.
Google Cloud 콘솔 모바일 앱에서 볼 프로젝트를 선택합니다.

프로젝트를 선택하면 앱과 선택한 Google Cloud 프로젝트 간에 데이터 교환이 발생합니다. 존재하지 않으면 알림 채널이 생성되며 몇 분 후 알림 채널 페이지의 휴대기기 섹션에 이 채널이 나열됩니다.

알림 정책에 휴대기기를 알림 채널로 추가하려면 알림 알림 섹션에서 Google Cloud 콘솔 (모바일)을 선택한 다음 목록에서 휴대기기를 선택합니다.

Slack

Slack 알림을 설정하려면 다음 절차를 따르세요.

Slack 내: Slack 사이트에서 Slack 작업공간 및 채널을 만듭니다. 채널 URL을 기록합니다.
Google Cloud 콘솔에서 알림 페이지로 이동합니다.
알림으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
알림 채널 수정을 클릭합니다.
Slack 섹션에서 새로 추가를 클릭하여 Slack 로그인 페이지를 엽니다.
1. Slack 작업공간을 선택합니다.
2. 허용을 클릭하여 Slack 작업공간에 대한 Cloud Monitoring 액세스를 사용 설정합니다. 이렇게 하면 알림 채널의 Monitoring 구성 페이지로 돌아갑니다.
3. Slack 채널 이름 필드에 알림에 사용할 Slack 채널의 이름을 입력합니다.
4. Cloud Alerting 표시 이름 필드에 설명이 포함된 짧은 문구를 입력합니다. Monitoring에서 이 필드의 값을 알림 채널 페이지에 표시합니다.
5. (선택사항) Cloud Monitoring과 Slack 작업공간 간의 연결을 테스트하려면 테스트 알림 보내기를 클릭합니다. 연결에 성공하면 지정한 Slack 알림 채널에 This is a test alert notification... 메시지가 표시됩니다. 수신을 확인하려면 알림 채널을 확인하세요.
알림에 사용하려는 Slack 채널이 비공개 채널인 경우 수동으로 Monitoring 앱을 채널에 초대해야 합니다.
1. Slack을 엽니다.
2. Monitoring 알림 채널로 지정한 채널로 이동합니다.
3. 채널에 다음 메시지를 입력하고 전송하여 Monitoring 앱을 채널에 초대합니다.
```
/invite @Google Cloud Monitoring
```
  Monitoring에서 알림 채널을 만들 때 지정한 비공개 채널에 Monitoring 앱을 초대해야 합니다. Monitoring 앱을 공개 채널에 초대하는 것은 선택사항입니다.

웹훅

Webhook 알림 채널을 구성하기 전에 다음 사항을 고려하세요.

웹훅은 공개 엔드포인트만 지원합니다.
Cloud Run 함수가 알림 채널의 웹훅 엔드포인트로 구성된 경우 함수를 호출하는 사용자에게 필요한 인증 권한이 있는지 확인하세요. 자세한 내용은 호출 인증 및 함수에 대한 액세스 사용 설정을 참고하세요.
웹훅 알림 채널은 Microsoft Teams와 호환되지 않습니다. 모니터링에서 Microsoft Teams로 알림 데이터를 전송하려면 모니터링 웹훅을 수신하는 통합 레이어를 만든 다음 Microsoft Teams로 다시 라우트합니다.

웹훅 알림 채널 구성

웹훅 알림을 구성하려면 다음 절차를 따르세요.

웹훅 핸들러: Monitoring에서 웹훅 데이터를 수신할 공개 엔드포인트 URL을 식별합니다.
Google Cloud 콘솔에서 알림 페이지로 이동합니다.
알림으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
알림 채널 수정을 클릭합니다.
웹훅 섹션에서 새로 추가를 클릭합니다.
대화상자를 완료합니다.
연결 테스트을 클릭하여 웹훅 엔드포인트로 테스트 페이로드를 보냅니다. 수신 엔드포인트로 이동하여 전송을 확인할 수 있습니다.
저장을 클릭합니다.

웹훅 스키마

Error Reporting의 웹훅 스키마 구조를 보려면 다음을 클릭합니다.

스키마 구조, 버전 1.0

{
  "version": "1.0",
  "subject": 문자열, 신규 또는 다시 열린 오류 그룹에 대한 설명입니다.
  "group_info": {
    "project_id": 문자열, 오류 그룹을 소유하는 프로젝트입니다.
    "detail_link": 문자열, 오류 그룹의 Error Reporting 세부정보 페이지 링크입니다.
  },
  "exception_info": {
    "type": 문자열, 이벤트에 로그인된 예외 유형입니다.
    "message": 문자열, 이벤트의 예외 메시지입니다.
  },
  "event_info": {
    "log_message": 문자열
    "request_method": 문자열
    "request_url": 문자열
    "referrer": 문자열
    "user_agent": 문자열
    "service": 문자열
    "version": 문자열
    "response_status": 문자열
  },
}

기본 인증

Cloud Monitoring에서 보낸 웹훅 요청 외에도 기본 인증은 사용자 이름과 비밀번호에 HTTP 사양을 이용합니다. Cloud Monitoring에서 서버는 적절한 WWW-Authenticate 헤더가 있는 401 응답을 반환해야 합니다. 기본 인증에 대한 상세 정보는 아래를 참조하세요.

토큰 인증

토큰 인증을 사용하려면 엔드포인트 URL에 쿼리 문자열 매개 변수와 서버가 자체적으로 모니터링할 것으로 예상하는 키가 필요합니다. 다음은 토큰이 포함된 샘플 URL입니다.

https://www.myserver.com/stackdriver-hook?auth_token=1234-abcd

Monitoring이 엔드포인트 URL에 이슈를 게시하면 서버에서 연결된 토큰의 유효성을 검사할 수 있습니다. 이 인증 방법은 SSL/TLS와 함께 HTTP 요청을 암호화하여 스누퍼의 토큰 학습을 방지할 때 가장 효과적입니다.

Python의 서버 예는 이 샘플 서버를 참조하세요.

알림 채널 수정 및 삭제

Google Cloud 콘솔을 사용하여 알림 채널을 수정하거나 삭제하려면 다음 절차를 따르세요.

Google Cloud 콘솔에서 알림 페이지로 이동합니다.
알림으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
알림 채널 수정을 클릭합니다.

알림 채널 대시보드에는 각 알림 채널 유형에 대한 섹션이 있습니다. 각 섹션에는 해당 유형의 모든 구성이 나열됩니다.
- 항목을 수정하려면 수정을 클릭합니다. 변경이 완료되면 저장을 클릭합니다.
- 항목을 삭제하려면 삭제를 클릭합니다. 확인 대화상자에서 삭제를 클릭합니다.

Google Cloud Console을 통해 알림 채널 선택

기존 알림 채널을 선택하려면 다음 역할 중 하나가 있어야 합니다.

오류 보고 사용자
Error Reporting 관리자
프로젝트 편집자
프로젝트 소유자

새 오류 그룹이 발생할 때 알림을 전송할 위치를 선택하려면 다음 단계를 따릅니다.

Google Cloud 콘솔에서 Error Reporting 페이지로 이동합니다.
Error Reporting으로 이동

검색창을 사용하여 이 페이지를 찾을 수도 있습니다.
알림 구성을 클릭하여 오류 알림 페이지를 엽니다.
알림 채널 드롭다운 메뉴에서 알림을 전송할 채널을 선택합니다.

필요한 채널이 표시되지 않으면 알림 채널 관리를 클릭하여 새 채널을 만듭니다. 알림 채널을 만들려면 채널 만들기에 나열된 역할이어야 합니다.
채널을 선택한 후 저장을 클릭합니다.

추가 정보

다음은 Error Reporting에서 알림을 만들고 관리할 때 적용되는 추가 정보입니다.

알림 콘텐츠

오류 그룹 알림에는 그룹의 로그 항목과 관련된 정보가 포함됩니다. 포함된 정보는 오류가 발생한 모니터링 리소스의 유형에 따라 다릅니다. 예를 들어 일부 알림에는 모니터링 리소스의 이름과 버전이 포함될 수 있습니다.

오류 메시지는 리전이 global인 로그 버킷의 로그 항목으로 오류 그룹이 식별되는 경우에만 알림에 포함됩니다.

알림은 언제 전송되나요?

Error Reporting은 다음의 두 가지 경우 알림을 전송합니다.

Error Reporting에서 오류 그룹을 본 적이 없는 경우
기존 오류 그룹에 대한 오류가 발생하고 오류 그룹 상태가 Resolved로 설정된 경우

향후 오류 그룹에 대한 알림을 받으려면 오류 그룹 상태를 Resolved로 설정해야 합니다. API를 사용하여 오류 그룹을 삭제하거나 데이터가 만료될 때까지 기다리는 등의 다른 조치는 다른 오류가 발생하면 알림을 제공하지 않습니다.

알림 비율 제한

Error Reporting은 다음 규칙을 사용하여 오류로 인해 수신될 수 있는 알림 수를 제한합니다.

오류로 인한 알림은 60분 동안 최대 5개까지 전송할 수 있습니다.
60분 동안 오류가 6개 이상 수신되면 다음과 같은 결과가 발생합니다.
- 다음 6시간 동안 추가 알림이 음소거된다는 알림이 수신됩니다.
- 경고 수준의 심각도가 있는 로그 항목이 작성됩니다.
오류 그룹을 해결하면 해당 오류 그룹에 대한 알림이 5분 동안 일시중지됩니다.

해결 상태

해결 상태가 해결됨인 오류가 다시 발생하면, 이전에 해결 상태가 삭제된 경우에도 열림으로 다시 변경되며 Error Reporting이 알림을 보냅니다.

숨긴 오류가 다시 발생하면 Error Reporting은 알림을 전송하지 않습니다.

오류의 해결 상태를 관리하려면 오류 관리로 이동하세요.

모바일 알림

Error Reporting은 모바일 알림을 Android 및 iOS의 Google Cloud 앱으로 전송합니다. 모바일 알림을 수신하려면 먼저 휴대기기에 앱을 설치해야 합니다.

Google Cloud 앱 다운로드

Google Cloud 콘솔 모바일 앱 이미지입니다. Google Cloud 콘솔 모바일 앱 세부정보입니다.