링크 작업
링크 작업은 통합 문서 링크 구성 요소나 그리드, 제목 또는 그래프의 열 설정을 통해 액세스할 수 있습니다.
일반 링크 작업
동작 연결 | 선택 시 작업 |
---|---|
일반 세부 정보 | 속성 그리드 컨텍스트 보기에서 행 값을 표시합니다. |
셀 세부 정보 | 속성 그리드 컨텍스트 보기의 셀 값을 표시합니다. 정보를 포함하는 동적 형식(예: 위치 및 역할 인스턴스 등의 요청 속성이 있는 JSON)이 셀에 포함된 경우에 유용합니다. |
URL | 셀 값은 유효한 HTTP URL이어야 합니다. 셀은 새 탭에서 해당 URL을 여는 링크입니다. |
Application Insights
동작 연결 | 선택 시 작업 |
---|---|
사용자 지정 이벤트 상세 정보 | 셀에서 사용자 지정 이벤트 ID("itemId")를 사용하여 Application Insights 검색 세부 정보를 엽니다. |
세부 정보 | 종속성, 예외, 페이지 보기, 요청, 추적을 제외하고 사용자 지정 이벤트 세부 정보와 유사합니다. |
사용자 지정 이벤트 사용자 흐름 | 셀의 사용자 지정 이벤트 이름에서 피벗된 Application Insights 사용자 흐름 환경을 엽니다. |
사용자 흐름 | 예외, 페이지 보기, 요청을 제외하고 사용자 지정 이벤트 사용자 흐름과 비슷합니다. |
사용자 타임라인 | 셀에서 사용자 ID("user_Id")를 사용하여 사용자 타임라인을 엽니다. |
세션 타임라인 | 셀 값에 대한 Application Insights 검색 환경을 엽니다. 예를 들어 abc가 셀의 값이라면 텍스트 abc를 검색합니다. |
Azure 리소스
동작 연결 | 선택 시 작업 |
---|---|
ARM 배포 | ARM(Azure Resource Manager) 템플릿을 배포합니다. 이 항목을 선택하면 열려는 ARM 템플릿과 템플릿에 대한 매개 변수를 구성할 수 있는 더 많은 필드가 표시됩니다. Azure Resource Manager 배포 링크 설정을 참조하세요. |
경고 규칙 만들기 | 리소스에 대한 경고 규칙을 만듭니다. |
사용자 지정 보기 | 사용자 지정 보기를 엽니다. 이 항목을 선택하면 보기 확장, 보기 이름 및 보기를 여는 데 사용되는 매개 변수를 구성할 수 있는 더 많은 필드가 나타납니다. 사용자 지정 보기 링크 설정을 참조하세요. |
메트릭 | 메트릭 보기를 엽니다. |
리소스 개요 | 셀의 리소스 ID 값을 기반으로 포털에서 리소스의 보기를 엽니다. 리소스 보기에서 특정 메뉴 항목을 여는 하위 메뉴 값을 선택적으로 설정할 수도 있습니다. |
통합 문서(템플릿) | 통합 문서 템플릿을 엽니다. 이 항목을 선택하면 열려는 템플릿을 구성할 수 있는 더 많은 필드가 표시됩니다. |
링크 설정
링크 렌더러를 사용하는 경우 다음 설정을 사용할 수 있습니다.
설정 | 설명 |
---|---|
열 보기 | 작업 중 하나를 선택할 수 있습니다. |
메뉴 항목 | 리소스 개요를 선택한 경우 이 메뉴 항목은 리소스 개요에 있습니다. 이 항목을 사용하여 리소스에 대한 “개요” 대신 경고 또는 활동 로그를 열 수 있습니다. 각 Azure 리소스 종류에 대한 메뉴 항목 값은 서로 다릅니다. |
링크 레이블 | 지정된 경우 이 값은 그리드 열에 나타납니다. 이 값을 지정하지 않으면 셀의 값이 나타납니다. 히트맵이나 아이콘과 같은 다른 값을 나타내려면 링크 렌더러를 사용하지 마세요. 대신 적절한 렌더러를 사용하고 이 항목을 링크로 만들기 옵션을 선택합니다. |
컨텍스트 창에서 링크 열기 | 지정된 경우 링크가 전체 뷰로 열리는 대신 창의 오른쪽에 팝업 항목 “컨텍스트” 보기로 열립니다. |
이 항목을 링크로 만들기 옵션을 사용하는 경우 다음 설정을 사용할 수 있습니다.
설정 | 설명 |
---|---|
연결 값 원본 | 셀이 링크가 있는 렌더러로 표시될 때 이 필드는 링크에서 사용할 "링크" 값을 가져오는 위치를 지정합니다. 그리드에 있는 다른 열의 드롭다운에서 선택할 수 있습니다. 예를 들어 셀은 히트맵 값일 수 있습니다. 하지만 링크가 행의 리소스 ID에 대한 리소스 개요를 열도록 할 수도 있습니다. 이 경우 리소스 ID 필드에서 가져오는 링크 값을 설정합니다. |
열 보기 | 위와 동일합니다. |
메뉴 항목 | 위와 동일합니다. |
컨텍스트 창에서 링크 열기 | 위와 동일합니다. |
ARM 작업 설정
ARM API 세부 정보를 지정하여 ARM 작업을 호출하려면 이 설정을 사용합니다. ARM REST API에 대한 설명서는 여기에서 찾을 수 있습니다. 모든 UX 필드에서 {paramName}
을 사용하여 매개 변수를 확인할 수 있습니다. ["columnName"]
을 사용하여 열을 확인할 수도 있습니다. 아래 이미지 예에서는 ["id"]
를 작성하여 id
열을 참조할 수 있습니다. 열이 Azure 리소스 ID인 경우 포맷터 label
을 사용하여 리소스의 식별 이름을 가져올 수 있습니다. 이는 매개 변수 서식과 유사합니다.
ARM 작업 설정 탭
이 섹션에서는 ARM 작업 API를 정의합니다.
Source | 설명 |
---|---|
ARM 작업 경로 | ARM 작업 경로입니다. 예: "/subscriptions/:subscription/resourceGroups/:resourceGroup/someAction?api-version=:apiversion". |
Http 메서드 | HTTP 메서드를 선택합니다. 사용 가능한 선택 사항은 다음과 같습니다. POST , PUT , PATCH , DELETE |
긴 작업 | 긴 작업은 원래 작업의 Azure-AsyncOperation 또는 Location 응답 헤더에서 URI를 폴링합니다. 비동기 Azure 작업 추적에 대해 자세히 알아봅니다. |
매개 변수 | 키와 값이 포함된 URL 매개 변수 그리드입니다. |
헤더 | 키와 값이 포함된 헤더 그리드입니다. |
본문 | JSON의 요청 페이로드에 대한 편집기입니다. |
ARM 작업 UX 설정
이 섹션에서는 ARM 작업을 실행하기 전에 사용자에게 표시되는 내용을 구성합니다.
Source | 설명 |
---|---|
타이틀 | 보기 실행에 사용되는 제목입니다. |
ARM 작업 이름 사용자 지정 | 작성자는 작업이 트리거된 후 알림에 표시되는 ARM 작업을 사용자 지정할 수 있습니다. |
ARM 작업 설명 | ARM 작업을 실행하려는 사용자에게 유용한 설명을 제공하는 데 사용되는 가격 인하 텍스트입니다. |
실행 단추 텍스트 원본 | ARM 작업을 트리거하기 위해 실행 단추에 사용되는 레이블입니다. |
이러한 구성이 설정된 후 사용자가 링크를 선택하면 여기에 설명된 UX가 포함된 보기가 열립니다. 사용자가 단추 텍스트 실행에서 지정한 단추를 선택하면 구성된 값을 사용하여 ARM 작업이 실행됩니다. 컨텍스트 창 하단에서 요청 세부 정보 보기를 선택하여 ARM 작업에 사용되는 HTTP 메서드와 ARM API 엔드포인트를 검사할 수 있습니다.
ARM 작업의 진행률과 결과는 Azure Portal 알림으로 표시됩니다.
Azure Resource Manager 배포 링크 설정
연결 종류가 ARM 배포인 경우 Resource Manager 배포를 열려면 추가 설정을 지정해야 합니다. 구성에는 템플릿 설정 및 UX 설정이라는 두 가지 기본 탭이 있습니다.
템플릿 설정
이 섹션에서는 템플릿을 가져오는 위치 및 Resource Manager 배포를 실행하는 데 사용되는 매개 변수를 정의합니다.
원본 | 설명 |
---|---|
리소스 그룹 ID 원본 | 리소스 ID는 배포된 리소스를 관리하는 데 사용됩니다. 구독은 배포된 리소스와 비용을 관리하는 데 사용됩니다. 리소스 그룹은 폴더처럼 모든 리소스를 구성하고 관리하는 데 사용됩니다. 이 값을 지정하지 않으면 배포가 되지 않습니다. 링크 원본의 셀, 열, 매개 변수 및 고정 값 중에서 선택합니다. |
ARM 템플릿 URI 원본 | ARM 템플릿 자체에 대한 URI입니다. 템플릿을 배포할 사용자가 템플릿 URI에 액세스할 수 있어야 합니다. 링크 원본의 셀, 열, 매개 변수 및 고정 값 중에서 선택합니다. 자세한 내용은 Azure 빠른 시작 템플릿을 참조하세요. |
ARM 템플릿 매개 변수 | 앞서 정의된 템플릿 URI에 사용하는 템플릿 매개 변수를 정의합니다. 이러한 매개 변수는 실행 페이지에 템플릿을 배포하는 데 사용됩니다. 그리드에는 템플릿 URI에 정의된 이름을 사용하여 매개 변수를 채우고 고정된 빈 값으로 설정하는 데 사용할 수 있는 도구 모음 확장 단추가 있습니다. 이 옵션은 그리드에 매개 변수가 없고 템플릿 URI가 설정된 경우에만 사용할 수 있습니다. 아래쪽 섹션은 매개 변수 출력의 모양에 대한 미리 보기입니다. 최신 변경 내용으로 미리 보기를 업데이트하려면 새로 고침을 선택합니다. 매개 변수는 일반적으로 값입니다. 참조는 사용자가 액세스할 수 있는 키 자격 증명 모음 비밀을 가리킬 수 있는 항목입니다. 템플릿 뷰어 창 제한 사항으로 인해 참조 매개 변수가 올바르게 렌더링되지 않고 null/값으로 표시됩니다. 결과적으로 사용자는 템플릿 뷰어 탭에서 참조 매개 변수를 올바르게 배포할 수 없습니다. |
UX 설정
이 섹션에서는 Resource Manager 배포를 실행하기 전에 표시되는 내용을 구성합니다.
원본 | 설명 |
---|---|
제목 원본 | 보기 실행에 사용되는 제목입니다. 링크 원본의 셀, 열, 매개 변수 및 고정 값 중에서 선택합니다. |
설명 원본 | 사용자가 템플릿을 배포하려는 경우 사용자에게 유용한 설명을 제공하는 데 사용되는 Markdown 텍스트입니다. 링크 원본의 셀, 열, 매개 변수 및 고정 값 중에서 선택합니다. 고정 값을 선택하면 여러 줄의 텍스트 상자가 나타납니다. 이 텍스트 상자에서 "{paramName}" 을 사용하여 매개 변수를 확인할 수 있습니다. {columnName_column} 같은 열 이름 뒤에 "_column" 을 추가하여 열을 매개 변수로 취급할 수도 있습니다. 다음 예제 이미지에서는 "{VMName_column}" 를 작성하여 "VMName" 열을 참조할 수 있습니다. 콜론 뒤의 값은 매개 변수 포맷터입니다. 이 경우 값입니다. |
실행 단추 텍스트 원본 | ARM 템플릿을 배포하기 위해 실행 단추에 사용되는 레이블입니다. 사용자는 이 단추를 선택하여 ARM 템플릿 배포를 시작합니다. |
이러한 구성을 설정한 후 링크를 선택하면 UX 설정에 설명된 UX와 함께 보기가 열립니다. 다음에서 단추 텍스트 실행을 선택하면 템플릿 설정의 값을 사용하여 ARM 템플릿이 배포됩니다. 템플릿 보기는 배포하기 전에 템플릿과 매개 변수를 검사할 수 있도록 템플릿 뷰어 탭을 엽니다.
사용자 지정 보기 링크 설정
이 설정을 사용하여 Azure Portal에서 사용자 지정 보기를 엽니다. 구성 및 설정을 확인합니다. 잘못된 값은 포털에서 오류를 발생시키거나 보기를 올바르게 열지 못합니다. 설정을 구성하는 방법에는 양식 또는 URL의 두 가지가 있습니다.
참고 항목
메뉴를 포함하는 보기는 컨텍스트 탭에서 열 수 없습니다. 메뉴를 포함하는 보기가 컨텍스트 탭에서 열리도록 구성된 경우 링크를 선택하면 컨텍스트 탭이 표시되지 않습니다.
양식
원본 | 설명 |
---|---|
확장 이름 | 보기의 이름을 호스트하는 확장의 이름입니다. |
보기 이름 | 열려는 보기의 이름입니다. |
보기 입력
입력에는 그리드와 JSON이라는 두 가지 형식이 있습니다. 간단한 키 및 값 탭 입력에 그리드를 사용합니다. JSON을 선택하여 중첩된 JSON 입력을 지정합니다.
그리드
- 매개 변수 이름: 보기 입력 매개 변수의 이름입니다.
- 매개 변수 원본: 보기 매개 변수 값을 가져오는 위치입니다. 링크 원본의 셀, 열, 매개 변수 및 고정 값 중에서 선택합니다.
참고 항목
고정 값을 선택하면 대괄호를 사용하여 텍스트 상자에서
"{paramName}"
을 연결하여 매개 변수를 확인할 수 있습니다."{columnName_column}"
같은 열 이름 뒤에_column
을 추가하여 열을 매개 변수 열로 처리할 수 있습니다.- 매개 변수 값: 매개 변수 원본의 값에 따라 이 드롭다운에는 사용 가능한 매개 변수, 열 또는 고정 값이 포함됩니다.
JSON
- 편집기에서 JSON 형식으로 탭 입력을 지정합니다. 그리드 모드와 마찬가지로 매개 변수에
{paramName}
을 사용하고 열에{columnName_column}
를 사용하여 매개 변수 및 열을 참조할 수 있습니다. JSON 샘플 표시를 선택하면 보기 입력에 사용된 모든 확인된 매개 변수 및 열의 예상 출력이 표시됩니다.
- 편집기에서 JSON 형식으로 탭 입력을 지정합니다. 그리드 모드와 마찬가지로 매개 변수에
URL
확장, 보기의 이름, 보기를 여는 데 필요한 모든 입력을 포함하는 포털 URL을 붙여넣습니다. 설정 초기화를 선택하면 보기 입력을 추가, 수정 또는 제거할 수 있도록 양식이 채워집니다.
통합 문서(템플릿) 링크 설정
선택한 링크 유형이 통합 문서(템플릿)인 경우 올바른 통합 문서 템플릿을 열려면 추가 설정을 지정해야 합니다. 다음 설정에는 각 설정에 대한 적절한 값을 그리드에서 찾는 방법에 대한 옵션이 있습니다.
설정 | 설명 |
---|---|
통합 문서 소유자 리소스 ID 원본 | 이 값은 통합 문서를 “소유”하는 Azure Resource의 리소스 ID입니다. 일반적으로 Application Insights 리소스 또는 Log Analytics 작업 영역입니다. Azure Monitor 내에서 이 값은 리터럴 문자열 "Azure Monitor" 일 수도 있습니다. 통합 문서가 저장되면 이 값은 통합 문서가 연결된 값입니다. |
통합 문서 리소스의 출처 | 통합 문서에 사용되는 기본 리소스를 지정하는 Azure Resource ID의 배열입니다. 예를 들어 열려는 템플릿에 가상 머신 메트릭이 표시되는 경우, 여기에 있는 값은 가상 머신 리소스 ID입니다. 소유자 및 리소스는 여러 번 동일한 설정으로 설정됩니다. |
템플릿 ID 원본 | 템플릿에서 열려는 ID를 지정하세요. 갤러리의 커뮤니티 템플릿이 가장 일반적인 경우입니다. Workbooks/Performance/Apdex 템플릿의 경우 Community-Workbooks/Performance/Apdex 와 같이 템플릿 경로에 Community- 접두사를 붙입니다. 저장된 통합 문서 또는 템플릿에 대한 링크인 경우 해당 항목의 Azure 리소스 ID에 대한 전체 경로를 사용합니다. 예: "/subscriptions/12345678-a1b2-1234-a1b2-c3d4e5f6/resourceGroups/rgname/providers/microsoft.insights/workbooks/1a2b3c4d-5678-abcd-xyza-1a2b3c4d5e6f |
통합 문서 형식 원본 | 열려는 통합 문서 템플릿의 종류를 지정합니다. 가장 일반적인 경우는 기본값 또는 통합 문서 옵션을 사용하여 현재 통합 문서의 값을 사용합니다. |
갤러리 형식 원본 | 이 값은 열리는 템플릿의 갤러리 보기에 표시되는 갤러리 유형을 지정합니다. 가장 일반적인 경우는 기본값 또는 통합 문서 옵션을 사용하여 현재 통합 문서의 값을 사용합니다. |
위치 원본 | 특정 통합 문서 리소스를 여는 경우에는 위치 필드를 지정해야 합니다. 위치를 지정하지 않으면 통합 문서 콘텐츠 찾기가 느려집니다. 위치를 알고 있다면 지정하세요. 위치를 알 수 없거나 특정한 위치가 없는 템플릿을 여는 경우에는 이 필드를 Default 로 그대로 둡니다. |
템플릿에 특정 매개 변수 전달 | 특정 매개 변수를 템플릿에 전달하려면 선택합니다. 이 옵션을 선택하면 지정된 매개 변수만 템플릿에 전달되거나 현재 통합 문서의 모든 매개 변수가 템플릿에 전달됩니다. 이 경우 이 매개변수 값이 작동하려면 매개 변수 이름이 두 통합 문서에서 동일해야 합니다. |
통합 문서 템플릿 매개 변수 | 이 섹션에서는 대상 템플릿에 전달되는 매개 변수를 정의합니다. 이름은 대상 템플릿의 매개 변수 이름과 일치해야 합니다. 셀, 열, 매개 변수 및 고정 값 중에서 선택합니다. 대상 템플릿에 해당 매개 변수를 전달하기 위해 이름 및 값은 비워 둘 수 없습니다. |
앞의 각 설정에 대해 연결된 통합 문서의 값을 가져올 위치를 선택해야 합니다. 링크 원본을 참조하세요.
통합 문서 링크가 열리면 새 통합 문서 보기가 이전 설정에서 구성된 모든 값으로 전달됩니다.
링크 원본
원본 | 설명 |
---|---|
셀 | 그리드에서 해당 셀의 값이 링크 값으로 사용됩니다 |
Column | 이 옵션을 선택하면 그리드에서 다른 열을 선택할 수 있는 필드가 나타납니다. 행에 대한 해당 열의 값은 링크 값에 사용됩니다. 이 링크 값은 일반적으로 템플릿 ID 필드를 열로 설정하여 그리드의 각 행이 다른 템플릿을 열 수 있도록 하는 데 사용됩니다. 또는 통합 문서 리소스 필드가 Azure 리소스 ID가 포함된 열로 설정된 경우 다른 리소스에 대해 동일한 통합 문서 템플릿을 여는 데 사용됩니다. |
매개 변수 | 이 옵션을 선택하면 매개 변수를 선택할 수 있는 필드가 나타납니다. 해당 매개 변수의 값은 링크를 클릭했을 때의 값으로 사용됩니다. |
고정 값 | 이 옵션을 선택하면 연결된 통합 문서에 사용되는 고정 값을 입력할 수 있는 필드가 나타납니다. 그리드에 있는 모든 행이 필드에 대해 동일한 값을 사용하는 경우에 일반적으로 이 값이 사용됩니다. |
구성 요소 | 통합 문서의 현재 구성 요소에 설정된 값을 사용합니다. 쿼리 및 메트릭 구성 요소에서는 연결된 통합 문서의 통합 문서 리소스를 현재 통합 문서가 아니라 쿼리/메트릭 구성 요소에서 사용되는 리소스로 설정하는 것이 일반적입니다. |
통합 문서 | 현재 통합 문서에 설정된 값을 사용합니다. |
기본값 | 값을 지정하지 않은 경우 사용될 기본값을 사용합니다. 이 경우는 갤러리 유형 원본에 일반적이며 기본 갤러리는 소유자 리소스 유형에 따라 설정됩니다. |