대시보드에 이벤트 표시

콘솔

현재 세션의 이벤트를 표시하려면 다음 안내를 따르세요.

1. Google Cloud 콘솔에서  대시보드 페이지로 이동합니다.

   대시보드로 이동

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

2. 보려는 대시보드를 선택합니다.

3. 대시보드 툴바에서 이벤트 전환이 설정되었는지 확인합니다.

   이벤트 전환이 표시되지 않았으면 대시보드에서 이벤트 표시가 지원되지 않는 것입니다.

4. 표시할 각 이벤트 유형에 대해 대시보드 툴바에서 이벤트 추가를 클릭한 후 메뉴에서 이벤트 유형을 선택합니다.

   예를 들어 'GKE 워크로드 배포' 이벤트를 표시하도록 대시보드를 구성할 수 있습니다.

   이벤트 유형을 추가하면 Cloud Monitoring이 로그 데이터를 쿼리(몇 분 정도 걸릴 수 있음)한 후 대시보드에서 차트에 주석을 추가합니다.

   • info 정보: 정보 제공 메시지입니다.
   • warning 경고: 재부팅 또는 비정상 종료와 같은 장애를 나타냅니다.
   • notifications 알림: 이슈가 개설되었음을 나타냅니다.

5. 이벤트 요약을 보거나 로그 항목 링크에 액세스하려면 포인터를 사용해서 도움말을 활성화합니다.

6. 선택사항: 구성은 현재 세션에만 적용됩니다. 구성을 저장하려면 다음을 수행합니다.

   1. 대시보드 툴바에서 settings 설정을 클릭하고 JSON을 선택한 후 JSON 편집기를 선택합니다.

   2. JSON 편집기에서 annotations 객체를 추가합니다. 이 객체에는 표시할 이벤트 유형을 지정하는 EventAnnotation 객체의 배열이 포함됩니다.

      다음은 클러스터 업데이트 이벤트의 예시 annotations 객체를 보여줍니다. 이 예시의 filter 필드는 이벤트를 특정 클러스터로 제한합니다.

      "annotations": {
        "defaultResourceNames": [],
        "eventAnnotations": [
          {
            "displayName": "",
            "enabled": true,
            "eventType": "GKE_CLUSTER_UPDATE",
            "filter": "resource.labels.cluster_name=my-cluster",
            "resourceNames": []
          }
        ]
      }
      

      annotations 객체에 대한 자세한 내용을 보려면 이 표의 API 탭을 선택하세요.

   3. 변경사항 적용을 클릭하고 저장을 클릭합니다.

API

이벤트를 표시하도록 커스텀 대시보드를 구성하려면 Dashboard 객체에 annotations 필드를 포함합니다. annotations 필드에는 두 필드가 포함된 DashboardAnnotations 객체의 인스턴스가 포함됩니다.

• defaultResourceName 필드에는 이벤트를 검색할 Google Cloud 프로젝트의 대시보드 수준 기본값이 나열됩니다. 이 필드를 지정하지 않으면 선택한 프로젝트가 검색됩니다.

• EventAnnotation 객체의 배열입니다. 각 객체에는 다음이 포함됩니다.

  • displayName 필드: 이벤트별 전환 버튼에 라벨을 정의할 수 있습니다. 이 필드가 지정되지 않았거나 이 필드의 값이 빈 문자열이면 이벤트의 기본 이름이 표시됩니다.
  • enabled 필드: 이벤트 전환 버튼의 값을 제어합니다. true이면 전환 버튼이 on 위치에 있고 이벤트가 대시보드에 표시됩니다. false이면 전환 버튼이 off 위치에 있습니다.
  • EventType 열거의 값을 포함하는 eventType 필드
  • filter 필드: 이벤트별 쿼리에 추가할 쿼리를 지정할 수 있습니다. 이 필드의 값이 빈 문자열이면 이벤트별 쿼리가 사용됩니다.
  • resourceNames 필드: 이벤트를 검색할 Google Cloud 프로젝트 목록을 정의할 수 있습니다. 이 필드가 빈 배열인 경우 선택한 프로젝트가 검색됩니다.

다음은 클러스터 업데이트 이벤트의 예시 annotations 객체를 보여줍니다. 이 예시의 filter 필드는 이벤트를 특정 클러스터로 제한합니다.

"annotations": {
  "defaultResourceNames": [],
  "eventAnnotations": [
    {
      "displayName": "",
      "enabled": true,
      "eventType": "GKE_CLUSTER_UPDATE",
      "filter": "resource.labels.cluster_name=my-cluster",
      "resourceNames": []
    }
  ]
}

Cloud Monitoring API를 사용하여 대시보드를 만드는 방법은 API로 대시보드 만들기 및 관리 및 예시: 대시보드에서 이벤트 사용 설정을 참조하세요.

콘솔

로그 기반 알림을 만들려면 다음을 수행합니다.

1. 알림 채널을 구성하지 않은 경우 다음을 수행합니다.

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

      알림으로 이동

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

   2. 알림 채널 수정을 클릭합니다.
   3. 구성하려는 알림 채널 유형으로 이동하고, 새로 추가를 클릭한 후 대화상자를 완료합니다.

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

   로그 탐색기로 이동

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

3. 툴바에서 알림 만들기를 선택합니다.

4. 알림 정책 이름을 입력한 후 다음을 클릭합니다.

5. 알림을 표시할 로그 항목 정의 섹션에서 쿼리를 입력하거나 알림 만들기를 선택했을 때 쿼리 창에서 복사한 쿼리를 업데이트합니다.

   각 이벤트 유형에 대해 이벤트 유형 페이지에 로그 기반 알림 정책에 사용하는 데 적합한 쿼리가 나열됩니다.

6. 대화상자를 작성한 후 저장을 클릭합니다.

API

Cloud Monitoring API를 사용하여 로그 기반 알림 정책을 만들려면 다음 절차를 따르세요.

1. 알림 정책 조건에 포함할 쿼리를 식별합니다. 각 이벤트 유형에 대해 이벤트 유형 페이지에 로그 기반 알림 정책에 사용하는 데 적합한 쿼리가 나열됩니다.

2. 알림 정책 표현이 포함된 JSON 파일을 만듭니다. 이 단계 및 예시에 대한 자세한 내용은 알림 정책 설계를 참조하세요.

3. alertPolicies.create API 메서드를 호출합니다. 예를 들어 gcloud alpha monitoring policies create 명령어를 실행할 수 있습니다.

콘솔

모든 이벤트를 숨기려면 대시보드 툴바에서 toggle_off 이벤트 전환이 해제되었는지 확인합니다.

한 가지 이벤트 유형을 숨기려면 해당 이벤트 유형에 대해 전환을 해제 위치로 설정합니다.

API

커스텀 대시보드에서 한 가지 유형의 이벤트를 숨기려면 이벤트 유형의 EventAnnotation 객체를 찾은 후 enabled 필드를 false로 설정합니다.

Cloud Monitoring API 사용 방법에 대한 자세한 내용은 API로 대시보드 만들기 및 관리를 참조하세요.