템플릿 변수: 대시보드를 동적으로 필터링

다중 값 옵션을 활성화하면 사용자가 드롭다운 메뉴에서 하나가 아닌 여러 개의 값을 선택할 수 있습니다. 이 기능은 여러 기준에 따라 동시에 데이터를 필터링하려는 경우에 유용합니다.

쿼리 및 목록 변수 유형에는 다중 값이 사용 가능합니다. 텍스트 필드 변수는 다중값 옵션을 지원하지 않습니다.

다중값을 활성화하려면:

1. 쿼리 또는 목록 템플릿 변수를 생성할 때 Multi-value 옵션을 선택합니다.

2. 위젯 쿼리에서 = 대신 IN 연산자를 사용하여 선택한 여러 값을 처리합니다.

   / NRQL/ENUM 유형의 변수를 생성할 때 표시 옵션 섹션에서 다중 값 옵션을 활성화할 수 있습니다. /

   다음은 변수 이름을 {{MultiValue}} 으로 지정하고 이 쿼리를 사용하여 값을 채우는 예입니다.

   SELECT uniques(eventId) FROM AjaxRequest

   카피

   / <img width="30%;" title="다중 값 템플릿 변수 예시" alt="다중 값 템플릿 변수 예시" src="/images/dashboards_screenshot-crop_add-multivalue.webp" /> /

   그런 다음 다음 쿼리를 사용하여 위젯을 만듭니다.

   SELECT count(*) FROM AjaxRequest WHERE eventId IN ({{MultiValue}})

   카피

   / <img 너비="80%;" title="답 만들기" alt="답 만들기" src="/images/dashboards_screenshot-full_multivalue-add-위젯.webp" /> /

한 번에 하나의 템플릿 변수만 정의할 수 있지만, 동일한 위젯 내에서 여러 변수를 참조할 수 있습니다.

이 예에서는 두 개의 변수를 설정해야 합니다.

1. countryCode 변수: 이 문서의 앞부분에서 표시된 쿼리를 사용합니다.

   SELECT uniques(countryCode) FROM PageAction SINCE 2 days ago

   카피

2. city 비슷한 쿼리를 사용한 변수:

   SELECT uniques(city) FROM PageView SINCE 1 week ago

   카피

   다음은 단일 값을 갖는 위의 템플릿 변수를 사용하여 위젯을 만드는 예입니다.

   SELECT countryCode, city FROM PageAction 
   WHERE countryCode = {{countryCode}} AND city = {{city}}

   카피

   / <img title="여러 변수를 사용하여 위젯 만들기" alt="여러 변수를 사용하여 위젯 만들기" src="/images/dashboards_screenshot-crop_add-위젯-multiple-variable.webp" /> /

   변수가 여러 값을 지원하는 경우(예: city 변수의 경우 Chicago, New York, Paris ) IN 사용해야 합니다.

   SELECT countryCode, city FROM PageAction 
   WHERE countryCode IN ({{countryCode}}) AND city IN ({{city}})

   카피

변수와 regex를 사용하여 필터의 일부가 고정된 것이 확실한 경우 필터를 만들 수 있습니다.

LIKE사용하려면 이 부분 일치를 사용해야 합니다.

릴리스 버전별로 필터링한다고 가정해 보겠습니다. 쿼리는 다음과 같은 것을 반환합니다. release-1234 .

aparse 사용하여 변수를 생성하여 버전 번호를 구문 분석할 수 있습니다.

SELECT uniques(aparse(platformVersion, 'release-*')) FROM PageView

/ <img width="40%;" title="릴리스 버전 변수 만들기" alt="릴리스 버전 변수 만들기" src="/images/dashboards_screenshot-crop_add-var-release-version.webp" /> /

그런 다음 다음 쿼리를 사용하여 위젯을 만듭니다.

SELECT count(*) FROM PageAction 
WHERE aparse(platformVersion, 'release-*') IN ({{releaseversion}}) FACET platformVersion

/ <img title="위젯 만들기" alt="위젯 만들기" src="/images/dashboards_screenshot-crop_add-위젯-aparse.webp" /> /

또는 원하는 경우 capture 명령을 사용할 수 있습니다.

SELECT count(*) FROM PageAction 
WHERE capture(platformVersion, r'release-(?P<platformVersion>\d+)') IN ({{releaseversion}}) FACET platformVersion

