VM Insights 통합 문서를 사용하여 대화형 보고서 만들기
통합 문서는 텍스트, 로그 쿼리, 메트릭 및 매개 변수를 풍부한 대화형 보고서로 결합합니다. 통합 문서는 동일한 Azure 리소스에 대한 액세스 권한이 있는 다른 팀 멤버가 편집할 수 있습니다.
통합 문서는 다음을 수행하는 데 도움이 됩니다.
- CPU 사용률, 디스크 공간, 메모리, 네트워크 종속성 같은 관심 있는 메트릭을 사전에 알 수 없는 경우 VM(가상 머신)의 사용량을 살펴봅니다. 다른 사용량 현황 분석 도구와는 달리 통합 문서를 통해 이러한 종류의 자유 형식 탐색에 매우 유용하도록 여러 종류의 시각화 및 분석을 결합할 수 있습니다.
- 주요 카운터 및 기타 로그 이벤트에 대한 메트릭을 표시하여 최근에 프로비전된 VM이 수행되는 방식을 팀에 설명합니다.
- VM의 크기 조정 실험 결과를 다른 멤버와 공유합니다. 실험의 목표를 텍스트로 설명할 수 있습니다. 그런 다음, 각 메트릭이 목표 위인지 또는 아래인지를 나타내는 명확한 설명선과 함께 실험을 평가하는 데 사용된 각 사용량 메트릭과 분석 쿼리를 보여 줄 수 있습니다.
- 중단이 VM 사용에 미치는 영향을 보고합니다. 데이터, 텍스트 설명 및 다음 단계에 대한 설명을 결합하여 향후 중단을 방지할 수 있습니다.
VM 인사이트 통합 문서
VM 인사이트에는 다음 통합 문서가 포함됩니다. 이러한 통합 문서를 사용하거나 특정 요구 사항을 해결하기 위한 사용자 지정 통합 문서를 만드는 시작점으로 사용할 수 있습니다.
단일 가상 머신
| 통합 문서 | 설명 |
|---|---|
| 성능 | 사용하도록 설정된 Log Analytics 성능 카운터를 모두 사용하는 사용자 지정 가능한 버전의 성능 보기를 제공합니다. |
| 연결 | VM의 인바운드 및 아웃바운드 연결에 대한 심층적 보기를 제공합니다. |
여러 개의 가상 머신
| 통합 문서 | 설명 |
|---|---|
| 성능 | 사용하도록 설정된 Log Analytics 성능 카운터를 모두 사용하는 사용자 지정 가능한 버전의 상위 N개 목록 및 차트 보기를 단일 통합 문서로 제공합니다. |
| 성능 카운터 | 다양한 성능 카운터 세트의 상위 N개 차트 보기를 제공합니다. |
| 연결 | 모니터링되는 VM의 인바운드 및 아웃바운드 연결에 대한 심층적 보기를 제공합니다. |
| 활성 포트 | 모니터링되는 VM의 포트에 바인딩된 프로세스 및 선택한 시간 프레임의 활동 목록을 제공합니다. |
| 포트 열기 | 모니터링되는 VM에서 열린 포트 수와 열린 포트에 대한 세부 정보를 제공합니다. |
| 실패한 연결 | 모니터링되는 VM에서 실패한 연결 수, 실패 추세를 표시하고 시간이 지남에 따라 실패 비율이 증가하는지 여부를 표시합니다. |
| 보안 및 감사 | IP 엔드포인트가 전역적으로 상주하는 전체 연결, 악성 연결에 대해 보고하는 TCP/IP 트래픽 분석입니다. 모든 기능을 사용하려면 보안 검색을 사용하도록 설정해야 합니다. |
| TCP 트래픽 | 모니터링되는 VM과 해당 VM의 전송, 수신 및 총 네트워크 트래픽에 대한 순위가 그리드 형태로 매겨진 보고서이며 추세선으로 표시됩니다. |
| 트래픽 비교 | 단일 컴퓨터 또는 컴퓨터 그룹에 대한 네트워크 트래픽 추세를 비교할 수 있습니다. |
새 통합 문서 만들기
통합 문서는 독립적으로 편집 가능한 차트, 테이블, 텍스트 및 입력 컨트롤로 구성된 섹션으로 구성됩니다. 통합 문서를 더 잘 이해하기 위해 템플릿을 열고 사용자 지정 통합 문서를 만들어 보겠습니다.
Azure Portal의 모니터링 메뉴로 이동합니다.
VM을 선택합니다.
VM 인사이트 페이지에서 성능 또는 맵 탭을 선택한 다음 페이지의 링크에서 통합 문서 보기를 선택합니다. 드롭다운 목록에서 갤러리로 이동을 선택합니다.
시작하는 데 도움이 되는 미리 빌드된 통합 문서와 함께 통합 문서 갤러리가 열립니다.
새로 만들기를 선택하여 새 통합 문서를 만듭니다.
통합 문서 섹션 편집
통합 문서에는 편집과 읽기의 두 가지 모드가 있습니다. 새 통합 문서가 편집 모드에서 열립니다. 이 모드는 그렇지 않은 경우 숨겨진 단계 및 매개 변수를 비롯하여 통합 문서의 모든 콘텐츠를 보여줍니다. 읽기 모드는 간소화된 보고서 스타일 보기를 제공합니다. 읽기 모드를 사용하면 기본 메커니즘이 유지되는 동안 보고서를 만드는 복잡성을 제거할 수 있습니다. 수정이 필요한 경우 몇 번만 클릭하세요.
섹션 편집을 완료한 후 섹션의 왼쪽 하단에서 편집 완료를 선택합니다.
섹션 복제본을 만들려면 이 섹션 복제 아이콘을 선택합니다. 중복 섹션을 만드는 것은 이전 반복을 손실하지 않고 쿼리를 반복하는 좋은 방법입니다.
통합 문서에서 섹션을 위로 이동하려면 위로 이동 또는 아래로 이동 아이콘을 선택합니다.
섹션을 영구적으로 제거하려면 제거 아이콘을 선택합니다.
텍스트 및 Markdown 섹션 추가
통합 문서에 제목, 설명 및 해설을 추가하면 테이블 및 차트의 집합을 설명으로 전환할 수 있습니다. 통합 문서의 텍스트 섹션은 머리글, 굵게, 기울임꼴 및 글머리 기호 목록과 같은 텍스트 서식 지정에 대해 Markdown 구문을 지원합니다.
통합 문서에 텍스트 섹션을 추가하려면 통합 문서 또는 섹션의 왼쪽 하단에서 텍스트 추가를 선택합니다.
쿼리 섹션 추가
통합 문서에 쿼리 섹션을 추가하려면 통합 문서 또는 섹션의 왼쪽 하단에서 쿼리 추가를 선택합니다.
쿼리 섹션은 매우 유연하고 다음과 같은 질문에 응답하는 데 사용할 수 있습니다.
- 네트워크 트래픽이 증가하는 것과 동일한 기간 내 CPU 사용률이 어떻게 되나요?
- 지난달 사용 가능한 디스크 공간의 추세는 어떤가요?
- 지난 2주 동안 VM에서 발생한 네트워크 연결 실패 횟수는 몇 회인가요?
또한 통합 문서를 연 VM의 컨텍스트에서 쿼리하는 것으로 제한되지 않습니다. 여러 VM 및 Log Analytics 작업 영역에서 쿼리하려면 해당 리소스에 대한 액세스 권한이 있어야 합니다.
작업 영역 식별자를 사용하여 다른 Log Analytics 작업 영역 또는 특정 Application Insights 앱의 데이터를 포함합니다. 리소스 간 쿼리에 대한 자세한 내용은 공식 지침을 참조하세요.
고급 분석 쿼리 설정
각 섹션에는 매개 변수 추가 단추의 오른쪽에 있는 설정 
아이콘을 통해 액세스할 수 있는 고유한 고급 설정이 있습니다.
| 설정 | 설명 |
|---|---|
| 사용자 지정 너비 | 항목을 임의의 크기로 만들어 한 줄에 많은 항목을 표시하여 차트와 테이블을 풍부한 대화형 보고서로 구성할 수 있습니다. |
| 조건부로 표시 | 읽기 모드에 있을 때 매개 변수를 기반으로 단계를 숨기도록 지정합니다. |
| 매개 변수 내보내기 | 이렇게 하면 그리드 또는 차트가 이후 단계에서 선택한 행이 값을 변경하거나 표시하게 됩니다. |
| 편집하고 있지 않을 때 쿼리 표시 | 읽기 모드인 경우에도 차트 또는 테이블 앞에 쿼리를 표시합니다. |
| 편집하고 있지 않을 때 분석에서 열기 단추 표시 | 클릭 한 번으로 액세스할 수 있도록 차트의 오른쪽 모서리에 분석 아이콘을 추가합니다. |
이러한 설정 중 대부분은 매우 간단하지만 매개 변수 내보내기를 이해하려면 이 기능을 사용할 수 있는 통합 문서를 검사하는 것이 좋습니다.
미리 작성된 통합 문서 중 하나인 TCP 트래픽은 VM의 연결 메트릭에 대한 정보를 제공합니다.
통합 문서의 첫 번째 섹션은 로그 쿼리 데이터를 기반으로 합니다. 두 번째 섹션도 로그 쿼리 데이터를 기반으로 하지만 첫 번째 테이블에서 행을 선택하면 차트 콘텐츠가 대화형으로 업데이트됩니다.
이 동작은 테이블의 로그 쿼리에서 사용할 수 있는 항목을 선택하면 매개 변수 내보내기 고급 설정을 통해 가능해집니다.
그런 다음 두 번째 로그 쿼리는 행을 선택하여 섹션 제목과 차트에서 사용되는 값 집합을 만들 때 내보낸 값을 활용합니다. 선택된 행이 없으면 섹션 제목과 차트를 숨깁니다.
예를 들어 두 번째 섹션의 숨겨진 매개 변수는 그리드에서 선택한 행의 다음 참조를 사용합니다.
VMConnection
| where TimeGenerated {TimeRange}
| where Computer in ("{ComputerName}") or '*' in ("{ComputerName}")
| summarize Sent = sum(BytesSent), Received = sum(BytesReceived) by bin(TimeGenerated, {TimeRange:grain})
메트릭 섹션 추가
메트릭 섹션에서는 Azure Monitor 메트릭 데이터를 대화형 보고서로 통합할 수 있는 모든 권한을 제공합니다. VM 인사이트에서 미리 빌드된 통합 문서에는 일반적으로 메트릭 데이터가 아닌 분석 쿼리 데이터가 포함됩니다. 메트릭 데이터로 통합 문서를 만들 수 있으므로 한 곳에서 두 기능의 장점을 최대한 활용할 수 있습니다. 또한 액세스 권한이 있는 모든 구독의 리소스에서 메트릭 데이터를 가져올 수 있습니다.
다음은 CPU 성능의 그리드 시각화를 제공하기 위해 통합 문서로 가져오는 VM 데이터의 예입니다.
매개 변수 섹션 추가
통합 문서 매개 변수를 사용하면 쿼리 또는 텍스트 섹션을 수동으로 편집하지 않고 통합 문서에서 값을 변경할 수 있습니다. 그러면 기본 분석 쿼리 언어를 이해해야 하는 요구 사항을 제거하고 통합 문서 기반 보고의 잠재적인 대상을 크게 확장하게 됩니다.
{parameterName}과 같은 중괄호에서 매개 변수의 이름을 입력하여 쿼리, 텍스트 또는 다른 매개 변수 섹션에서 매개 변수 값을 대체합니다. 매개 변수 이름은 영문자 또는 밑줄과 같은 JavaScript 식별자 뒤에 영숫자 또는 밑줄이 오는 것과 비슷한 규칙으로 제한됩니다. 예를 들어, a1은 허용되지만 1a는 허용되지 않습니다.
매개 변수는 선형이며 통합 문서의 맨 위에서 시작하고 이후 단계까지 이어집니다. 나중에 통합 문서에서 선언된 매개 변수는 이전에 선언되었던 매개 변수를 재정의할 수 있습니다. 쿼리를 사용하는 매개 변수는 이전에 정의된 매개 변수의 값에 액세스할 수 있습니다. 또한 매개 변수의 단계 자체 내에서 매개 변수는 왼쪽에서 오른쪽으로 이어지는 선형이며 여기서 오른쪽 매개 변수는 동일한 단계에서 이전에 선언된 매개 변수에 종속될 수 있습니다.
현재 네 가지 형식의 매개 변수가 지원됩니다.
| 매개 변수 | 설명 |
|---|---|
| Text | 사용자가 텍스트 상자를 편집할 수 있습니다. 선택적으로 쿼리를 제공하여 기본값을 채울 수 있습니다. |
| 드롭다운 | 사용자가 값 집합에서 선택할 수 있습니다. |
| 시간 범위 선택기 | 사용자는 미리 정의된 시간 범위 값 집합 중에서 선택하거나 사용자 지정 시간 범위 중에서 선택할 수 있습니다. |
| 리소스 선택기 | 사용자는 통합 문서에 대해 선택한 리소스 중에서 선택할 수 있습니다. |
텍스트 매개 변수 사용
이스케이프 또는 인용 부호 없이 사용자가 텍스트 상자에 입력한 값을 쿼리에서 직접 대체합니다. 필요한 값이 문자열인 경우 쿼리는 매개 변수 주위에 작은따옴표가 있어야 합니다. 예를 들면 '{parameter}'입니다.
텍스트 매개 변수를 사용하면 텍스트 상자의 값을 어디서나 사용할 수 있습니다. 테이블 이름, 열 이름, 함수 이름 또는 연산자가 될 수 있습니다. 텍스트 매개 변수 형식에는 분석 쿼리에서 기본값 가져오기 설정이 있습니다. 이를 통해 통합 문서 작성자가 쿼리를 사용하여 해당 텍스트 상자에 대해 기본 값을 채울 수 있습니다.
로그 쿼리에서 기본값을 사용하는 경우 첫 번째 행(0행, 0열)의 첫 번째 값만 기본값으로 사용됩니다. 이러한 이유로 하나의 행과 하나의 열만 반환하도록 쿼리를 제한하는 것이 좋습니다. 쿼리에서 반환된 다른 데이터는 무시됩니다.
쿼리가 반환하는 값은 이스케이프나 인용 없이 직접 바꿔집니다. 쿼리에서 행을 반환하지 않는 경우 매개 변수의 결과는 빈 문자열(매개 변수가 필요 없는 경우)이거나 정의되지 않습니다(매개 변수가 필수인 경우).
드롭다운 사용
드롭다운 매개 변수 형식을 사용하면 하나 이상의 값을 선택하는 데 사용되는 드롭다운 컨트롤을 만들 수 있습니다.
드롭다운은 로그 쿼리 또는 JSON에 의해 채워집니다. 쿼리에서 하나의 열을 반환하는 경우 해당 열의 값은 드롭다운 컨트롤의 값 및 레이블 모두입니다. 쿼리에서 두 개의 열을 반환하는 경우 첫 번째 열은 값이고, 두 번째 열은 드롭다운에 표시된 레이블입니다. 쿼리에서 세 개의 열을 반환하는 경우 세 번째 열은 해당 드롭다운에서 기본 선택 항목을 나타내기 위해 사용됩니다. 이 열은 어떤 형식이든 될 수 있지만 가장 간단한 형식은 부울 또는 숫자 형식입니다. 여기서 0은 false이고, 1은 true입니다.
열이 문자열 형식인 경우 null/빈 문자열은 false로 간주됩니다. 다른 모든 값은 true로 간주됩니다. 단일 선택 영역 드롭다운의 경우 true 값인 첫 번째 값은 기본 선택 영역으로 사용됩니다. 다중 선택 영역 드롭다운의 경우 true 값인 모든 값은 기본 선택된 집합으로 사용됩니다. 드롭다운의 항목은 쿼리에서 행을 반환한 순서로 표시됩니다.
연결 개요 보고서에서 표시된 매개 변수를 살펴보겠습니다. 방향 옆에 있는 편집 기호를 선택합니다.
이 작업은 매개 변수 편집 창을 엽니다.
JSON을 사용하면 콘텐츠로 채워진 임의의 테이블을 생성할 수 있습니다. 예를 들어 다음 JSON은 드롭다운에서 두 값을 생성합니다.
[
{ "value": "inbound", "label": "Inbound"},
{ "value": "outbound", "label": "Outbound"}
]
보다 적용 가능한 예는 드롭다운 목록을 사용하여 이름별로 성능 카운터 집합에서 선택하는 것입니다.
Perf
| summarize by CounterName, ObjectName
| order by ObjectName asc, CounterName asc
| project Counter = pack('counter', CounterName, 'object', ObjectName), CounterName, group = ObjectName
쿼리는 다음 결과를 보여 줍니다.
드롭다운 목록은 대화형 보고서를 사용자 지정하고 만드는 데 사용할 수 있는 강력한 도구입니다.
시간 범위 매개 변수
드롭다운 매개 변수 형식을 통해 사용자 지정 시간 범위 매개 변수를 만들 수 있습니다. 동일한 수준의 유연성이 필요하지 않은 경우 즉시 사용 가능한 시간 범위 매개 변수 형식을 사용할 수도 있습니다.
시간 범위 매개 변수 형식에는 5분부터 최근 90일까지 이동하는 15개의 기본 범위가 포함됩니다. 사용자 지정 시간 범위 선택을 허용하는 옵션도 있습니다. 보고서 운영자는 시간 범위에 대해 명시적인 시작 및 중지 값을 선택할 수 있습니다.
리소스 선택기
리소스 선택기 매개 변수 형식에서는 특정 형식의 리소스로 보고서 범위를 지정하는 기능을 제공합니다. 리소스 선택기 형식을 사용하는 미리 빌드된 통합 문서의 예는 성능 통합 문서입니다.
통합 문서 저장 및 팀과 공유
통합 문서는 통합 문서 갤러리에 액세스하는 방법에 따라 Log Analytics 작업 영역 또는 VM 리소스 내에 저장됩니다. 통합 문서는 비공개인 내 보고서 섹션 또는 리소스에 대한 액세스 권한을 갖고 있는 모든 사용자가 액세스할 수 있는 공유 보고서 섹션에 저장할 수 있습니다. 리소스의 모든 통합 문서를 보려면 열기를 선택합니다.
현재 내 보고서에 있는 통합 문서를 공유하려면:
- 열기를 선택합니다.
- 공유할 통합 문서 옆에 있는 줄임표(...)를 선택합니다.
- 공유 보고서로 이동을 선택합니다.
링크 또는 이메일을 통해 통합 문서를 공유하려면 공유를 선택합니다. 통합 문서를 보려면 링크의 수신자는 Azure Portal에서 이 리소스에 대한 액세스가 필요함을 명심하세요. 편집하려면 수신자는 최소한 리소스에 대한 참가자 권한이 필요합니다.
Azure 대시보드에 통합 문서에 대한 링크를 고정하려면:
- 열기를 선택합니다.
- 고정하려는 통합 문서 옆에 있는 줄임표(...)를 선택합니다.
- 대시보드에 고정을 선택합니다.
다음 단계
- 제한 사항 및 전반적인 VM 성능을 식별하려면 Azure VM 성능 보기를 참조하세요.
- 검색된 애플리케이션 종속성에 대해 알아보려면 VM 인사이트 맵 보기를 참조하세요.