Grafana Panel Guide

Print

- Graph

General

 

  • Title- 패널 제목이며 입력함 제목은 패널 상단에 표시된다 
  • Description - 패널 상세 설명이며 패널의 왼쪽 상단 info 아이콘에 mouse over 시 표시된다.
  • Transparent - 이 옵션을 체크하면 패널의 단색 배경을 제거한다. 
  • Repeat - 변수의 값만큼 패널을 반복한다. 상세 내용 참고
  • Drilldown / detail link - 이 섹션에서 다른 Dashboard 또는 URL에 연결할 수있는 동적 링크를 패널에 추가 할 수 있다.


Metric

Metric 탭에서 시각화할 데이터 소스와 query를 정의한다. 데이터 소스 종류에 따라 Metric 설정은 다를 수 있다.(다음은 InfluxDB 타입의 Query 정의에 대한 설명이다). 

Cloud Z Monitoring에서는 InfluxDB 형태의 기본 datasource를 제공한다.

기본으로 제공하는 datasource외의 다른 datasource도 Configuration → Data Sources 메뉴를 사용하여 신규로 등록하여 사용 할 수 있다


- Filter data (WHERE)

태그 필터를 추가하려면 WHERE 조건의 오른쪽 버튼을 클릭한다. 태그 필터를 제거하려면 태그 키를 클릭하여 --remove tag filter--를 선택한다.


- Field & Aggregation 함수

SELECT 부분에서 필드와 함수를 지정해 준다. time으로 grouping 할 경우 집계 함수가 필요하다. 버튼을 클릭하여 field를 추가할 수 있고, * 를 입력하여 모든 field를 선택할 수 있다.


- Group By

Grouping하려면 GROUP BY 행에서 버튼을 클릭한다. 버튼 클릭 시 Dropdown 메뉴가 나타나며 여기서 grouping할 태그를 선택한다. 태그를 클릭하면 Remove 버튼이 생기며 이 클릭하여 태그를 삭제할 수 있다. 


- Text Editor Mode (RAW)

버튼을 클릭하여 Toggle Edit Mode를 선택하면 쿼리 모드로 전환된다.

Raw query를 사용할 경우 쿼리에 최소한 WHERE $ timeFilter가 있어야 한다. 또한 group by time과 집계 함수 항상 있어야 하며, 그렇지 않을 경우 InfluxDB가 수십만 개의 데이터를 반환할 수 있기 때문에 브라우저가 죽을 수 도 있다.


- Alias patterns

ALIAS BY 행에서 아래와 같이 패턴을 적용할 수 있다. 

                          $m - measurement name으로 대체(replace)된다

                          $measurement - measurement name으로 대체된다

                          $col - column name 대체됨

                          $tag_exampletag - exampletag의 값으로 대체된다. Syntax 는 $tag_yourTagName ($tag_ 으로 시작해야 함). 


- Templating

메트릭 쿼리에서 server, application 등 항목을 하드 코딩하는 대신 변수를 사용할 수 있다. 변수는 Dashboard 상단에  Dropdown 박스에서 볼 수 있다. Templating 기능에 대한 상세 내용 참고


- Query variable

변수를 Query type으로 생성하면 InfluxDB exploration (메타 데이터) query를 작성할 수 있다. 예를 들어, templating 변수의 query를 아래와 같이 작성하면 hostname 태그의 모든 값을 가진 변수를 생성할 수 있다.

SHOW TAG VALUES WITH KEY = "hostname"


Nested 변수도 사용할 수 있다. 예를 들어, region란 또 다른 변수를 사용하여 현재 선택된 region에 대한 호스트 값만 가진 hostname 변수를 아래와 같이 생성할 수 있다.

SHOW TAG VALUES WITH KEY = "hostname"  WHERE region =~ /$region/


- Using variables in queries

변수를 사용하기 위한 2가지 syntax가 있다.

$<varname> 예:

SELECT mean("value") FROM "logins" WHERE "hostname" =~ /^$host$/ AND $timeFilter GROUP BY time($__interval), "hostname"


[[varname]] 예:

SELECT mean("value") FROM "logins" WHERE "hostname" =~ /^[[host]]$/ AND $timeFilter GROUP BY time($__interval), "hostname"

첫 번째 syntax은 사용하는데 더 간단하긴 하지만 단어 중간에 변수를 사용할 수 없다. Multi-value 또는 Include all value 옵션들이 활성화되 있으면 Grafana는 라벨을 일반 텍스트에서 정규식 가능한 문자열로 변환한다. 그래서 = 대신 ~=을 사용해야한다.


