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

먼저 템플릿 변수를 정의합니다. 위젯을 생성하기 위해 NRQL 쿼리에서 사용할 변수입니다.

변수를 정의하려면:

1. 변수가 없는 새 대시보드에서 편집을 클릭합니다. 버튼을 클릭한 후 왼쪽 상단에 있는 + Add variable 버튼을 클릭하세요. 변수 추가를 마쳤으면 Done editing 클릭합니다.

   대시보드에 위젯이 포함된 경우 + Add variable 버튼을 클릭합니다.

   

2. Add variable 워크플로우를 완료하세요. 다음은 각 필드에 대한 몇 가지 규칙과 팁입니다.

   들	세부
   쿼리에 사용할 이름	변수의 이름입니다. 이것이 {{...}} 로 둘러싸인 쿼리에서 사용할 것입니다. 예를 들어 여기서 country 을 이름으로 사용하면 쿼리를 작성할 때 {{country}} 로 변수를 호출하게 됩니다. 변수 이름은 문자로 시작해야 하며 문자, 숫자 및 밑줄을 포함할 수 있습니다.
   이름 표시하기	선택 과목. 대시보드 사용자가 변수가 무엇을 나타내는지 알 수 있도록 변수가 대시보드 위에 표시되는 방식입니다. 비워두면 기본 이름 값을 사용합니다.
   유형	세 가지 옵션이 있습니다. Query: 드롭다운 메뉴에 사용되는 옵션의 동적 목록을 반환하는 쿼리를 작성할 수 있습니다. 예를 들어 다음 쿼리는 country 값의 동적 목록을 반환합니다. SELECT uniques(countryCode) FROM PageAction since 2 days ago 카피 쿼리 작성에 대한 규칙 및 팁은 쿼리 유형 변수 를 참조하십시오. List: 드롭다운 메뉴의 옵션을 채우는 데 사용되는 쉼표로 구분된 값 목록입니다. 예를 들어 다음과 같은 목록을 사용하여 country 값 목록을 수동으로 정의할 수 있습니다. ES, US, CA. Text field: 선택할 수 있는 값의 드롭다운 메뉴 대신 대시보드 사용자가 입력한 텍스트를 필터링할 수 있습니다.
   계정	query 유형에만 존재합니다. 계정이 여러 개인 조직의 경우 쿼리되는 계정을 설정합니다.
   질문	uniques (attribute)사용하여 여기에 쿼리를 작성하십시오.
   타임피커 무시	선택 과목. 쿼리 유형에만 존재합니다. 이 옵션을 끄면 대시보드에서 선택한 타임 피커의 값을 사용하여 쿼리가 실행됩니다. 이렇게 하면 타임 피커의 값이 변경될 때 변수의 드롭다운 메뉴 결과가 새로 선택한 시간 범위에 동적으로 반응하게 됩니다.
   다중 선택	선택 과목. 이 옵션을 사용하면 드롭다운에서 단일 선택 대신 동시에 여러 선택을 허용할 수 있습니다.
   기본값	선택 과목. 대시보드가 필터링할 기본값입니다. 예를 들어 위의 country 쿼리를 사용한 경우 ES 기본값으로 입력하면 대시보드가 자동으로 해당 값으로 필터링됩니다. 모든 가능성을 선택할 수도 있습니다. WHERE 절에서 여러 값을 사용하려면 = 대신 IN 사용해야 합니다.
   출력 형식	이를 통해 변수에 의해 생성된 데이터가 쿼리에서 처리되는 방식을 변경할 수 있습니다. 여기에서 선택한 옵션은 나중에 위젯에 추가할 쿼리와 관련이 있습니다. default 옵션은 대부분의 쿼리에 사용되는 더 일반적인 옵션이므로 문자열입니다. default 옵션을 다음 중 하나로 변경할 수 있습니다. String : 숫자가 아닌 텍스트 값에 사용합니다. Number : 숫자 값에 사용합니다. Identifier : 이벤트 이름이나 패싯 이름과 같은 쿼리의 일부를 대체하려는 경우에 사용합니다.

   country 값에 대한 템플릿 변수의 모양에 대한 다음 예를 참조하세요.

   

   템플릿 변수를 정의하고 나면 생성된 템플릿 변수를 사용하는 위젯을 추가할 수 있습니다.

템플릿 변수를 구성한 후에는 쿼리에서 정의한 변수를 사용하는 대시보드에 위젯이 필요합니다.

위젯을 만들려면:

1. 대시보드에서 오른쪽 상단에 있는 + Add widget 버튼을 클릭하세요.

2. 2가지 옵션이 있습니다.

   • 차트를 추가합니다. 쿼리 작성기를사용하여 위젯을 만듭니다.
   • 텍스트, 이미지 또는 링크를 추가합니다. Markdown 편집기를 사용하여 자신의 콘텐츠를 추가하는 위젯을 만듭니다.

3. Add a chart 옵션을 선택합니다.

4. 쿼리를 추가하고 Run 클릭합니다.

   1단계에서 언급한 예를 따르면 다음과 같습니다.

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

   카피
   

   이는 템플릿 변수를 값으로 허용하는 NRQL 절입니다: SELECT, FROM, FACET, ORDER BY 및 WHERE.

   대신 다음 NRQL 절 목록은 템플릿 변수를 인수로 허용하지 않습니다: AS, COMPARE WITH, LIMIT, OFFSET, SINCE, SLIDE BY, TIMESERIES, UNTIL 및 WITH....

5. 딸깍 하는 소리 Save

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

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

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

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

또는 다음과 같이:

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

문자열 출력 형식으로 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분, 3분). 시간 등). 해당 경우의 예외는 쿼리에 SINCE 절을 사용하여 명시적인 시간 범위가 설정된 경우입니다. 예를 들면 다음과 같습니다.

SELECT uniques(eventId) 
FROM AjaxRequest 
SINCE 5 minutes ago

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

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

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