링크 작업

아티클
09/25/2024

링크 작업은 통합 문서 링크 구성 요소나 그리드, 제목 또는 그래프의 열 설정을 통해 액세스할 수 있습니다.

일반 링크 작업

동작 연결	선택 시 작업
일반 세부 정보	속성 그리드 컨텍스트 보기에서 행 값을 표시합니다.
셀 세부 정보	속성 그리드 컨텍스트 보기의 셀 값을 표시합니다. 정보를 포함하는 동적 형식(예: 위치 및 역할 인스턴스 등의 요청 속성이 있는 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의 부조종사(미리 보기)	작업이 호출되면 Azure의 Microsoft Copilot(미리 보기)에 서식을 지정하고 프롬프트를 보냅니다. Azure(미리 보기) 설정에서 Copilot를 참조하세요.

링크 설정

링크 렌더러를 사용하는 경우 다음 설정을 사용할 수 있습니다.

설정	설명
열 보기	작업 중 하나를 선택할 수 있습니다.
메뉴 항목	리소스 개요를 선택한 경우 이 메뉴 항목은 리소스 개요에 있습니다. 이 항목을 사용하여 리소스에 대한 “개요” 대신 경고 또는 활동 로그를 열 수 있습니다. 각 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의 요청 페이로드에 대한 편집기입니다.

Azure Workbooks ARM 작업 설정을 보여 주는 스크린샷.

ARM 작업 UX 설정

이 섹션에서는 ARM 작업을 실행하기 전에 사용자에게 표시되는 내용을 구성합니다.

Source	설명
타이틀	보기 실행에 사용되는 제목입니다.
ARM 작업 이름 사용자 지정	작성자는 작업이 트리거된 후 알림에 표시되는 ARM 작업을 사용자 지정할 수 있습니다.
ARM 작업 설명	ARM 작업을 실행하려는 사용자에게 유용한 설명을 제공하는 데 사용되는 가격 인하 텍스트입니다.
실행 단추 텍스트 원본	ARM 작업을 트리거하기 위해 실행 단추에 사용되는 레이블입니다.

Azure Workbooks ARM 작업 UX 설정을 보여 주는 스크린샷.

이러한 구성이 설정된 후 사용자가 링크를 선택하면 여기에 설명된 UX가 포함된 보기가 열립니다. 사용자가 단추 텍스트 실행에서 지정한 단추를 선택하면 구성된 값을 사용하여 ARM 작업이 실행됩니다. 컨텍스트 창 하단에서 요청 세부 정보 보기를 선택하여 ARM 작업에 사용되는 HTTP 메서드와 ARM API 엔드포인트를 검사할 수 있습니다.

Azure Workbooks ARM 작업 창을 보여 주는 스크린샷.

ARM 작업의 진행률과 결과는 Azure Portal 알림으로 표시됩니다.

Azure ARM 사용자 지정 알림을 보여 주는 스크린샷.

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 입력을 지정합니다.

그리드

매개 변수 이름: 보기 입력 매개 변수의 이름입니다.
매개 변수 원본: View 매개 변수의 값을 가져오는 위치를 나타냅니다. 링크 원본의 셀, 열, 매개 변수 및 고정 값 중에서 선택합니다.

참고 항목

고정 값을 선택하면 대괄호를 사용하여 텍스트 상자에서 "{paramName}"을 연결하여 매개 변수를 확인할 수 있습니다. "{columnName_column}" 같은 열 이름 뒤에 _column을 추가하여 열을 매개 변수 열로 처리할 수 있습니다.
매개 변수 값: 매개 변수 원본의 값에 따라 이 드롭다운에는 사용 가능한 매개 변수, 열 또는 고정 값이 포함됩니다.

JSON

편집기에서 JSON 형식으로 탭 입력을 지정합니다. 그리드 모드와 마찬가지로 매개 변수에 {paramName}을 사용하고 열에 {columnName_column}를 사용하여 매개 변수 및 열을 참조할 수 있습니다. 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가 포함된 열로 설정된 경우 다른 리소스에 대해 동일한 통합 문서 템플릿을 여는 데 사용됩니다.
매개 변수	이 옵션을 선택하면 매개 변수를 선택할 수 있는 필드가 나타납니다. 해당 매개 변수의 값은 링크를 클릭했을 때의 값으로 사용됩니다.
고정 값	이 옵션을 선택하면 연결된 통합 문서에 사용되는 고정 값을 입력할 수 있는 필드가 나타납니다. 그리드에 있는 모든 행이 필드에 대해 동일한 값을 사용하는 경우에 일반적으로 이 값이 사용됩니다.
구성 요소	통합 문서의 현재 구성 요소에 설정된 값을 사용합니다. 쿼리 및 메트릭 구성 요소에서는 연결된 통합 문서의 통합 문서 리소스를 현재 통합 문서가 아니라 쿼리/메트릭 구성 요소에서 사용되는 리소스로 설정하는 것이 일반적입니다.
통합 문서	현재 통합 문서에 설정된 값을 사용합니다.
기본값	값을 지정하지 않은 경우 사용될 기본값을 사용합니다. 이 경우는 갤러리 유형 원본에 일반적이며 기본 갤러리는 소유자 리소스 유형에 따라 설정됩니다.

Azure의 부조종사(미리 보기) 설정

Azure의 Copilot(미리 보기) 링크가 호출되면 구성된 링크의 형식을 지정하고 Azure의 Microsoft Copilot(미리 보기)에 프롬프트로 보냅니다. 그런 다음 Azure의 Microsoft Copilot은 프롬프트에 응답하여 Azure 개념, 서비스 또는 제품에 대해 자세히 설명합니다. 프롬프트 텍스트에 매개 변수 값 또는 그리드 콘텐츠를 삽입하도록 링크 작업을 구성할 수 있습니다.