Axes

Axes 탭은 Y, X 축에 대한 display 속성을 설정한다.



- Left Y / Right Y

             Show - Y을 표시여부

             Unit - Y값 표시 단위

             Scale - Y값에 대한 scale. (default은 Linear)

             Y-Min - Y의 최소 값. (default은 Auto)

             Y-Max - Y의 최대 값. (default은 Auto)

             Decimals - Y 값에 대한 소수의 개수(number of decimals)를 입력 (default은 Auto).

             Label - Y 축 라벨 (default은 null)


- X-Axis

            Show - 축 표시여부를 설정할수 있다.

  Mode - 아래 3가지 옵션이 있다.

             Time - 기본 옵션이며 X 축은 시간을 나타내며 데이터는 초, 분 등 시간으로 grouping 된다.

             Series - 데이터가 시간이 아닌 series으로 grouping 된다.


            Histogram - 그래프를 histogram으로 변환한다. Histogram은 숫자를 범위(range)로 grouping하는 일종의 막대 차트이며, 버킷(buckets) 또는 빈 (bins)이라고하기도 한다.
막대가 길수록 더 많은 데이터가 해당 범위에 있음을 나타낸다. 히스토그램과 버킷에 대해서 여기에서 참고.


- Y axes

              Align - Left Y 와 Right Y 축을 값으로 정렬한다 (기본값은 unchecked).

              Level - Align을 체크한 경우에만 사용 가능. 정렬에 사용할 값이며, Y = 0 (기본값 0)부터 시작한다.


Legend

- Options 

              Show - 범례 표시여무를 설정

              Table - 범례를 table에 표시

              To the right - 범례를 패널 오른쪽에 표시

              Width - To the right 를 선택한 경우에만 활성화된다. 범례의 최소 너비(width) 값을 설정


- Values 

   범례에 추가적인 정보를 표시 할 수 있다.

               Min - Metric query에서 return된 모든 값중 최소값 

               Max - Metric query에서 return된 모든 값중 최대 값

               Avg - Metric query에서 return된 모든 값의 평균

               Current - Metric query에서 return된 마지막 값

               Total - Metric query에서 return된 모든 값의 합계

               Decimal - 범례 값에 표시되는 소수의 개수(number of decimals)를 입력

- Hide series

  메트릭 쿼리에서 오는 series 값에 따라 series을 숨길 수 있다.

             With only nulls - Value = null (기본값은 unchecked)

             With only zeros - Value = zero (기본값은 unchecked)


Display

Display에서 그래프의 시각적 속성을 설정한다.

- Draw Modes

        Bars- 막대 차트로 값을 표시한다. 

        Lines - 값을 Line (선) 그래프로 표시한다.

        Points - 값을 point(점)으로 표시한다


- Mode Options

        Fill - 그래프를 채울 색상 양 (기본값 1). 0은 그래프를 안 채움.

        Line width - 선 너비 (기본값 1).

        Staircase - 그래프를 계단 처럼 그린다.

        Points Radius - Draw Modes에서 Points가 선택된 경우 Point의 크기(size)를 조정한다.


- Hover tooltip

        Mode - 특정 point에 mouse over 시 tooltip에 표시 할 series 개수를 설정한다. All series 또는 single (기본값은 All series).

        Sort order - Tooltip에서 series가 어떻게 정렬되는지 설정한다.  


- Stacking and Null value 
여러 series 있는 경우 그룹으로 display 할 수 있다.

        Stack- 각 series는 다른 시리즈 위에 쌓이어서 표시된다.

        Percent - Stack가 체크된 경우에만 사용  가능하고, 각 시리즈는 모든 시리즈의 합계(total)에 대한 비율로 그려진다.

        Null value - Null 값을 어떻게 표시할지 설정


- Series Overrides

이 섹션에서는 시리즈를 다른 시지즈과 다르게 렌더링 할 수 있도록 설정할 수 있다. 


Thresholds

한계점(threshold)을 사용하여 그래프에 임의의 선을 추가하여 그래프가 특정 값을 넘어갈 때를 쉽게 볼 수 있도록 해 준다. 


Time Range

Time range 탭에서는 현재 시간 범위를 무시하고 패널에 특정 시간을 재설정할 수 있다. 현재 시간 기준으로 또는 timeshift으로  설정 가능하다.


- Singlestat


                                                                      < 그림 : Singlestat panel 사용 예 >

