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

맞춤형 대시보드의 경우 template variables 사용하여 차트 및 기타 설명을 동적으로 필터링할 수 있습니다. 템플릿 변수를 사용하면 대시보드를 더 유용하게 만들고 다양한 사용 사례에 재사용할 수 있는 대시보드를 더 쉽게 만들 수 있습니다.

템플릿 변수를 사용하는 이유는 무엇입니까?

템플릿 변수는 대시보드 작성자가 선택한 특정 메타데이터 값을 기반으로 전체 대시보드를 필터링하는 강력하고 동적인 방법입니다. 템플릿 변수 사용의 이점은 다음과 같습니다.

• 대시보드 사용을 더 쉽게 만들어줍니다. 사용자는 데이터 구조를 이해할 필요가 없으며, 여러분이 설정한 다양한 필터 옵션 중에서 선택하기만 하면 됩니다.

• 이를 통해 여러 용도로 복제하고 사용자 정의할 수 있는 재사용 가능한 대시보드 템플릿을 만들 수 있습니다.

다음은 대시보드 상단에서 볼 수 있는 여러 템플릿 변수가 있는 대시보드의 예입니다.

템플릿 변수를 사용하면 다양한 변수와 필터를 설정하여 필요한 대시보드 환경을 만들 수 있습니다. 만들 수 있는 경험의 예:

• 앱 이름을 선택하는 드롭다운
• 특정 지역을 선택하는 드롭다운
• 특정 기간 또는 기타 숫자 값을 선택하는 드롭다운
• 자유 텍스트 필드를 사용하여 일치하는 문자열을 찾는 필터

더욱이 이제는 쿼리를 수정하지 않고도 변수를 포함할지 여부를 결정할 수 있습니다. 자세한 내용은 변수 포함 섹션을 참조하세요.

변수 포함 및 제외

Include variable 토글을 사용하면 원하는 값을 설정하고 대시보드에 해당 값을 포함하거나 제외할 수 있습니다. 자세한 내용은 템플릿 변수 섹션을 참조하세요.

예를 들어, 변수 내의 특정 값과 관련이 없는 문제를 조사할 수 있습니다. 이런 경우, 가능한 모든 옵션을 선택하더라도 변수의 기존 값으로 인해 쿼리 결과가 제한될 수 있습니다. 이 문제를 해결하려면 쿼리에서 변수를 제외하면 됩니다. 이렇게 하면 변수의 조건을 효과적으로 제거하고 중립적인 부울 값(참 또는 거짓)으로 바꿔서 쿼리의 유효성을 보장하고 포괄적인 결과를 반환합니다.

예시

countryCode 변수를 기준으로 결과를 필터링하는 쿼리를 생각해 보세요. 필터링 없이 모든 국가의 데이터를 보려면 변수를 제외할 수 있습니다.

기존 쿼리:

FROM PageAction 
SELECT count(*) AS 'views' 
WHERE countryCode IN ({{countryCode}}) AND appName = 'Test App' FACET countryCode

제외된 변수가 있는 쿼리:

FROM PageAction 
SELECT count(*) AS 'views' 
WHERE true AND appName = 'Test App' FACET countryCode

이 기능은 다음과 같은 경우에 특히 유용합니다.

• 변수에 허용되는 최대값(인스턴스의 경우 기본적으로 고유 항목에 대한 최대 결과는 5000개)보다 많은 값이 있거나 매우 많은 수가 있습니다. 기본적으로 변수를 비활성화하도록 선택하면 성능이 상당히 향상됩니다.

• 변수의 데이터 소스가 쿼리하는 데이터베이스와 다릅니다. 이런 경우에는 "모두 선택"을 사용하여 데이터베이스에서 모든 값을 선택하는 것만으로는 충분하지 않습니다. 변수를 제외하면 데이터베이스에서 모든 값을 검색할 수 있습니다.

포함 변수에 대한 제한 사항:

• FACET 케이스에서 사용될 경우, 조건이 참으로 바뀌고 항상 참인 조건으로 변환됩니다.

• 함수나 SELECT 문 등 다른 맥락에서 사용하면 다음 오류가 발생합니다. "Unknown function Disable_variable()". 이는 비활성화 변수 기능이 아직 이러한 특정한 경우에 구현되지 않았기 때문입니다.

요구 사항 및 제한 사항

템플릿 변수는 사용자 지정 대시보드용 위젯을 만드는 컨텍스트에서만 사용할 수 있습니다. NRQL 쿼리에서 변수를 사용하려면 NRQL 변수 를 참조하십시오.

템플릿 변수가 있는 쿼리는 대시보드 컨텍스트에서만 사용할 수 있습니다. 이러한 이유로 일부 쿼리 관련 기능이 작동하지 않습니다. 예를 들어 Export dashboard as PDF 옵션은 변수가 있는 위젯을 지원하지 않습니다.