/ <img title="위젯 만들기" alt="위젯 만들기" src="/images/dashboards_screenshot-crop_add-위젯-capture.webp" /> /

LIKE 및 RLIKE 템플릿 변수로 사용하여 대시보드에서 데이터를 필터링할 수 있습니다. 이 기능을 사용하려면 템플릿 변수를 생성할 때 추가하는 값은 값의 시작과 끝에 % 와일드카드 기호를 사용해야 합니다.

예를 들어 보겠습니다. 다음 값을 사용하여 문자열 템플릿 변수를 정의합니다.

• 쿼리에 사용할 이름: line_filter

• 유형: Text field

• 기본값: %@%.com

• 출력 형식: String

  / <img width="40%;" title="LIKE를 템플릿 변수로 추가" alt="LIKE를 템플릿 변수로 추가" src="/images/dashboards_screenshot-crop_add-var-like-filter.webp" /> /

  그런 다음 위젯 차트를 만들고 다음과 같이 변수를 사용할 수 있습니다.

  FROM NrdbQuery SELECT user WHERE user LIKE {{like_filter}}

  카피

  / <img title="LIKE를 템플릿 변수로 추가" alt="LIKE를 템플릿 변수로 추가" src="/images/dashboards_screenshot-crop_add-위젯-like-filter.webp" /> /

  또는 다음과 같이:

  FROM NrdbQuery SELECT user WHERE user RLIKE {{like_filter}}

  카피

문자열 출력 형식으로 NRQL 유형의 변수를 생성하고 FACET 절 뒤에 사용하여 다른 값으로 그룹화할 수 있습니다.

예를 들어, 다음과 같은 {{userAgentName}} 이라는 템플릿 변수를 만들 수 있습니다.

SELECT uniques(userAgentName) FROM PageAction

/ <img width="30%;" title="변수 생성" alt="변수 생성" src="/images/dashboards_screenshot-crop_add-var-facet.webp" /> /

그런 다음 다음 쿼리를 사용하여 위젯을 만듭니다.

SELECT count(*) FROM PageAction 
WHERE userAgentName={{userAgentName}} FACET userAgentName

/ <img title="facet을 사용하여 위젯 만들기" alt="facet을 사용하여 위젯 만들기" src="/images/dashboards_screenshot-crop_add-위젯-facet.webp" /> /

identifier 출력 형식으로 변수를 만들고 FACET 절 뒤에 사용하여 다른 값으로 그룹화할 수 있습니다.

예를 들어, {{location}} 변수를 만들 수 있습니다.

• 쿼리에 사용할 이름: location

• 유형: List

• 쉼표로 구분된 값: countryCode 및 city

• 출력 형식: Identifier

  / <img width="40%;" title="동적 그룹화를 위한 변수 추가" alt="동적 그룹화를 위한 변수 추가" src="/images/dashboards_screenshot-crop_add-var-dynamic-grouping.webp" /> /

  그런 다음 다음 쿼리를 사용하여 위젯을 만듭니다.

  SELECT count(*) FROM PageAction FACET {{location}}

  카피

  / <img title="동적 그룹화를 위한 위젯 추가" alt="동적 그룹화를 위한 위젯 추가" src="/images/dashboards_screenshot-crop_add-위젯-dynamic-grouping.webp" /> /

출력 형식이 number 인 변수를 만들고 백분위수 함수 내에서 사용할 수 있습니다.

예를 들어, {{percentile}} 변수를 만들 수 있습니다.

• 쿼리에 사용할 이름: percentile

• 유형: List

• 쉼표로 구분된 값: 55 및 90

• 출력 형식: Number

  / <img width="40%;" title="백분위수를 동적으로 변경하기 위한 변수 추가" alt="백분위수를 동적으로 변경하기 위한 변수 추가" src="/images/dashboards_screenshot-crop_add-var-dynamic-백분위수.webp" /> /

  그런 다음 다음 쿼리를 사용하여 위젯을 만듭니다.

  SELECT percentile(duration, {{percentile}}) FROM PageAction

  카피

  / <img title="백분위수를 동적으로 변경하기 위한 개념 추가" alt="백분위수를 동적으로 변경하기 위한 개념 추가" src="/images/dashboards_screenshot-crop_add-위젯-dynamic-백분위수.webp" /> /

