커스텀 대시보드에 임시 필터 추가

이 문서에서는 임시 그룹 및 임시 필터를 추가하여 각 위젯을 수정할 필요 없이 커스텀 대시보드에 표시되는 데이터를 변경하는 방법을 설명합니다. 대시보드 전체 그룹 또는 필터를 추가하면 대시보드 툴바에 해당 그룹 또는 필터에 대한 메뉴 항목이 표시됩니다.

문제를 해결할 때 임시 그룹 또는 필터를 추가하여 대시보드에 표시되는 데이터를 수정할 수 있습니다. 예를 들어 이슈를 조사하고 대시보드에 특정 가상 머신(VM)의 데이터만 표시하려면 임시 필터를 추가합니다.

페이지를 새로고침하면 임시 그룹 및 필터가 자동으로 삭제되지만 수동으로 삭제할 수도 있습니다.

영구 필터를 만드는 방법은 커스텀 대시보드에 영구 필터 추가를 참조하세요.

대시보드 필터의 작동 방식

대시보드 필터는 라벨과 값을 지정합니다. 대시보드에 표시되는 시계열에 따라 필터링에 사용할 수 있는 라벨이 결정됩니다. 위젯이 대시보드 전체 필터를 지원하는 방식은 위젯에 표시되는 데이터 유형과 위젯 구성에 따라 달라집니다.

  • 선 차트와 같이 시계열 데이터를 표시하는 위젯의 경우 다음 규칙이 적용됩니다.

    • 위젯으로 표시되는 시계열이 필터에서 라벨을 지원하지 않으면 대시보드 전체 필터는 표시된 데이터를 변경하지 않습니다.

      예를 들어 instance_id 라벨에 필터를 추가했는데 대시보드의 차트에 instance_id 라벨이 있는 데이터가 표시되지 않으면 해당 필터에서 표시된 데이터를 변경하지 않습니다.

    • 위젯이 라벨 값을 지정하면 대시보드 전체 필터에서 표시된 데이터를 변경하지 않습니다.

      예를 들어 instance_id 라벨에 필터를 추가했는데 대시보드의 차트에 instance_id 라벨을 기반으로 하는 필터가 포함된 경우 대시보드 전체 필터에서 표시된 데이터를 변경하지 않습니다.

    • 그렇지 않으면 차트는 대시보드 전체 필터를 충족하는 시계열로만 표시되는 데이터를 필터링합니다.

  • 로그 패널 위젯의 경우 리소스 라벨에 기반한 대시보드 전체 필터가 쿼리를 업데이트합니다. 예를 들어 대시보드 전체 필터 cluster_name: mycluster를 추가하면 resource.labels."cluster_name"="mycluster"가 포함되도록 쿼리가 업데이트됩니다.

대시보드 전체 필터를 여러 개 추가할 수 있습니다. 이러한 필터는 논리곱(AND)으로 조인됩니다.

시작하기 전에

