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

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

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

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

대시보드 사용을 더 쉽게 만들어줍니다. 사용자는 데이터 구조를 이해할 필요가 없으며, 여러분이 설정한 다양한 필터 옵션 중에서 선택하기만 하면 됩니다.
이를 통해 여러 용도로 복제하고 사용자 정의할 수 있는 재사용 가능한 대시보드 템플릿을 만들 수 있습니다.

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

이동 one.newrelic.com > All capabilities > Dashboards

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

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

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

변수 포함 및 제외

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()". 이는 비활성화 변수 기능이 아직 이러한 특정한 경우에 구현되지 않았기 때문입니다.

요구 사항 및 제한 사항

템플릿 변수는 맞춤형 대시보드를 만드는 맥락에서만 사용될 수 있습니다. 이러한 이유로 일부 쿼리 관련 기능이 작동하지 않습니다. 예를 들어, Export dashboard as PDF 옵션은 변수가 있는 위젯을 지원하지 않으며, Lens SQL 쿼리는 템플릿 변수를 지원하지 않습니다. NRQL 쿼리에서 변수를 사용하는 방법에 대해서는 NRQL 변수 부분을 참조하십시오.

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

정의한 변수는 {{ … }} 괄호 안에 들어갑니다.
변수는 문자열 값을 생성합니다.
검색어를 만들 때 도움이 되도록 색상 코드가 있습니다.
- 절 FROM, SELECT, FACET및 WHERE은 분홍색입니다.
- 식별자는 검은색입니다.
- 기능은 파란색입니다.
- 문자열은 녹색입니다.
- 정수는 갈색입니다.
NRQL을 사용하여 쿼리를 작성하는 방법에 대해 자세히 알고 싶다면 NRQL 사용 방법: 쿼리 메커니즘 페이지를 참조하세요.

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

템플릿 변수 사용

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

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

템플릿 변수 정의

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

변수를 정의하려면:

