다음을 통해 공유

통합 문서 드롭다운 매개 변수

  • 아티클

드롭다운 매개 변수를 사용하여 알려진 집합에서 하나 이상의 입력 값을 수집할 수 있습니다. 예를 들어 드롭다운 매개 변수를 사용하여 앱의 요청 중 하나를 선택할 수 있습니다. 드롭다운 매개 변수는 또한 사용자로부터 임의의 입력을 수집하는 사용자 친화적인 방법을 제공합니다. 드롭다운 매개 변수는 대화형 보고서에서 필터링을 사용하도록 설정하는 데 특히 유용합니다.

드롭다운 매개 변수를 지정하는 가장 쉬운 방법은 매개 변수 설정에 정적 목록을 제공하는 것입니다. 더 흥미로운 방법은 KQL 쿼리를 통해 목록을 동적으로 가져오는 것입니다. 매개 변수 설정을 사용하여 단일 선택인지 다중 선택인지 지정할 수도 있습니다. 다중 선택인 경우 결과 집합의 형식을 지정하는 방법(예: 구분 기호 또는 인용 부호)을 지정할 수 있습니다.

정적 드롭다운 매개 변수 만들기

  1. 편집 모드에서 빈 통합 문서로 시작합니다.

  2. 매개 변수 추가>매개 변수 추가를 선택합니다.

  3. 열리는 새 매개 변수 창에서 다음을 입력합니다.

    1. 매개 변수 이름: Environment
    2. 매개 변수 형식: Drop down
    3. 필수: checked
    4. 복수 선택 허용: unchecked
    5. 데이터 출처: JSON

  4. JSON 입력 텍스트 블록에서 다음 JSON 코드 조각을 삽입합니다.

    [
    { "value":"dev", "label":"Development" },
    { "value":"ppe", "label":"Pre-production" },
    { "value":"prod", "label":"Production", "selected":true }
]

  5. 업데이트를 선택합니다.

  6. 저장을 선택하여 매개 변수를 만듭니다.

  7. 환경 매개 변수는 세 가지 값이 있는 드롭다운 목록입니다.

    Screenshot that shows the creation of a static dropdown parameter.

항목 그룹이 있는 정적 드롭다운 목록 만들기

쿼리 결과/JSON에 group 필드가 포함된 경우 드롭다운 목록에 값 그룹이 표시됩니다. 앞의 샘플을 따르되 대신 다음 JSON을 사용합니다.

[
    { "value":"dev", "label":"Development", "group":"Development" },
    { "value":"dev-cloud", "label":"Development (Cloud)", "group":"Development" },
    { "value":"ppe", "label":"Pre-production", "group":"Test" },
    { "value":"ppe-test", "label":"Pre-production (Test)", "group":"Test" },
    { "value":"prod1", "label":"Prod 1", "selected":true, "group":"Production" },
    { "value":"prod2", "label":"Prod 2", "group":"Production" }
]

Screenshot that shows an example of a grouped dropdown list.

동적 드롭다운 매개 변수 만들기

  1. 편집 모드에서 빈 통합 문서로 시작합니다.

  2. 매개 변수 추가>매개 변수 추가를 선택합니다.

  3. 열리는 새 매개 변수 창에서 다음을 입력합니다.

    1. 매개 변수 이름: RequestName
    2. 매개 변수 형식: Drop down
    3. 필수: checked
    4. 복수 선택 허용: unchecked
    5. 데이터 출처: Query

  4. JSON 입력 텍스트 블록에서 다음 JSON 코드 조각을 삽입합니다.

        requests
    | summarize by name
    | order by name asc

  5. 쿼리 실행을 선택합니다.

  6. 저장을 선택하여 매개 변수를 만듭니다.

  7. RequestName 매개 변수는 앱의 모든 요청 이름이 있는 드롭다운 목록입니다.

    Screenshot that shows the creation of a dynamic dropdown parameter.

드롭다운 매개 변수 참조

드롭다운 매개 변수를 참조할 수 있습니다.

KQL의 경우

  1. 쿼리 추가를 선택하여 쿼리 제어를 추가한 다음 Application Insights 리소스를 선택합니다.

  2. KQL 편집기에서 다음 코드 조각을 입력합니다.

        requests
    | where name == '{RequestName}'
    | summarize Requests = count() by bin(timestamp, 1h)

  3. 코드 조각은 쿼리 평가 시간에 따라 다음과 같이 확장됩니다.

        requests
    | where name == 'GET Home/Index'
    | summarize Requests = count() by bin(timestamp, 1h)

  4. 쿼리를 실행하여 결과를 확인합니다. 필요에 따라 차트를 렌더링합니다.

    Screenshot that shows a dropdown parameter referenced in KQL.