필터링에 변수를 사용하려면 다음과 같이 WHERE 절의 오른쪽에 생성된 변수를 추가하기만 하면 됩니다.

SELECT countryCode, city FROM PageAction 
WHERE countryCode IN ({{countryCode}})

/ <img title="변수를 사용하여 필터링" alt="변수를 사용하여 필터링" src="/images/dashboards_screenshot-crop_variables-to-filter.webp" /> /

기본적으로 "타임 피커 무시" 옵션이 활성화되어 있어 대시보드의 타임 1 hour 에 다른 값이 선택된 경우에도(예: 5 minutes, 3 hours, 등). 이 경우의 예외는 쿼리에 SINCE 절로 설정된 명시적 시간 범위가 있는 경우입니다. 예를 들어 다음과 같습니다.

SELECT uniques(eventId) 
FROM AjaxRequest 
SINCE 5 minutes ago

결과는 지난 5분 동안의 범위에 있습니다.

"타임 피커 무시" 옵션이 꺼지면 쿼리는 타임 피커에서 선택한 값으로 실행됩니다. 예를 들어, 아래 스크린샷과 같이 '라벨 피커'를 30분으로 설정하면, 변수 편집 폼에서 '라벨 피커 무시' 필드가 꺼짐으로 설정됩니다.

그러면 지난 30분 동안의 값이 나옵니다. 타임 피커 값을 Default 으로 설정하고 쿼리에 SINCE 절이 있는 경우 최신 값이 쿼리를 실행하는 데 사용됩니다.

/ <img title="예시 양식" alt="변수 양식을 보여주는 스크린샷" src="/images/dashboards_screenshot-crop_example-form.webp" /> /

때로는 다양한 유형의 데이터에 동일한 규칙을 적용하는 쿼리가 있습니다. 다음은 데이터 유형을 제외하고 동일한 두 위젯의 예입니다.

• 위젯 1:

  SELECT count(*) FROM DataType1 SINCE 1 day ago

  카피

• 위젯 2:

  SELECT count(*) FROM DataType2 SINCE 1 day ago

  카피

  두 가지 별도의 단어를 만드는 대신, Identifier [출력 형식] 에 대한 Output format [제외] 가 있는 변수로 하나의 단어를 만들 수 있습니다. 그런 다음 FROM 절에서 이를 사용하여 다양한 데이터 유형을 쿼리할 수 있습니다.

  예를 들어, DataType1 및 DataType2 라는 두 가지 가능한 값을 사용하여 List [목록] 유형의 {{dataType}} 변수를 생성할 수 있습니다. Output Format [출력 형식을] Identifier [식별자] 로 설정합니다.

  

  그런 다음 위젯을 만들고 실행합니다.

  

대시보드 JSON 관리 기능을 사용하면 목록 기반 변수의 값에 대한 사용자 지정 제목이나 레이블을 정의할 수 있습니다. 이를 통해 변수의 드롭다운 메뉴에 나타나는 내용을 변경할 수 있습니다.

예를 들어, 다음과 같은 변수가 있다고 가정해 보겠습니다.

{
    "name": "list_string",
    "items": [
      {
        "title": null,
        "value": "1"
      },
      {
        "title": null,
        "value": "2"
      },
      {
        "title": null,
        "value": "3"
      }
    ],
    "defaultValues": [],
    "nrqlQuery": null,
    "options": {
      "excluded": false
    },
    "title": "List of string",
    "type": "ENUM",
    "isMultiSelection": false,
    "replacementStrategy": "STRING"
  }

JSON을 열고 title 필드에 값을 추가하는 경우:

{
  "name": "list_string",
  "items": [
    {
      "title": "Title One",
      "value": "1"
    },
    {
      "title": "Title Two",
      "value": "2"
    },
    {
      "title": "Title Three",
      "value": "3"
    }
  ],
  "defaultValues": [],
  "nrqlQuery": null,
  "options": {
    "excluded": false
  },
  "title": "List of string",
  "type": "ENUM",
  "isMultiSelection": false,
  "replacementStrategy": "STRING"
}

추가한 제목은 해당 변수의 드롭다운 메뉴에 표시됩니다. 이는 변수나 위젯의 논리에 전혀 영향을 미치지 않습니다.