Value

  1. Stat : 통계 필드를 사용하면 전체 쿼리가 단일 값으로 축소되는 기능을 설정할 수 있습니다.
    이렇게하면 전체 쿼리가 표시되는 단일 요약 값으로 줄어 듭니다.
    • min : 시리즈에서 가장 작은 값
    • max : 계열에서 가장 큰 값
    • avg : 계열에서 null이 아닌 모든 값의 평균
    • current : 계열의 마지막 값입니다. 계열이 null로 끝나면 이전 값이 사용됩니다.
    • total : 계열의 null이 아닌 모든 값의 합계
    • first : 시리즈의 첫 번째 값
    • delta : 시리즈에서 카운터의 총 증분 증가. 카운터 재설정을 고려하려고 시도했지만 이는 단일 인스턴스 메트릭에 대해서만 정확합니다.
      시계열의 총 카운터 증가를 표시하는 데 사용됩니다.
    • diff : '현재'(마지막 값)와 '첫 번째'의 차이
    • range : 'min'과 'max'의 차이. 게이지에 대한 변경 범위를 보여 주면 유용합니다.
  2. Prefix / Postfix : Prefix / Postfix 필드를 사용 하면 값 전후 에 표시 할 사용자 정의 레이블을 정의 할 수 있습니다.
    $__name변수는 메트릭 쿼리에서 시리즈 이름이나 별칭을 사용하려면 여기를 사용할 수 있습니다.
  3. Units : 단위는 패널 내의 단일 통계에 추가되며 값의 색상 및 임계 값 설정을 따릅니다.
  4. Decimals : 소수점 필드는 자동 소수점 정밀도를 무시하고, 명시 적으로 설정할 수 있습니다.
  5. Font Size :이 섹션을 사용하여 단일 상태 패널에서 다른 텍스트의 글꼴 크기 (예 : Prefix, 값 및 Postfix)를 선택할 수 있습니다.



Coloring

Singlestat Panel 구성의 색상 옵션을 사용하면 Singlestat 값을 기반으로 색상을 동적으로 변경할 수 있습니다.

  1. Background :이 확인란은 구성된 임계 값과 색상을 단일 상태 패널 배경 전체에 적용합니다.
  2. Thresholds : Singlestat 값에 따라 패널 내에서 배경 및 값 색상을 동적으로 변경합니다.
    임계 값 필드는 오른쪽에 직접 3 개의 색상에 해당하는 3 개의 범위를 나타내는 2 개의 쉼표로 구분 된 값을 허용합니다.
    예를 들어, 임계 값이 70, 90 인 경우 첫 번째 색상은 70미만을 나타내고, 두 번째 색상은 70과 90 사이를 나타내고 세 번째 색상은 90 이상을 나타냅니다.
  3. Colors : 색상 및 불투명도 선택
  4. Value :이 확인란은 구성된 임계 값과 색상을 요약 통계에 적용합니다.
  5. Invert order: :이 링크는 임계 값 색상 순서를 토글합니다. 예를 들어 : 녹색, 주황색, 빨간색 >> 빨간색, 주황색, 녹색 이됩니다.



Spark lines

스파크 라인은 요약 통계와 관련된 내역 데이터를 한눈에 파악할 수있는 좋은 방법입니다.
스파크 라인은 기존 그래프 패널과 다르게 작동하며 x 또는 y 축, 좌표, 범례 또는 그래프와 상호 작용하는 기능을 포함하지 않습니다.

  1. Show : 표시 확인란은 스파크 라인이 패널에 표시되는지 여부를 토글합니다. 선택하지 않으면 Singlestat 값만 나타납니다.
  2. Full Height : 스파크 라인이 전체 패널 높이를 차지하는지 확인하거나 기본 Singlestat 값보다 낮아야하는지 여부를 선택 취소하십시오.
  3. Y-Min : 최소 Y 값. (기본 자동)
  4. Y-Max : 최대 Y 값. (기본 자동)
  5. Line Color: :이 색상 선택은 스파크 라인 자체의 색상에 적용됩니다.
  6. Fill Color :이 색상 선택은 스파크 라인 아래 영역에 적용됩니다.

Gauge