매개 변수 값, 레이블, 선택 및 그룹

앞의 동적 드롭다운 매개 변수에 사용된 쿼리는 드롭다운 목록에 충실하게 렌더링된 값 목록을 반환합니다. 그러나 다른 표시 이름이나 이름 중 하나를 선택하려면 어떻게 해야 하나요? 드롭다운 매개 변수는 이 기능에 대해 값, 레이블, 선택 및 그룹 열을 사용합니다.

다음 샘플은 표시 이름이 이모지 스타일로 지정되어 있고, 첫 번째 항목이 선택되어 있으며, 작업 이름별로 그룹화된 Application Insights 종속성 목록을 가져오는 방법을 보여 줍니다.

dependencies
| summarize by operation_Name, name
| where name !contains ('.')
| order by name asc
| serialize Rank = row_number()
| project value = name, label = strcat('🌐 ', name), selected = iff(Rank == 1, true, false), group = operation_Name

Screenshot that shows a dropdown parameter using value, label, selection, and group options.

매개 변수 설명 예시
{DependencyName} 선택한 값 GET fabrikamaccount
{DependencyName:label} 선택한 레이블 🌐 GET fabrikamaccount
{DependencyName:value} 선택한 값 GET fabrikamaccount

다중 선택

지금까지의 예에서는 드롭다운 목록에서 하나의 값만 선택하도록 매개 변수를 명시적으로 설정했습니다. 드롭다운 매개 변수는 다중 선택도 지원합니다. 이 옵션을 사용하려면 다중 선택 허용 확인란을 선택합니다.

구분 기호 및 따옴표 포함 설정을 통해 결과 집합의 형식을 지정할 수 있습니다. 기본값은 a, b, c 형식의 컬렉션으로 값을 반환합니다. 선택 항목 수를 제한할 수도 있습니다.

결과 형식을 사용할 수 있도록 매개 변수를 참조하는 KQL을 변경해야 합니다. 가장 일반적인 방법은 in 연산자를 통해 설정하는 것입니다.

dependencies
| where name in ({DependencyName})
| summarize Requests = count() by bin(timestamp, 1h), name

이 예는 직장에서 다중 선택 드롭다운 매개 변수를 보여 줍니다.

Screenshot that shows a multi-select dropdown parameter.

드롭다운 매개 변수를 사용하면 드롭다운에도 나타나는 특수 값을 지정할 수 있습니다.

  • 임의 1개
  • 임의 3개
  • ...
  • 임의 100개
  • 임의 사용자 지정 제한
  • 모두

이러한 특수 항목을 선택하면 매개 변수 값이 특정 항목 수 또는 모든 값으로 자동으로 설정됩니다.

특수 사례 모두

모두 옵션을 선택하면 추가 필드가 나타납니다. 이 필드를 사용하면 모두 옵션을 선택한 경우 매개 변수에 특수 값이 사용되도록 지정할 수 있습니다. 이 특수 값은 "모두"가 많은 수의 항목이 될 수 있고 매우 큰 쿼리를 생성할 수 있는 경우에 유용합니다.

Screenshot of the New Parameter window in the Azure portal. The All option is selected and the All option and Select All value field are highlighted.

이 특정 경우에 문자열 []은 값 대신 사용됩니다. 이 문자열은 다음과 같이 로그 쿼리에서 빈 배열을 생성하는 데 사용할 수 있습니다.

let selection = dynamic([{Selection}]);
SomeQuery 
| where array_length(selection) == 0 or SomeField in (selection)

모든 항목을 선택한 경우 값 Selection은 []이며 쿼리에서 selection 변수에 대한 빈 배열을 생성합니다. 값을 선택하지 않은 경우 Selection 값은 빈 문자열이 되며, 그 결과 빈 배열도 생성됩니다. 값이 선택되면 쿼리의 동적 부분 내에 서식이 지정되어 배열에 해당 값이 지정됩니다. 그런 다음, array_length 0을 테스트하여 필터가 적용되지 않도록 하거나 in 연산자를 사용하여 배열의 값을 필터링할 수 있습니다.

다른 일반적인 예제에서는 매개 변수가 필요할 때 특수 표식 값으로 '*'를 사용하고 다음을 사용하여 테스트합니다.

| where "*" in ({Selection}) or SomeField in ({Selection})

다음 단계

Azure 통합 문서를 사용하여 풍부한 시각적 보고서를 만드는 데 사용할 수 있는 시각화 유형에 대해 알아봅니다.