Google Cloud 콘솔을 사용하여 임시 필터를 추가하거나 수정하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 모니터링 뷰어(roles/monitoring.viewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

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

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

임시 그룹 만들기 또는 수정하기

대시보드 전체 그룹을 추가하면 대시보드의 위젯에 그룹화 라벨에 대해 동일한 값을 갖는 각 시계열 집합에 대해 하나의 시계열이 표시됩니다. 기본적으로 각 집합의 평균이 표시됩니다. 하지만 위젯이 그룹화 함수를 정의하면 해당 함수가 사용됩니다.

예를 들어 대시보드에 VM 인스턴스의 CPU 사용률을 표시하는 차트가 있다고 가정합니다. 특정 영역에 VM을 더 배포해야 하는지 확인하려면 대시보드와 해당 차트를 수정하여 그룹화 옵션을 변경하면 됩니다. 대안은 영역별로 대시보드를 일시적으로 그룹화한 다음 CPU 사용률 차트를 보는 것입니다.

임시 그룹화를 만들거나 수정하려면 다음 안내를 따르세요.

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

    대시보드로 이동

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

  2. 그룹화 기준 메뉴를 펼친 후 그룹화 라벨을 선택합니다.
  3. 확인을 클릭합니다.

대시보드에서 이동하면 생성한 모든 그룹이 삭제됩니다.

임시 필터 만들기

이슈를 조사할 때 특정 방식으로 데이터를 확인해야 할 수 있습니다. 예를 들어 특정 가상 머신 또는 특정 리전의 리소스에 대한 시계열만 볼 수 있습니다. 임시 필터를 생성하면 해당 필터와 일치하는 데이터를 표시하도록 모든 대시보드 위젯이 수정됩니다. 예를 들어 특정 VM 인스턴스의 시계열만 표시하도록 모든 차트를 구성하려면 instance_id 라벨을 기준으로 필터를 생성합니다. 마찬가지로 특정 영역의 시계열만 표시하도록 대시보드를 구성하려면 zone 라벨을 기준으로 필터를 생성합니다.

임시 필터를 만들려면 다음 안내를 따르세요.

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

    대시보드로 이동

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

  2. 대시보드의 필터 막대에서 필터 추가를 클릭한 후 메뉴에서 라벨을 선택합니다.

    대시보드에 표시되는 모든 시계열의 라벨이 메뉴에 나열됩니다.

    라벨을 선택하면 대시보드 툴바에 필터가 추가됩니다. 필터 이름은 선택한 이름과 같고 값이 모든 값과 일치하는 *로 설정됩니다. 예를 들어 zone을 선택하면 툴바에 zone: *가 표시됩니다.

  3. 일치시킬 특정 값을 선택하려면 필터를 클릭한 후(예: zone: * 클릭) 메뉴에서 값을 선택합니다. 메뉴 옵션의 수를 줄이려면 필터 영역에 값의 일부를 입력합니다.

대시보드에서 이동하면 생성한 모든 필터가 삭제됩니다.

시계열과 일치하는 임시 필터 추가

차트에 표시된 특정 시계열에 대한 자세한 정보를 보려는 경우 차트 범례를 사용하여 임시 필터를 적용할 수 있습니다. 시계열의 특정 라벨과 일치하거나, 시계열의 리소스와 일치하거나, 단순히 측정항목의 라벨과 일치하는 필터를 적용할 수 있습니다. 이 섹션에서는 이들 선택사항에 대해 설명합니다.

대시보드 예시

다양한 옵션의 동작을 설명하기 위해, Compute Engine VM 인스턴스의 CPU utilization 및 Disk read bytes 측정항목을 표시하는 대시보드가 있다고 가정해 보겠습니다. 다음 스크린샷은 하나의 시스템에 대해서 이 대시보드를 보여줍니다.

예시 대시보드 표시

시계열의 모든 라벨로 필터링

가장 제한적인 라벨 집합을 적용하려면 모든 라벨을 기준으로 필터링합니다. 이 옵션을 사용하면 라벨이 측정항목의 라벨에 대한 고유한 리소스 및 고유한 값 집합을 식별합니다.

차트에서 특정 시계열을 식별하는 임시 필터를 적용하려면 다음 안내를 따르세요.

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

    대시보드로 이동

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

  2. 자세한 내용을 확인하려면 범례 펼치기를 클릭하여 차트를 식별하고 범례를 확장합니다.
  3. 원하는 특정 시계열을 찾을 때까지 범례를 스크롤하고 이 시계열에 대한 작업을 클릭한 후 대시보드를 모든 라벨로 필터링을 선택합니다.

예를 들어 예시 대시보드의 CPU utilization 측정항목을 표시하는 차트에 이 단계를 적용하면 다음 필터가 추가됩니다.

  • 측정항목 라벨: instance_name

  • Compute Engine VM 인스턴스의 리소스 라벨:

    • project_id
    • instance_id
    • zone

다음 스크린샷은 결과를 보여줍니다.

CPU 사용률 시계열의 모든 라벨에 대한 필터가 있는 예시 대시보드 표시

앞의 그림에서 CPU utilization 측정항목을 표시하는 차트는 단일 시계열을 보여줍니다. 이는 시계열 라벨과 일치하는 필터를 추가했기 때문입니다. 그러나 Disk read bytes 측정항목을 표시하는 차트는 여러 시계열을 보여줍니다. Disk read bytes 측정항목에는 instance_name 라벨 외에 3개의 라벨이 포함되어 있으므로 이 차트의 여러 시계열이 동일한 인스턴스를 참조할 수 있습니다.

반면, 예시 대시보드의 Disk read bytes 측정항목을 표시하는 차트에 이전 단계를 적용하면 다음 필터가 추가됩니다.

  • 측정항목 라벨:

    • instance_name
    • device_name
    • storage_type
    • device_type

  • Compute Engine VM 인스턴스의 리소스 라벨:

    • project_id
    • instance_id
    • zone

디스크 읽기 바이트 시계열의 모든 라벨에 대한 필터가 있는 예시 대시보드 표시

이전 스크린샷에 표시된 대로 이제 두 차트 모두 단일 시계열을 표시합니다.

시계열의 리소스 라벨로 필터링

모든 리소스 라벨로 필터링할 때 특정 리소스의 시계열을 표시하도록 대시보드를 제한합니다. 이제 해당 리소스의 측정항목만 확인하여 관심 없는 시계열을 일시적으로 제거할 수 있습니다.

차트에 표시된 특정 시계열의 리소스를 식별하는 임시 필터를 적용하려면 다음 안내를 따르세요.

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

    대시보드로 이동

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

  2. 자세한 내용을 확인하려면 범례 펼치기를 클릭하여 차트를 식별하고 범례를 확장합니다.
  3. 원하는 특정 시계열을 찾을 때까지 범례를 스크롤하고 이 시계열에 대한 작업을 클릭한 후 대시보드를 리소스 라벨로 필터링을 선택합니다.

예를 들어 예시 대시보드의 CPU utilization 측정항목을 표시하는 차트에 이 단계를 수행하면 세 개의 필터가 추가됩니다. 이러한 필터는 리소스인 VM 인스턴스의 라벨에 해당합니다.

CPU 사용률 시계열의 리소스 라벨에 대한 필터가 있는 예시 대시보드 표시

이전 스크린샷에 표시된 대로 리소스별로 필터링하면 차트에 여러 시계열이 표시될 수 있습니다.

대시보드를 리소스 라벨로 필터링 옵션은 임시 필터 막대에 리소스 라벨만 적용하므로 어떤 차트에서 이 옵션을 선택하든 결과가 동일합니다.

시계열의 측정항목 라벨로 필터링

이 옵션을 사용하면 측정항목의 라벨 값과 일치하는 필터를 적용할 수 있습니다. 예를 들어 부하 분산 측정항목을 볼 때 특정 프로토콜에 대한 시계열만 표시할 수 있습니다.

차트에 표시된 특정 시계열의 측정항목을 식별하는 임시 필터를 적용하려면 다음 안내를 따르세요.

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

    대시보드로 이동

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

  2. 자세한 내용을 확인하려면 범례 펼치기를 클릭하여 차트를 식별하고 범례를 확장합니다.
  3. 원하는 특정 시계열을 찾을 때까지 범례를 스크롤하여 이 시계열에 대한 작업을 클릭한 후 대시보드를 모든 라벨로 필터링을 선택합니다.

예를 들어 예시 대시보드의 CPU utilization 측정항목을 표시하는 차트에서 이 단계를 수행하면 instance_name 라벨을 기준으로 필터가 추가됩니다. 이 경우 instance_name 라벨 값을 구성할 수 있으므로 두 차트 모두 여러 시계열을 표시할 수 있습니다. 즉, instance_name 라벨의 값이 동일한 VM이 여러 개 있을 수 있습니다.

반면, 예시 대시보드의 Disk read bytes 측정항목을 표시하는 차트에 이전 단계를 적용하면 4개의 필터가 추가됩니다. 이러한 필터는 Disk read bytes 측정항목의 라벨에 대응합니다.

임시 필터에 측정항목 필터만 포함된 경우 시계열이 작성된 리소스에 관계없이 해당 측정항목에 대한 시계열이 표시됩니다. 시계열을 특정 리소스로 제한하지 않으므로 차트에 여러 시계열이 표시될 수 있습니다. 이전 스크린샷에는 두 차트 모두 두 시계열을 표시하므로 이 동작을 보여줍니다.

임시 필터 수정 또는 삭제

대시보드에서 이동하면 임시 필터가 자동으로 삭제됩니다. 임시 필터를 수동으로 삭제하려면 해당 필터에서 삭제를 클릭합니다.

다음 단계