게이지는 맥락에서 가치가 얼마나 높은지를 명확하게 보여줍니다. 값이 임계 값에 가까운 지 확인하는 좋은 방법입니다.
게이지는 색상 옵션에서 설정 한 색상을 사용합니다.

  1. Show : 표시 확인란이 게이지가 패널에 표시되는지 여부를 토글합니다. 선택하지 않으면 Singlestat 값만 나타납니다.
  2. Min / Max : 게이지의 시작점과 끝점을 설정합니다.
  3. Threshold Labels : 임계 값 레이블 을 표시 할 것인지 확인하십시오. 임계 값은 색상 옵션에서 설정됩니다.
  4. Threshold Markers : 임계 값을 표시하는 두 번째 미터가 있는지 확인하십시오.


Value/Range 텍스트 매핑을 사용하면 요약 통계 값을 명시 적 텍스트로 변환 할 수 있습니다.
텍스트는 값에 대해 정의 된 모든 스타일, 임계 값 및 사용자 정의를 존중합니다.
이것은 주요 Singlestat 값의 수를 컨텍스트 별 사람이 읽을 수있는 단어 또는 메시지로 변환하는 데 유용 할 수 있습니다.



- Table


테이블 패널은  시계열 및 테이블, 주석 및 JSON 데이터에 대한 여러 모드를 모두 지원합니다. 날짜 형식, 값 형식 및 색상 옵션도 제공합니다.  



Data

쿼리를 테이블로 변환하는 방법을 제어합니다. 


1. Table Transform : 데이터 / 메트릭 쿼리를 테이블 형식으로 변환하는 방법 

  • Time series to rows : 시계열을 행으로 사용
  • Time series to columns : 시계열을 열로 사용 
  • Trime series aggregations : 시계열을 집계처리 
  • Annotations : 대시보드에서 주석을 활성화한 경우 표에 주석을 표시할수 있습니다. (이경우 메트릭탬의 쿼리가 모두 무시됩니다.)
  • Table : 쿼리그대로 table을 로 변환합니다. 
  • JSON Data : 날짜 히스토그램 이 없는 Elasticsearch Raw Document 쿼리 또는 Elasticsearch 쿼리가있는 경우이 변환 모드를 사용하고  Column옵션을 사용하여 열을 선택 하십시오.(이경우에만 Column 옵션 사용가능)


Paging

Table panel의 Display 값을 설정합니다. 


  1.  Rows per page  : 테이블 표시 필드를 사용하면 페이지 당 행 수를 제어 할 수 있습니다.
     예) 테이블에 페이지 당 행 값이 10 인 95 개의 레코드가있는 경우 테이블은 10 페이지로 분할됩니다.
  2. Scroll : 스크롤 막대 확인란은 패널 내에서 스크롤하는 기능을 토글합니다.
    선택 해제하면 패널 높이가 커져 모든 행을 표시합니다.
  3. Font size : 글꼴 크기 필드를 사용하면 기본 글꼴 크기를 기준으로 패널의 크기를 늘리거나 줄일 수 있습니다.



  1. Apply to columns named : Metrics 쿼리의 결과 Column선택합니다. (정규식을 이용할 수 있습니다. )
  2. Column Header : 선택한 Column의 Header를 지정합니다. 다른명칭으로 변환하여 사용할때 정규식사용할경우 대체문자열이 포함될 수 있습니다. 
  3. +Add : 새 열 규칙을 추가합니다.
  4. Thresholds : 색상 모드 및 임계 값 제한을 지정합니다.
    - Thresholds : 임계값 설정
    - Color Mode : Cell / Value / Row / Disabled 선택가능
    - Colors : 설정된 임계값에 따라 변경될 색 (invert 클릭시 현재 설정된 색이 invert된다)
  5. Type : 지원되는 Type은 Number/String/Date/Hidden 입니다. Unit 항목에서 표현형식을 변경할 수 있습니다.
    - Number : 값을 숫자로만 표기합니다. Unit 항목으로 다양한 숫자 표현형식을 지정할 수 있고,
         Decimals에 소수점 자리수를 선택할 수 있습니다.
    - Date : YYYY(년도)MM(월)DD(날짜) HH(24시표현/h는 12단위 표현) mm(분)ss(초) SSS( Millisecond) 로
        표기 형식을 지정할 수 있습니다.
    - String : 값을 문자열로 표기합니다. String 항목설정시 Value Mappings 옵션을 사용할 수 있습니다.
       > value to text : 특정값을 다른 문자나 문자열로 변경할 수 있습니다.
       > range to text : 특정구간에 속하는 값인경우 다른 문자나 문자열로 변경할 수 있습니다.

이 답변이 유용합니까? 아니오

Send feedback
도움을 드리지 못해 죄송합니다. 피드백을 주시면 이 문서의 품질을 높이겠습니다.