변수가 없는 새 대시보드에서 편집을 클릭하세요. 버튼을 클릭한 다음, 좌측 상단에 있는 + Add variable 버튼을 클릭합니다. 변수 추가가 완료되면 Done editing 클릭하세요.
대시보드에 위젯이 포함된 경우 + Add variable 버튼을 클릭합니다.

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)`사용하여 여기에 쿼리를 작성하십시오.
타임피커 무시	선택 과목. 쿼리 유형에만 존재합니다. 이 옵션을 끄면 대시보드에서 선택한 타임 피커의 값을 사용하여 쿼리가 실행됩니다. 이렇게 하면 타임 피커의 값이 변경될 때 변수의 드롭다운 메뉴 결과가 새로 선택한 시간 범위에 동적으로 반응하게 됩니다.
다중 선택	선택 과목. 이 옵션을 사용하면 드롭다운에서 단일 선택 대신 동시에 여러 선택을 허용할 수 있습니다.
적용 버튼 표시	선택 과목. multi-value 활성화한 경우에만 나타납니다. 이 토글을 활성화하면 변수의 드롭다운 메뉴 필터 하단에 Apply 또는 Cancel 버튼이 표시됩니다. 이 버튼이 드롭다운 메뉴 필터에 나타나는 동안 클릭하면 값에 변경 사항이 적용됩니다.
기본값	선택 과목. 이는 대시보드가 필터링할 기본값입니다. 예를 들어 위의 `country` 쿼리를 사용한 경우 기본값으로 `ES` 입력하면 대시보드가 자동으로 해당 값으로 필터링합니다. 모든 가능성을 선택할 수도 있습니다. `WHERE` 절에서 여러 값을 사용하려면 `=` 대신 `IN` 사용해야 합니다. Include variable [변수 포함] 토글은 대시보드에서 해당 변수에 대한 기본 설정(포함 또는 제외)을 결정합니다. 이 설정은 대시보드를 보는 사용자가 변수 드롭다운 메뉴 메뉴의 Include variable [변수 포함] 토글을 사용하여 수정할 수 있습니다. 선택한 사용자 설정은 세션 기간 동안 유효합니다. 중요 토글이 변수를 포함하도록 설정된 경우에만 기본값을 구성할 수 있습니다. 기본값을 선택하면 토글을 전환하여 변수가 기본적으로 포함되지 않도록 할 수 있습니다. 사용자가 변수 드롭다운 메뉴에서 변수를 포함하도록 토글을 돌리면 기본값이 미리 선택됩니다.
출력 형식	이를 통해 변수에 의해 생성된 데이터가 쿼리에서 처리되는 방식을 변경할 수 있습니다. 여기에서 선택한 옵션은 나중에 위젯에 추가할 쿼리와 관련이 있습니다. default 옵션은 대부분의 쿼리에 사용되는 더 일반적인 옵션이므로 문자열입니다. default 옵션을 다음 중 하나로 변경할 수 있습니다. String: 숫자가 아닌 텍스트 값에 사용합니다. Number: 숫자 값에 사용합니다. Identifier: 이벤트 이름이나 패싯 이름과 같은 쿼리의 일부를 대체하려는 경우에 사용합니다.

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

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

템플릿 변수를 사용하는 위젯을 만듭니다.

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

위젯을 만들려면:

대시보드에서 오른쪽 상단에 있는 + Add widget 버튼을 클릭하세요.
2가지 옵션이 있습니다.
- 차트를 추가합니다. 쿼리 작성기를사용하여 위젯을 만듭니다.
- 텍스트, 이미지 또는 링크를 추가합니다. Markdown 편집기를 사용하여 자신의 콘텐츠를 추가하는 위젯을 만듭니다.
Add a chart 옵션을 선택합니다.
쿼리를 추가하고 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....
딸깍 하는 소리 Add to dashboard

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

오른쪽은 결과 위젯의 예이고, 왼쪽에는 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

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

몇 가지 예

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

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

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

다중값을 활성화하려면:

쿼리 또는 목록 템플릿 변수를 생성할 때 Multi-value 옵션을 선택합니다.
위젯 쿼리에서 = 대신 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" /> /

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

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

countryCode 변수: 이 문서의 앞부분에서 표시된 쿼리를 사용합니다.
```
SELECT uniques(countryCode) FROM PageAction SINCE 2 days ago
```
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"
}

추가하신 제목들이 변수의 드롭다운 메뉴에 표시됩니다. 이는 변수나 위젯의 로직에 전혀 영향을 미치지 않습니다.

Screenshot showing the list based variable dropdown

위젯 제목에 템플릿 변수를 사용하면 변수 값이 변경될 때 자동으로 업데이트되는 동적 제목을 만들 수 있습니다. 이는 표시되는 데이터에 대한 맥락을 제공하는 데 유용합니다.

답변을 편집할 때 UI 통하거나 대시보드 JSON을 사용하여 답변 제목에 변수를 추가할 수 있습니다.

예를 들어, "알림", "APM", "대시보드", "카탈로그"와 같은 값을 가진 {{products}} 이라는 변수가 있다면, Page views per nerdlet: {{products}} 과 같이 동적 제목을 가진 위젯을 만들 수 있습니다.

Screenshot showing the widget edit options

변수 드롭다운 메뉴에서 "알림"을 선택하면 제목이 자동으로 업데이트되어 선택한 값을 표시합니다. "알림", "APM", "대시보드"를 모두 선택하면 제목이 선택된 모든 값을 표시하도록 업데이트됩니다.

이 기능은 모든 템플릿 변수 유형(쿼리, 목록 또는 텍스트 필드)에서 작동하며 사용자가 변수 필터를 확인하지 않고도 보고 있는 데이터가 무엇인지 이해하는 데 도움이 됩니다.

마크다운 위젯에서 템플릿 변수를 사용하면 변수 선택에 따라 업데이트되는 동적 텍스트 콘텐츠, 문서 또는 다이어그램을 만들 수 있습니다. 이 기능은 특히 맥락에 맞는 메모나 머메이드 다이어그램과 같은 시각화 자료를 만드는 데 매우 유용합니다.

예를 들어, "알림", "APM", "대시보드", "카탈로그"와 같은 값을 가진 변수 {{products}} 이 있다면, 마크다운 콘텐츠에서 다양한 방식으로 이를 사용할 수 있습니다.

예시 1: 동적 텍스트 콘텐츠

변수({{products}})를 마크다운 텍스트에 직접 포함시키면 선택 항목에 따라 업데이트되는 동적 문서를 만들 수 있습니다.

Screenshot showing the markdown text and its preview

예시 2: 동적 머메이드 다이어그램

Mermaid 다이어그램의 마크다운 텍스트 내에서 변수({{products}})를 사용하여 동적으로 업데이트되는 순서도를 만들 수도 있습니다.

Screenshot showing the markdown text and its mermaid diagram preview

이 예시에서 다이어그램은 {{products}} 변수가 어떤 데이터를 유지하고 어떤 데이터를 버릴지 결정하는 의사 결정 흐름을 보여줍니다. 변수 선택을 변경하면 다이어그램이 업데이트되어 선택된 제품을 반영합니다.

메모

마크다운 위젯을 편집할 때 미리보기 모드에는 변수 이름(예: {{products}})이 표시되고 실제 값은 표시되지 않습니다. 하지만 대시보드를 저장하고 보면 변수들은 실제 값으로 대체됩니다.

사용자의 편의를 위해 제공되는 기계 번역입니다.

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

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

변수 포함 및 제외

예시

요구 사항 및 제한 사항

템플릿 변수 사용

템플릿 변수 정의

중요

템플릿 변수를 사용하는 위젯을 만듭니다.

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

중요

몇 가지 예

다중 값 옵션 사용

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

변수 및 부분 일치 사용

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

NRQL 쿼리와 함께 변수 `facet` 사용

동적 그룹화에 변수 사용

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

변수를 사용하여 필터링

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

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

목록 변수에 제목이나 레이블을 사용하세요

위젯 제목에 변수를 사용하세요

마크다운 위젯에서 변수 사용하기

메모

사용자의 편의를 위해 제공되는 기계 번역입니다.

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

템플릿 변수를 사용하는 이유는 무엇입니까? .css-21sua1{background:none;border:none;width:0;padding:0;}

변수 포함 및 제외

예시

요구 사항 및 제한 사항

템플릿 변수 사용

템플릿 변수 정의

중요

템플릿 변수를 사용하는 위젯을 만듭니다.

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

중요

몇 가지 예

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

변수 및 부분 일치 사용

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

NRQL 쿼리와 함께 변수 facet 사용

동적 그룹화에 변수 사용

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

변수를 사용하여 필터링

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

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

목록 변수에 제목이나 레이블을 사용하세요

위젯 제목에 변수를 사용하세요

마크다운 위젯에서 변수 사용하기

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

NRQL 쿼리와 함께 변수 `facet` 사용

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