로그 기반 알림 정책의 알림 관리

알림은 알림 정책 조건이 충족된 경우에 대한 기록입니다. 일반적으로 Cloud Monitoring은 알림 정책의 조건과 일치하는 로그가 수신될 때 알림을 열고 알림을 전송합니다. 하지만 다음과 같은 경우에는 알림이 생성되지 않습니다.

  • 정책이 일시중지되었거나 사용 중지되었습니다.
  • 알림 정책 또는 알림 수가 기존 알림 한도를 초과합니다.
  • 다른 로그 항목으로 인해 열려 있는 알림에 같은 조건이 충족됩니다. 이 경우 Monitoring은 같은 알림에 대한 다른 알림만 전송합니다.

Monitoring은 각 알림에 대해 알림을 관리하고 오류 문제 해결에 도움이 되는 알림 정보를 보고할 수 있는 알림 세부정보 페이지를 만듭니다. 예를 들어 알림 세부정보 페이지에는 로그 기반 알림 정책의 쿼리와 일치하는 로그 항목 목록이 표시됩니다. 관련 알림 링크도 확인할 수 있습니다.

이 문서에서는 알림을 찾는 방법을 설명합니다. 또한 알림 세부정보 페이지를 사용하여 Cloud Logging의 개별 로그에 저장된 로그 항목 데이터를 평가하는 로그 기반 알림 정책의 알림을 관리하는 방법도 설명합니다.

이 기능은 Google Cloud 프로젝트에서만 지원됩니다. App Hub 구성의 경우 App Hub 호스트 프로젝트 또는 관리 프로젝트를 선택합니다.

시작하기 전에

알림을 보고 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대해 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

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

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

알림 보기

프로젝트의 알림을 보려면 Google Cloud 콘솔, gcloud CLI 또는 Monitoring API를 사용하세요.

Google Cloud 콘솔

Google Cloud 프로젝트의 알림을 나열하려면 다음 단계를 따르세요.

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

    알림으로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

  2. Google Cloud 콘솔의 툴바에서 Google Cloud 프로젝트를 선택합니다. App Hub 구성의 경우 App Hub 호스트 프로젝트 또는 관리 프로젝트를 선택합니다.

    알림 페이지에는 알림 정책, 일시중지, 알림에 대한 정보가 표시됩니다.

    • 요약 창에는 미해결 알림 수가 나열됩니다.
    • 알림 표에는 가장 최근 미해결 알림이 표시됩니다. 종료된 알림을 포함하여 테이블에 가장 최근 알림을 나열하려면 종료된 알림 표시를 클릭합니다.

  3. 특정 알림의 세부정보를 보려면 목록에서 알림을 선택합니다.

    알림 세부정보 페이지가 열립니다. 알림 세부정보 페이지에 관한 자세한 내용은 이 문서의 알림 조사 섹션을 참고하세요.

이전 알림 찾기

알림 페이지의 알림 표에는 가장 최근의 미해결 알림이 표시됩니다. 이전 알림을 보려면 다음 중 하나를 수행하세요.

  • 알림 표의 항목에서 페이지를 이동하려면  최신 또는  이전을 클릭합니다.

  • 알림을 나열하고 필터링할 수 있는 페이지를 열려면 모든 알림 보기를 클릭합니다. 알림 페이지가 열립니다. 해당 페이지에서 다음을 수행합니다.

    • 종료된 알림을 포함한 모든 알림을 표시합니다. 모든 알림을 표시하려면 종료된 알림 표시를 클릭합니다.
    • 알림을 필터링합니다. 필터 추가에 대한 자세한 내용은 알림 필터링을 참고하세요.
    • 알림을 확인하거나 종료하거나 알림 정책을 일시중지합니다. 이러한 옵션에 액세스하려면 알림 행에서  옵션 더보기를 클릭하고 메뉴에서 선택합니다. 자세한 내용은 알림 관리를 참고하세요.

알림 필터링

표에 표시되는 알림을 제한하려면 필터를 추가합니다. 여러 필터를 추가하면 표에 모든 필터를 충족하는 알림만 표시됩니다.

알림 표를 필터링하려면 다음 단계를 따르세요.

  1. 알림 페이지에서  표 필터링을 클릭한 다음 필터 속성을 선택합니다. 필터 속성에는 다음이 포함됩니다.

    • 알림 상태
    • 알림 정책 이름
    • 알림이 열리거나 닫힌 시간

  2. 보조 메뉴에서 값을 선택하거나 필터 표시줄에 값을 입력합니다.

    그러면 알림 표에 필터가 표시됩니다.

gcloud

gcloud를 사용하여 알림을 가져오고 알림을 나열할 수 있습니다.

알림 받기

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

  • ALERT_NAME: 알림의 리소스 이름입니다. 예를 들면 projects/my-project/alerts/my-alert-id입니다.

gcloud alpha monitoring alerts describe 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud alpha monitoring alerts describe ALERT_NAME

Windows(PowerShell)

gcloud alpha monitoring alerts describe ALERT_NAME

Windows(cmd.exe)

gcloud alpha monitoring alerts describe ALERT_NAME
 이 명령어는 알림 상태, 연결된 라벨, 소스 알림 정책과 같은 알림 세부정보가 포함된 응답을 반환합니다. 대답은 다음과 유사합니다. 
{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "k8s_cluster",
    "labels": {
      "location": "us-central1",
      "cluster_name": "example_cluster",
      "project_id": "my-project"
    }
  },
  "log": {
    "extracted_labels": {
      "title": "my title"
    }
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}

알림 나열

gcloud CLI를 사용하여 프로젝트의 알림을 나열하고 결과를 필터링할 수 있습니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_ID: 프로젝트 식별자

gcloud alpha monitoring alerts list 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud alpha monitoring alerts list

Windows(PowerShell)

gcloud alpha monitoring alerts list

Windows(cmd.exe)

gcloud alpha monitoring alerts list
 이 명령어는 알림 상태, 연결된 라벨, 소스 알림 정책과 같은 알림 세부정보가 포함된 응답을 반환합니다. 대답은 다음과 유사합니다. 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "k8s_cluster",
        "labels": {
          "location": "us-central1",
          "cluster_name": "example_cluster",
          "project_id": "my-project"
        }
      },
      "log": {
        "extracted_labels": {
          "title": "my title"
        }
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
    }
  ]
}
다음 선택적 플래그를 사용하여 출력을 필터링, 정렬 또는 수정할 수도 있습니다.

  • --filter: 시간 또는 라벨별로 알림을 필터링하는 필터 표현식을 제공합니다. 예를 들어 --filter='close_time>="2025-09-10T00:00:00Z"'로 시간별로 필터링하거나 --filter='resource.labels.key="value"'로 라벨별로 필터링합니다.

  • --sort-by: 출력을 정렬할 필드의 쉼표로 구분된 목록입니다. 예를 들면 --sort-by=open_time입니다.

  • --uri: 명령어는 기본 출력 대신 리소스 URI 목록을 출력합니다.

  • --limit: 반환되는 알림 수를 제한하려면 이 플래그를 2 이상으로 설정합니다. 이 플래그를 --filter 플래그와 함께 사용하지 마세요.

Monitoring API