연습: 대시보드 매개 변수 만들기

완료됨

이 단원에서는 대시보드 시각화를 필터링하는 매개 변수를 만듭니다.

매개 변수 만들기

먼저 보기 모드에서 편집 모드로 전환해야 합니다.

  1. 보기를 선택하고 모드를 편집으로 전환합니다.

    Screenshot of switching to editing mode.

  2. 상단 메뉴 모음에서 [@] 매개 변수를 선택합니다. 매개 변수 창이 열립니다.

  3. + 새 매개 변수 선택

  4. 다음과 같이 매개 변수 추가 창에서 매개 변수 옵션을 입력합니다.

    Screenshot of parameter options.

    필드 설명 제안 값
    레이블 대시보드 또는 편집 카드에 표시되는 매개 변수의 이름입니다. 시스템 상태
    매개 변수 형식 단일 선택: 필터에서 매개 변수에 대한 입력으로 하나의 값만 선택할 수 있습니다.
    다중 선택: 필터에서 매개 변수에 대한 입력으로 하나 이상의 값을 선택할 수 있습니다.
    시간 범위: 시간을 기준으로 쿼리 및 대시보드를 필터링합니다.
    무료 문자: 사용자가 값을 입력하거나 값을 텍스트 필드에 복사/붙여넣을 수 있습니다.
    다중 선택
    변수 이름 쿼리에서 사용할 매개 변수의 이름입니다. _state
    데이터 형식 매개 변수 값의 데이터 형식입니다. 문자열
    페이지에 표시 이 매개 변수가 표시되는 페이지를 선택합니다. 모두 선택
    원본 고정 값: 수동으로 도입된 정적 필터 값입니다.
    쿼리: KQL 쿼리를 사용하여 동적으로 도입된 값입니다.
    쿼리
    데이터 원본 쿼리 기반 매개 변수의 원본입니다. 쿼리 편집을 참조하세요.

매개 변수 원본 쿼리 편집

이 매개 변수에 대해 가능한 값 목록을 만들어야 합니다. 만드는 매개 변수를 State라고 합니다. 이 값을 사용하여 이벤트가 발생한 상태에 따라 결과를 필터링하려고 합니다. 가능한 모든 상태 목록을 수동으로 입력할 수 있지만 이 목록을 동적으로 반환하는 쿼리를 사용하는 것이 더 간단합니다.

  1. 데이터 원본에서 샘플 데이터베이스를 선택합니다.

  2. 쿼리 결과 필드에서 쿼리 편집을 선택합니다.

  3. 편집기에 다음 쿼리를 복사/붙여넣습니다.

    StormEvents
    | distinct (State)
    
  4. 실행을 선택합니다. 이 쿼리는 상태 열에 있는 모든 다른 값의 목록을 반환합니다.

    Screenshot of editing query for parameter.

  5. 추가를 선택하여 매개 변수 추가 대화 상자로 돌아갑니다.

  6. 기본값 드롭다운을 선택하고 상태 중 하나(예: 미네소타)를 선택합니다.

    Screenshot of source to add query.

  7. 완료를 선택합니다.

매개 변수를 포함하도록 두 타일 쿼리를 모두 편집합니다.

매개 변수를 만들었지만 대시보드는 동일하게 보입니다. 시각적 개체를 생성하는 쿼리에서 매개 변수를 사용해야 합니다.

날짜별 이벤트

  1. 날짜별 타일에서 연필 아이콘을 선택합니다.

    Screenshot of editing the query in the tile.

  2. 매개 변수 옵션에 정의된 변수 이름을 쿼리의 필터로 사용합니다. 이 경우 변수 이름은 상태입니다. 다음 줄을 포함하도록 쿼리를 편집합니다.

    | where State has_any (_state)
    

    쿼리는 다음 이미지와 같이 표시됩니다.

    Screenshot of editing the query to add parameter.

  3. 변경 내용 적용을 선택합니다.

상태별 이벤트 수

  1. 상태별 이벤트 수 타일에서 연필 아이콘을 선택합니다.

  2. 다음 줄을 포함하도록 쿼리를 편집합니다.

    | where State has_any (_state)
    

    쿼리는 다음 이미지와 같이 표시됩니다.

    Screenshot of query in dashboard visual including parameter.

  3. 변경 내용 적용을 선택합니다.

매개 변수 사용

상태 매개 변수를 선택한 다음, 드롭다운 메뉴에서 옵션 중 하나(예: TEXAS)를 선택합니다. 하나의 상태만 선택되도록 기본값을 확인하고 검사. 선택한 상태와 연결된 데이터만 표시하도록 시각화가 어떻게 변경되는지 확인합니다.

Animated gif showing how to use the parameter picker.