IBM Cloud Logs 게이지 위젯 작성

사용자 지정 IBM® Cloud Logs 대시보드에 포함할 수 있는 게이지 위젯을 만들 수 있습니다.

게이지 위젯을 사용하면 속도계나 다이얼처럼 지정된 범위 내에서 단일 값을 표시할 수 있습니다. 일반적으로 주요 메트릭과 성과 지표를 한 눈에 볼 수 있도록 표시하는 데 사용됩니다.

게이지에는 임계값이 통합되어 있어 특정 값이 충족되거나 초과될 때 시각화의 모양을 변경할 수 있습니다. 특정 매개변수를 기준으로 데이터 집합을 그룹화하면 각 게이지가 데이터의 하위 집합을 나타내는 다중 게이지를 만들 수 있습니다. 이를 통해 다양한 카테고리 또는 그룹을 동시에 비교할 수 있으므로 성과를 보다 폭넓게 파악할 수 있습니다.

1단계: 이름과 설명 입력

다음 단계를 완료하십시오.

  1. 사용자 정의 대시보드 에서 위젯 추가 위젯 추가 아이콘 를 클릭하고 사이드바에서 게이지 위젯을 끌어서 놓으십시오.

  2. 새 게이지를 위젯의 이름으로 바꿉니다.

  3. 설명을 입력하십시오.

    액션 아이콘 액션 아이콘 클릭합니다. 그런 다음 설명 추가를 선택합니다.

  4. 범례 값이 표시되는 위치를 정의합니다. 유효한 값은 Side, Bottom, Auto, Hide 입니다.

    액션 아이콘 액션 아이콘 클릭합니다. 그런 다음 범례 설정을 선택합니다.

2단계: 데이터 집합을 정의하도록 쿼리 구성하기

다음 단계를 완료하십시오.

  1. 액션 아이콘 액션 아이콘 클릭합니다. 그런 다음 편집 모드를 선택합니다.

  2. Query 1 의 경우 다음 단계를 완료합니다:

    데이터 유형을 선택합니다. 유효한 값은 Logs, Metrics, DataPrime 입니다.

    소스를 선택합니다. 유효한 옵션은 Priority Insights 및 Analyze and Alert 입니다.

    쿼리 이름을 변경할 수 있습니다. 작업 아이콘 선택한 다음 쿼리 이름 바꾸기를 클릭합니다.

  3. 쿼리를 입력합니다.

    데이터 유형이 DataPrime 인 경우 쿼리 필드에 데이터프라임 쿼리를 입력합니다.

    데이터 유형이 Logs 인 경우 쿼리 필드에 Lucene 쿼리를 입력합니다. 필터 및 집계를 적용할 수 있습니다.

    데이터 유형이 Metrics 인 경우 쿼리 필드에 메트릭 또는 원하는 PromQL 을 지정합니다. 필터 및 집계를 적용할 수 있습니다.

  4. [선택 사항으로] 위젯에 특정 필터를 하나 이상 추가하여 게이지에 표시되는 데이터의 범위를 좁힐 수 있습니다.

    레이블과 해당 값을 선택합니다.

    필터는 위젯 수준에서 적용되며 대시보드 필터와 함께 작동합니다. 충돌이 있는 경우 대시보드 필터가 위젯 필터보다 우선합니다.

  5. 함수를 추가합니다.

    데이터 유형이 Logs 인 쿼리의 경우 다음 함수 중 하나를 사용하여 집계된 값을 표시할 수 있습니다:

    데이터 유형이 로그일 때 쿼리 작성 시 집계 옵션
    집계 설명
    개수 선택한 시간 범위 내의 총 로그 수입니다.
    개별 개수 선택한 시간 범위 내의 고유 로그 수입니다.
    합계 선택한 시간 범위 내의 모든 로그의 합계입니다.
    최소 선택한 시간 범위 내의 로그 중 가장 작은 값입니다.
    최대 선택한 시간 범위 내의 로그 중 가장 큰 값입니다.
    평균 선택한 시간 범위 내의 모든 로그의 평균값입니다.
    백분위수 XX 로그의 XX%에 해당하는 값을 나타냅니다. 예를 들어 백분위수 95는 로그의 95%가 속하는 값입니다.

    데이터 유형이 Metrics 인 쿼리의 경우 다음 함수 중 하나를 사용하여 계산된 값을 표시할 수 있습니다:

    데이터 유형이 메트릭일 때 쿼리 작성 시 계산 옵션
    계산 설명
    인스턴트 현재 시점의 값입니다.
    마지막 선택한 시간 범위 내의 가장 최근 값입니다.
    최소 선택한 시간 범위 내에서 가장 작은 값입니다.
    최대 선택한 시간 범위 내에서 가장 큰 값입니다.
    평균 선택한 시간 범위 내의 모든 데이터 포인트의 평균값입니다.
    합계 선택한 시간 범위 내의 모든 데이터 포인트의 총합입니다.
    없음 계산이 적용되지 않습니다. 원시 데이터가 사용됩니다.

  6. 여러 게이지를 생성하려면 그룹화 기준에 1개 이상의 필드를 추가합니다.

