사용자 지정 대시보드의 경우 템플릿 변수 를 사용하여 차트 및 기타 위젯을 동적으로 필터링할 수 있습니다. 템플릿 변수는 대시보드를 더 유용하게 만들고 다양한 사용 사례에 재사용할 수 있는 대시보드를 더 쉽게 만드는 데 도움이 됩니다.
템플릿 변수를 사용하는 이유는 무엇입니까? 템플릿 변수는 대시보드 작성자가 선택한 특정 메타데이터 값을 기반으로 전체 대시보드를 필터링하는 강력하고 동적인 방법입니다. 템플릿 변수 사용의 이점은 다음과 같습니다.
이를 통해 대시보드를 더 쉽게 사용할 수 있습니다. 사용자는 데이터 구조를 이해할 필요가 없지만 설정한 다양한 필터 옵션 중에서 선택할 수 있습니다. 이를 통해 재사용 가능한 대시보드 템플릿을 생성한 다음 다른 많은 용도에 맞게 복제하고 조정할 수 있습니다. 다음은 대시보드 상단에서 볼 수 있는 여러 템플릿 변수가 있는 대시보드의 예입니다.
템플릿 변수를 사용하면 다양한 변수와 필터를 설정하여 필요한 대시보드 환경을 만들 수 있습니다. 만들 수 있는 경험의 예:
앱 이름을 선택하는 드롭다운 특정 지역을 선택하는 드롭다운 특정 기간 또는 기타 숫자 값을 선택하는 드롭다운 자유 텍스트 필드를 사용하여 일치하는 문자열을 찾는 필터 요구 사항 및 제한 사항 템플릿 변수는 사용자 지정 대시보드용 위젯을 만드는 컨텍스트에서만 사용할 수 있습니다. NRQL 쿼리에서 변수를 사용하려면 NRQL 변수 를 참조하십시오.
템플릿 변수가 있는 쿼리는 대시보드 컨텍스트에서만 사용할 수 있습니다. 이러한 이유로 일부 쿼리 관련 기능이 작동하지 않습니다. 예를 들어 Export dashboard as PDF
옵션은 변수가 있는 위젯을 지원하지 않습니다.
쿼리 추가에 대한 중요 사항:
쿼리 작성과 관련된 제한 사항은 쿼리 작성 을 참조하십시오.
템플릿 변수 사용 템플릿 변수를 생성하는 과정을 안내한 다음 여러 종류의 템플릿 변수에 대한 몇 가지 예를 제공합니다.
템플릿 변수 생성은 두 단계로 구성됩니다.
1단계. 템플릿 변수 정의 먼저 템플릿 변수를 정의합니다. 위젯을 생성하기 위해 NRQL 쿼리에서 사용할 변수입니다.
변수를 정의하려면:
변수가 없는 새 대시보드에서 수정을 클릭합니다. 버튼을 클릭한 후 왼쪽 상단에 위치한 + Add variable 버튼을 클릭합니다. 변수 추가를 마치면 Done editing 클릭합니다.
대시보드에 위젯이 포함된 경우 + Add variable 버튼을 클릭합니다.
변수 추가 워크플로를 완료합니다. 다음은 각 필드에 대한 몇 가지 규칙과 팁입니다.
들
세부
쿼리에 사용할 이름
변수의 이름입니다. 이것이 {{...}}
로 둘러싸인 쿼리에서 사용할 것입니다. 예를 들어 여기서 country
을 이름으로 사용하면 쿼리를 작성할 때 {{country}}
로 변수를 호출하게 됩니다.
변수 이름은 문자로 시작해야 하며 문자, 숫자 및 밑줄을 포함할 수 있습니다.
이름 표시하기
선택 과목. 대시보드 사용자가 변수가 무엇을 나타내는지 알 수 있도록 변수가 대시보드 위에 표시되는 방식입니다. 비워두면 기본 이름 값을 사용합니다.
유형
세 가지 옵션이 있습니다.
쿼리 : 드롭다운 메뉴에서 사용되는 동적 옵션 목록을 반환하는 쿼리를 작성할 수 있습니다. 예를 들어 다음 쿼리는 country
값의 동적 목록을 반환합니다.
SELECT uniques ( countryCode ) FROM PageAction since 2 days ago
쿼리 작성에 대한 규칙 및 팁은 쿼리 유형 변수 를 참조하십시오.
목록 : 드롭다운 메뉴의 옵션을 채우는 데 사용되는 쉼표로 구분된 값 목록입니다. 예를 들어 다음과 같은 목록을 사용하여 country
값 목록을 수동으로 정의할 수 있습니다. ES, US, CA.
텍스트 필드 : 선택할 값의 드롭다운 대신 대시보드 사용자가 입력한 텍스트를 필터링할 수 있습니다.
계정
query
유형에만 존재합니다. 계정이 여러 개인 조직의 경우 쿼리되는 계정을 설정합니다.
질문
uniques (attribute)
사용하여 여기에 쿼리를 작성하십시오.
다중 선택
선택 과목. 이 옵션을 사용하면 드롭다운에서 단일 선택 대신 동시에 여러 선택을 허용할 수 있습니다.
기본값
선택 과목. 대시보드가 필터링할 기본값입니다. 예를 들어 위의 country
쿼리를 사용한 경우 ES
기본값으로 입력하면 대시보드가 자동으로 해당 값으로 필터링됩니다. 모든 가능성을 선택할 수도 있습니다.
WHERE
절에서 여러 값을 사용하려면 =
대신 IN
사용해야 합니다.
출력 형식
이를 통해 변수에 의해 생성된 데이터가 쿼리에서 처리되는 방식을 변경할 수 있습니다. 여기서 선택하는 옵션은 나중에 위젯에 추가할 쿼리와 관련됩니다. 대부분의 쿼리에서 사용되는 보다 일반적인 옵션이기 때문에 기본 옵션은 문자열입니다. 기본 옵션을 다음 중 하나로 변경할 수 있습니다.
String : 변수가 문자열을 생성할 때 사용합니다.숫자 : 숫자 값을 산출할 때 사용합니다.식별자 : 이벤트 이름이나 패싯 이름과 같은 쿼리의 일부를 대체하려는 경우에 사용합니다.
country
값에 대한 템플릿 변수의 모양에 대한 다음 예를 참조하세요.
템플릿 변수를 정의하고 나면 생성된 템플릿 변수를 사용하는 위젯을 추가할 수 있습니다.
2단계. 템플릿 변수를 사용하는 위젯 만들기 템플릿 변수를 구성한 후에는 쿼리에서 정의한 변수를 사용하는 대시보드에 위젯이 필요합니다.
위젯을 만들려면:
대시보드에서 오른쪽 상단 모서리에 있는 + Add widget 버튼을 클릭합니다.
2가지 옵션이 있습니다.
차트를 추가합니다. 쿼리 작성기를 사용하여 위젯을 만듭니다. 텍스트, 이미지 또는 링크를 추가합니다. Markdown 편집기 를 사용하여 자신의 콘텐츠를 추가하는 위젯을 만듭니다. Add a chart 옵션을 선택합니다.
쿼리를 추가하고 Run 클릭합니다.
1단계에서 언급한 예를 따르면 다음과 같습니다.
SELECT countryCode FROM PageAction WHERE countryCode IN ( {{countryCode}} )
Save 클릭합니다.
템플릿 변수 정의 및 해당 변수를 참조하는 위젯 추가를 완료하면 템플릿 변수 막대에서 다른 옵션을 선택하고 선택한 항목에 따라 위젯이 변경되는지 확인하여 예상대로 작동하는지 확인할 수 있습니다.
다음은 오른쪽에 있는 결과 위젯의 예이며 왼쪽에 country
드롭다운이 있습니다.
쿼리 유형 템플릿 변수 작성 규칙 템플릿 변수 정의 섹션 에서 설명한 대로 쿼리, 목록 및 텍스트 필드의 세 가지 변수 유형이 있습니다. 쿼리 유형 변수는 대시보드 상단에 있는 템플릿 변수 막대의 드롭다운을 채우는 데 사용되는 값을 반환하는 작업 쿼리를 만들어야 하기 때문에 만들기가 가장 복잡합니다.
중요 이것은 템플릿 변수를 사용하는 쿼리 작성과는 다른 주제입니다.
다음은 쿼리 유형 변수 생성에 대한 몇 가지 규칙 및 지침입니다.
쿼리는 uniques
또는 keyset
구문을 사용해야 합니다. 고유 항목은 최대 10,000개의 결과를 반환합니다. uniques
및 keyset
을(를) 확인하십시오. 다음은 몇 가지 쿼리 예입니다.
From PageAction select uniques ( countryCode )
From PageView select keyset ( ) SINCE 1 day ago
uniques
및 keyset
구성요소가 값 목록을 반환하는 한 거의 모든 NRQL 쿼리를 사용할 수 있습니다.
중첩 변수는 지원되지 않습니다. 변수 내에 변수가 있을 수 없습니다.
몇 가지 예 다음은 몇 가지 다른 유형의 템플릿 변수 구현입니다.
다중 값 옵션 사용 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}} )
아직 하지 않았다면 아래에서 무료 New Relic 계정을 만들어 오늘 데이터 모니터링을 시작하십시오.