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

You can enable the multi-value option to allow users to select multiple values from a dropdown instead of just one. This is useful when you want to filter data across multiple criteria simultaneously.

Multi-value is available for Query and List variable types. Text field variables don't support the multi-value option.

To enable multi-value:

1. When creating a Query or List template variable, select the Multi-value option.

2. In your widget queries, use the IN operator instead of = to handle multiple selected values.

   / You can enable the multi-value option from the display options section when creating a variable of type NRQL/ENUM. /

   Here's an example where you'd name your variable {{MultiValue}} and use this query to populate its values:

   SELECT uniques(eventId) FROM AjaxRequest

   카피

   / <img width="30%;" title="Multi-value template variable example" alt="Multi-value template variable example" src="/images/dashboards_screenshot-crop_add-multivalue.webp" /> /

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

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

   카피

   / <img width="80%;" title="Creating a widget" alt="Creating a widget" src="/images/dashboards_screenshot-full_multivalue-add-widget.webp" /> /

While you can only define one template variable at a time, you can reference multiple variables within the same widget.

For this example, you need to have the two variables set up:

1. countryCode variable: Use the query shown earlier in this document:

   SELECT uniques(countryCode) FROM PageAction SINCE 2 days ago

   카피

2. city variable with a similar query:

   SELECT uniques(city) FROM PageView SINCE 1 week ago

   카피

   Here's an example using the above template variables with single values to create the widget:

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

   카피

   / <img title="Creating a widget using multiple variables" alt="Creating a widget using multiple variables" src="/images/dashboards_screenshot-crop_add-widget-multiple-variable.webp" /> /

   If your variables support multiple values (such as Chicago, New York, Paris for your city variable), you need to use 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="Creating the release version variable" alt="Creating the release version variable" src="/images/dashboards_screenshot-crop_add-var-release-version.webp" /> /

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

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

/ <img title="Creating the widget" alt="Creating the widget" src="/images/dashboards_screenshot-crop_add-widget-aparse.webp" /> /

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

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

/ <img title="Creating the widget" alt="Creating the widget" src="/images/dashboards_screenshot-crop_add-widget-capture.webp" /> /

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

Here's an example. You define a string template variable with the following values:

• Name to use in queries: line_filter

• 유형: Text field

• Default value: %@%.com

• Output format: String

  / <img width="40%;" title="Add LIKE as template variable" alt="Add LIKE as template variable" src="/images/dashboards_screenshot-crop_add-var-like-filter.webp" /> /

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

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

  카피

  / <img title="Add LIKE as template variable" alt="Add LIKE as template variable" src="/images/dashboards_screenshot-crop_add-widget-like-filter.webp" /> /

  또는 다음과 같이:

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

  카피

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

For example, you might create a template variable named {{userAgentName}} that would look like:

SELECT uniques(userAgentName) FROM PageAction

/ <img width="30%;" title="Creating the variable" alt="Creating the variable" src="/images/dashboards_screenshot-crop_add-var-facet.webp" /> /

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

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

/ <img title="Creating widget using facet" alt="Creating widget using facet" src="/images/dashboards_screenshot-crop_add-widget-facet.webp" /> /

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

For example, you might create a {{location}} variable:

• Name to use in queries: location

• 유형: List

• Values separated by commas: countryCode and city

• Output format: Identifier

  / <img width="40%;" title="Adding the variable for dynamic grouping" alt="Adding the variable for dynamic grouping" src="/images/dashboards_screenshot-crop_add-var-dynamic-grouping.webp" /> /

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

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

  카피

  / <img title="Adding the widget for dynamic grouping" alt="Adding the widget for dynamic grouping" src="/images/dashboards_screenshot-crop_add-widget-dynamic-grouping.webp" /> /

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

For example, you could create a {{percentile}} variable:

• Name to use in queries: percentile

• 유형: List

• Values separated by commas: 55 and 90

• Output format: Number

  / <img width="40%;" title="Adding the variable for dynamically change the percentile" alt="Adding the variable for dynamically change the percentile" src="/images/dashboards_screenshot-crop_add-var-dynamic-percentile.webp" /> /

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

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

  카피

  / <img title="Adding the widget for dynamically change the percentile" alt="Adding the widget for dynamically change the percentile" src="/images/dashboards_screenshot-crop_add-widget-dynamic-percentile.webp" /> /

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

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

/ <img title="Use variables to filter" alt="Use variables to filter" 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="Example form" alt="A screenshot showing the variable form" 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"
}

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