3단계: 위젯 구성하기

다음 단계를 완료하십시오.

  1. 액션 아이콘 액션 아이콘 클릭합니다. 그런 다음 편집 모드를 선택합니다.

  2. 범례 관리 옵션을 선택합니다. 유효한 값은 Group 및 Threshold 입니다.

    그룹은 서버 또는 애플리케이션과 같은 다양한 데이터 엔티티를 기준으로 범례를 구성하여 각각을 별도의 항목으로 표시합니다.

    임계값은 정상, 경고, 심각 등 미리 정의된 한계에 따라 값을 분류하여 메트릭이 허용 가능한 범위 내에 있는지 또는 경고 상태로 넘어갔는지 시각화하는 데 도움이 됩니다.

  3. 시각적 관리 섹션에서 데이터를 시각화할 방법을 선택합니다.

    안쪽 호는 쿼리의 실제 값을 표시합니다.

    바깥쪽 호는 사용자가 정의한 임계값을 표시합니다.

    안쪽 호, 바깥쪽 호 또는 둘 다를 활성화하여 속도계나 다이얼처럼 지정된 범위 내에서 단일 값을 표시할 수 있습니다.

    내부 호와 외부 호를 비활성화하면 쿼리의 수치 결과가 추가 시각화 없이 STAT 위젯으로 표시됩니다. 이 경우 임계값 색상을 값에 적용할지 배경에 적용할지 결정할 수 있습니다. 구성의 이 부분에서는 원하는 임계값 색상 옵션을 설정합니다. 값을 선택하여 값의 임계값 색상을 설정하거나 배경을 설정하여 임계값 색상으로 배경을 설정할 수 있습니다.

  4. 임계값 섹션을 구성합니다.

    임계값은 사용자가 설정한 값으로, 이를 충족하거나 초과하면 쿼리 결과에 따라 비주얼리제이션의 모양이 변경됩니다. 값은 백분율 또는 절대 숫자 중에서 선택할 수 있습니다.

    임계값 유형을 선택합니다. 유효한 옵션은 특정 숫자를 값으로 정의하려면 absolute, 최소값 또는 최대값에 상대적인 값을 정의하려면 percentage 입니다.

    임계값의 색상을 변경할 수 있습니다.

    임계값을 설정하고 임계값을 설명하는 레이블을 추가할 수 있습니다.

    임계값을 추가할 수 있습니다.

4단계: 위젯 저장하기

다음 단계를 완료하십시오.

  1. [선택 사항] 선택한 대시보드와 다른 시간 범위를 사용하려면 위젯의 대시보드 시간을 설정합니다.

  2. 저장을 클릭하여 위젯을 저장합니다.

  3. [선택 사항으로] 위젯에 대한 직접 링크를 공유할 수 있습니다. 액션 아이콘 액션 아이콘 클릭합니다. 그런 다음 공유 위젯 URL 을 선택하고 URL 을 복사합니다.

    대시보드에 액세스할 수 있는 사람은 누구나 공유 링크를 열어 위젯을 상황에 맞게 볼 수 있습니다.

    공유 위젯 URL은 항상 대시보드의 마지막으로 저장된 버전을 반영합니다. 위젯이나 레이아웃을 변경한 경우 공유하기 전에 대시보드를 저장하세요.

  4. [선택 사항으로] 사용자 지정 작업을 추가합니다. 자세한 내용은 작업을 사용하여 타사 서비스와 통합하기를 참조하세요.