쿼리 추가에 대한 중요 사항:

• 정의한 변수는 {{ … }} 괄호 안에 들어갑니다.

• 변수는 문자열 값을 생성합니다.

• 검색어를 만들 때 도움이 되도록 색상 코드가 있습니다.

  • 절 FROM, SELECT, FACET및 WHERE은 분홍색입니다.
  • 식별자는 검은색입니다.
  • 기능은 파란색입니다.
  • 문자열은 녹색입니다.
  • 정수는 갈색입니다.

• NRQL을 사용하여 쿼리를 작성하는 방법에 대해 자세히 알고 싶다면 NRQL 사용 방법: 쿼리 메커니즘 페이지를 참조하세요.

쿼리 작성과 관련된 제한 사항은 쿼리 작성 을 참조하십시오.

템플릿 변수 사용

템플릿 변수를 생성하는 과정을 안내한 다음 여러 종류의 템플릿 변수에 대한 몇 가지 예를 제공합니다.

템플릿 변수 생성은 두 단계로 구성됩니다.

템플릿 변수 정의 및 해당 변수를 참조하는 위젯 추가를 완료하면 템플릿 변수 막대에서 다른 옵션을 선택하고 선택한 항목에 따라 위젯이 변경되는지 확인하여 예상대로 작동하는지 확인할 수 있습니다.

오른쪽은 결과 위젯의 예이고, 왼쪽에는 country 드롭다운 메뉴가 있습니다.

쿼리 유형 템플릿 변수 작성 규칙

템플릿 변수 정의 섹션 에서 설명한 대로 변수 유형에는 쿼리, 목록, 텍스트 필드의 세 가지가 있습니다. 쿼리 유형 변수는 값 목록을 반환하는 작업 쿼리를 생성해야 하기 때문에 생성하기가 가장 복잡합니다. 이 값은 대시보드 상단의 템플릿 변수 표시줄에 있는 드롭다운 메뉴를 채우는 데 사용됩니다.

값 목록을 반환하는 한 거의 모든 NRQL 쿼리를 사용할 수 있습니다. 이를 위해 uniques 또는 keyset 함수를 사용할 수 있습니다.

uniques 사용:

FROM PageAction SELECT uniques(countryCode)

-- you can use the second param to define the maximum number of results to be listed.
FROM PageAction SELECT uniques(countryCode, 10000) --> this will return up to 10k results

keyset 사용:

-- with `keyset`, you'll get a list with all of the attributes from the table you're querying from
FROM PageAction SELECT keyset() SINCE 1 day ago

변수 내에 변수가 있을 수 없으므로 중첩 변수는 지원되지 않습니다.

몇 가지 예

다음은 몇 가지 다른 유형의 템플릿 변수 구현입니다.

다중 값 옵션 사용

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

다음은 {{MultiValue}} 라는 변수를 생성하고 고유한 모든 eventId의 목록을 반환하는 쿼리의 예입니다.

SELECT uniques(eventId) FROM AjaxRequest

카피

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

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

카피

하나의 위젯에 여러 변수 사용

한 번에 하나의 템플릿 변수만 정의할 수 있지만 단일 위젯에서 둘 이상의 템플릿 변수를 사용할 수 있습니다.

다음은 두 개의 템플릿 변수를 사용하는 쿼리의 예입니다. 이는 countryCode 및 city 템플릿 변수가 이미 생성되었으며 단일 값을 가지고 있다고 가정합니다.

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

카피

변수에 여러 값이 있는 경우(예: 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

카피

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

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

카피

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

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

카피

LIKE 및 RLIKE와 함께 변수와 정규 표현식 사용

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

여기에 예가 있습니다. 다음과 같이 문자열 변수를 정의합니다.

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

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

카피

또는 다음과 같이:

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

카피

NRQL 쿼리와 함께 변수 facet 사용

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

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

SELECT uniques(userAgentName) FROM PageAction

카피

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

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

카피

동적 그룹화에 변수 사용

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

예를 들어 countryCode 및 city 의 두 가지 가능한 값을 사용하여 목록 유형의 {{location}} 변수를 생성할 수 있습니다. 출력 형식을 identifier 로 설정합니다.

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

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

카피

변수를 사용하여 백분위수를 동적으로 변경

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

예를 들어 55 및 90 의 두 가지 가능한 값을 사용하여 list 유형의 {{percentile}} 변수를 생성할 수 있습니다. 출력 형식을 number 로 설정하려고 합니다.

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

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

카피

변수를 사용하여 필터링

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

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

카피

타임피커 무시 옵션을 사용하세요

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

SELECT uniques(eventId) 
FROM AjaxRequest 
SINCE 5 minutes ago

카피

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

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

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

변수를 사용하여 `FROM` 데이터 유형을 선택하세요.

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

• 위젯 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 [식별자] 로 설정합니다.

  

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