진단 로그 수집

아티클
03/29/2024

Azure Stack Hub에서 만든 진단 로그를 공유할 수 있습니다. Windows 구성 요소 및 온-프레미스 Azure 서비스는 이러한 로그를 만듭니다. Microsoft 지원 로그를 사용하여 Azure Stack Hub instance 문제를 해결하거나 식별할 수 있습니다.

Azure Stack Hub 진단 로그 수집을 시작하려면 instance 등록해야 합니다. Azure Stack Hub를 등록하지 않은 경우 PEP(권한 있는 엔드포인트) 를 사용하여 로그를 공유합니다.

Microsoft 지원에는 다양한 방법으로 진단 로그를 보낼 수 있습니다. Azure에 대한 연결 상태에 따라 다음과 같은 옵션을 사용할 수 있습니다.

사전에 로그 보내기(권장)
지금 로그 보내기
로그를 로컬로 저장

순서도는 진단 로그를 보내는 데 사용할 옵션을 보여 줍니다. Azure Stack Hub가 Azure에 연결하는 경우 자동 관리 로그 수집을 사용하도록 설정합니다. 자동 관리 로그 수집은 중요한 경고가 발생할 때 진단 로그를 Azure의 Microsoft 제어 스토리지 Blob에 자동으로 업로드합니다. 지금 로그 보내기를 사용하여 주문형 로그를 수집할 수도 있습니다. 연결이 끊긴 환경에서 실행되는 Azure Stack Hub의 경우 또는 연결 문제가 있는 경우 로컬로 로그 저장을 선택합니다.

순서도는 Microsoft에 지금 로그를 보내는 방법을 보여 줍니다.

사전에 로그 보내기

자동 관리 로그 수집은 지원 사례를 열기 전에 자동으로 Azure Stack Hub에서 진단 로그를 수집하여 Microsoft로 보냅니다. 시스템 상태 경고가 발생한 경우에만 이러한 로그가 수집됩니다. Microsoft 지원 지원 사례의 컨텍스트에서만 이러한 로그에 액세스합니다.

Azure Stack Hub 버전 2008부터 자동 관리 로그 수집은 개선된 알고리즘을 사용하여 운영자에게 표시되지 않는 오류 조건에서도 로그를 캡처합니다. 이러한 개선 사항은 운영자 상호 작용 없이 적절한 진단 정보가 적시에 수집되도록 하는 데 도움이 됩니다. Microsoft 지원은 문제 해결을 시작할 수 있으며, 경우에 따라 문제를 조기에 해결하기도 합니다. 초기 알고리즘 개선은 패치 및 업데이트 작업에 중점을 줍니다.

이벤트가 이러한 알림을 트리거하면 Azure Stack Hub는 로그를 Microsoft에 자동으로 전송합니다. 또한 Azure Stack Hub는 다른 실패 이벤트에서 트리거한 로그도 Microsoft에 보냅니다. 이러한 이벤트는 연산자에 표시되지 않습니다..

자동 관리 로그 수집을 사용하도록 설정하는 것이 좋습니다. 이를 통해 제품 팀은 오류 이벤트로 인한 문제를 진단하고 제품의 품질을 개선할 수 있습니다.

참고

사전 로그 수집을 사용하도록 설정하고 등록 갱신 또는 변경에 설명된 대로 Azure Stack Hub 등록을 갱신 하거나 변경하는 경우 사전 로그 수집을 다시 사용하도록 설정해야 합니다.

Azure Stack Hub는 다음에 대한 로그를 자동으로 수집합니다.

경고	오류 ID 유형
업데이트에 주의 필요	Urp.UpdateWarning
업데이트 실패	Urp.UpdateFailure

경고	오류 ID 유형
테이블 서버 데이터 손상	StorageService.Table.server.data.corruption-Critical
가상 머신 배치 시 노드에 액세스할 수 없음	AzureStack.ComputeController.HostUnresponsive
Blob 서비스 데이터가 손상되었습니다.	StorageService.Blob.service.data.is.corrupted-Critical
계정 및 컨테이너 서비스 데이터 손상	StorageService.Account.and.Container.Service.data.corruption-Critical

자동 관리 로그 수집을 사용하지 않도록 설정된 경우 Azure Stack Hub 버전 2108부터 로그가 캡처되고 자동 관리 실패 이벤트에 대해 로컬로 저장됩니다. Microsoft는 지원 사례의 컨텍스트에서만 로컬 로그에 액세스합니다.

자동 관리 로그 수집은 언제든 비활성화하고 다시 활성화할 수 있습니다. 자동 관리 로그 수집을 설정하려면 다음 단계를 수행합니다.

Azure Stack Hub 관리자 포털에 로그인합니다.
도움말 + 지원 개요를 엽니다.
배너가 표시되면 자동 관리 로그 수집 사용을 선택합니다. 또는 설정을 선택하고자동 관리 로그 수집을 사용으로 설정한 다음 저장을 선택해도 됩니다.

참고

로컬 파일 공유를 위한 로그 위치 설정을 구성했다면, 수명 주기 관리 정책으로 공유 스토리지가 크기 할당량에 도달하지 못하게 해야 합니다. Azure Stack Hub는 로컬 파일 공유를 모니터링하거나 보존 정책을 적용하지 않습니다.

데이터 처리 방법

Azure Stack Hub 시스템 상태 알림만을 기준으로 하는 Microsoft의 정기 자동 로그 수집에 동의합니다. Microsoft에서 관리하고 제어하는 Azure 스토리지 계정에서 이러한 로그의 업로드와 보존이 수행된다는 사실을 인정하고 동의합니다.

데이터는 시스템 상태 경고 문제 해결에 사용되며 사용자의 동의 없이 마케팅, 광고 또는 기타 상업적 목적에 사용되지 않습니다. 데이터는 최대 90일 동안 보존할 수 있으며 Microsoft는 표준 개인 정보 취급 방침에 따라 수집된 모든 데이터를 처리합니다.

사용 권한 해지는 이전에 동의를 통해 수집된 데이터에는 영향을 주지 않습니다.

자동 관리 로그 수집을 사용하여 수집된 로그는 Microsoft에서 관리하고 제어하는 Azure 스토리지 계정에 업로드됩니다. Microsoft는 지원 사례의 컨텍스트에서 이러한 로그에 액세스하여 Azure Stack Hub의 상태를 개선할 수 있습니다.

지금 로그 보내기

팁

지금 로그 보내기 대신 사전에 로그 보내기를 사용하여 시간을 절약합니다.

이제 로그 보내기는 일반적으로 지원 사례를 열기 전에 Azure Stack Hub에서 진단 로그를 수동으로 수집하고 업로드하는 옵션입니다.

진단 로그를 Microsoft 지원에 수동으로 전송하는 방법은 두 가지가 있습니다.

관리자 포털(권장)
PowerShell

Azure Stack Hub가 Azure에 연결되었다면 관리자 포털을 사용하는 것이 좋습니다. 로그를 Microsoft로 바로 보내는 가장 간단한 방법이기 때문입니다. 포털을 사용할 수 없는 경우 PowerShell을 사용하여 로그를 보내야 합니다.

참고

관리자 포털 또는 PowerShell cmdlet을 사용하여 로그를 보내는 경우 Test-AzureStack 은 백그라운드에서 자동으로 실행되어 진단 정보를 수집합니다.

관리자 포털을 사용하여 지금 로그 전송

관리자 포털을 사용하여 지금 로그를 전송하려면 다음을 수행합니다.

도움말 + 지원 로그 컬렉션 > 지금 로그 전송을 엽니다.
로그 수집 시작 시간과 종료 시간을 지정합니다.
현지 표준 시간대를 선택합니다.
수집 및 업로드를 선택합니다.

인터넷 연결이 끊어지거나 로컬로 로그만 저장하려는 경우 Get-AzureStackLog 메서드를 사용하여 로그를 보냅니다.

PowerShell을 사용하여 지금 로그 전송

지금 로그 전송 방법을 사용할 때 관리자 포털 대신 PowerShell을 사용하고 싶다면, cmdlet을 사용하여 특정 로그를 수집하고 전송하면 됩니다.

FromDate 및 ToDate 매개 변수를 사용하면 특정 기간 동안 로그를 수집할 수 있습니다. 이러한 매개 변수를 지정하지 않으면 기본적으로 지난 4시간 동안의 로그가 수집됩니다.
컴퓨터 이름을 기준으로 로그를 필터링하려면 FilterByNode 매개 변수를 사용합니다. 예를 들면 다음과 같습니다.
```
Send-AzureStackDiagnosticLog -FilterByNode azs-xrp01
```
FilterByLogType 매개 변수를 사용하여 형식별로 로그를 필터링합니다. File, Share 또는 WindowsEvent를 기준으로 필터링할 수 있습니다. 예를 들면 다음과 같습니다.
```
Send-AzureStackDiagnosticLog -FilterByLogType File
```
FilterByResourceProvider 매개 변수를 사용하여 고가치 RP(리소스 공급자)에 대한 진단 로그를 전송합니다. 일반 구문은 다음과 같습니다.
```
Send-AzureStackDiagnosticLog -FilterByResourceProvider <<value-add RP name>>
```
SQL RP에 대한 진단 로그를 전송하려면 다음을 수행합니다.
```
Send-AzureStackDiagnosticLog -FilterByResourceProvider SQLAdapter
```
MySQL RP에 대한 진단 로그를 전송하려면 다음을 수행합니다.
```
Send-AzureStackDiagnosticLog -FilterByResourceProvider MySQLAdapter
```
Event Hubs에 대한 진단 로그를 전송하려면 다음을 수행합니다.
```
Send-AzureStackDiagnosticLog -FilterByResourceProvider eventhub
```
Azure Stack Edge에 대한 진단 로그를 전송하려면 다음을 수행합니다.
```
Send-AzureStackDiagnosticLog -FilterByResourceProvide databoxedge
```
FilterByRole 매개 변수를 사용하여 VirtualMachines 및 BareMetal 역할에서 진단 로그를 전송합니다.
```
Send-AzureStackDiagnosticLog -FilterByRole VirtualMachines,BareMetal
```
지난 8시간 동안의 로그 파일에 대한 날짜 필터링을 사용하여 VirtualMachines 및 BareMetal 역할에서 진단 로그를 전송하려면 다음을 수행합니다.
```
$fromDate = (Get-Date).AddHours(-8)
Invoke-Command -Session $pepsession -ScriptBlock {Send-AzureStackDiagnosticLog -FilterByRole VirtualMachines,BareMetal -FromDate $using:fromDate}
```

8~2시간 전의 로그 파일에 대한 날짜 필터링을 사용하여 VirtualMachines 및 BareMetal 역할에서 진단 로그를 전송하려면 다음을 수행합니다.

$fromDate = (Get-Date).AddHours(-8)
$toDate = (Get-Date).AddHours(-2)
Invoke-Command -Session $pepsession -ScriptBlock {Send-AzureStackDiagnosticLog -FilterByRole VirtualMachines,BareMetal -FromDate $using:fromDate -ToDate $using:toDate}

참고

인터넷 연결이 끊어지거나 로컬로 로그만 저장하려는 경우 Get-AzureStackLog 메서드를 사용하여 로그를 보냅니다.

데이터 처리 방법

Azure Stack Hub 진단 로그 수집을 시작하여 해당 로그를 업로드하고 Microsoft에서 관리 및 제어하는 Azure Storage 계정에 보존하는 것에 동의하고 승인합니다. Microsoft 지원은 로그 수집을 위해 고객과 소통하지 않고도 지원 사례를 통해 이러한 로그에 즉시 액세스할 수 있습니다.

로그를 로컬로 저장

Azure Stack Hub와 Azure의 연결이 끊어지면 로컬 SMB(서버 메시지 블록) 공유에 로그를 저장할 수 있습니다. 예를 들어 연결이 끊긴 환경을 실행할 수 있습니다. 일반적으로 연결되어 있지만 연결 문제가 발생하는 경우 로컬로 로그를 저장하여 문제 해결에 도움을 줄 수 있습니다.

설정 블레이드에서 공유에 쓸 수 있는 권한이 있는 경로와 사용자 이름 및 암호를 입력합니다. 지원 사례 중에 Microsoft 지원 이러한 로컬 로그를 전송하는 방법에 대한 자세한 단계를 제공합니다. 관리자 포털을 사용할 수 없는 경우 Get-AzureStackLog 를 사용하여 로그를 로컬로 저장할 수 있습니다.

진단 로그 수집 옵션의 스크린샷

대역폭 고려 사항

진단 로그 수집의 평균 크기는 사전 또는 수동으로 실행되는지 여부에 따라 달라집니다. 자동 관리 로그 수집의 평균 크기는 약 2GB입니다. 이제 송신 로그의 컬렉션 크기는 수집되는 시간(최대 4시간)과 Azure Stack Hub 배율 단위(4~16개 노드)의 실제 노드 수에 따라 달라집니다.

다음 표에서는 Azure에 대한 연결이 제한되거나 데이터 통신이 제한된 환경에 대한 고려 사항을 나열합니다.

네트워크 연결	영향
낮은 대역폭/높은 대기 시간 연결	로그 업로드를 완료하는 데 시간이 더 걸립니다.
공유 연결	업로드는 네트워크 연결을 공유하는 다른 앱/사용자에게도 영향을 줄 수 있습니다.
데이터 통신 연결	추가 네트워크 사용량에 대해 ISP에서 다른 요금이 부과될 수 있습니다.

예를 들어 Azure Stack Hub의 인터넷 연결 또는 연결 속도가 초당 5메가비트(낮은 대역폭)인 경우 2GB의 진단 로그 데이터를 Microsoft 지원에 업로드하는 데 약 57분이 걸립니다. 5메가비트/초 링크 속도를 사용하는 8GB 수동 로그 수집의 경우 데이터를 업로드하는 데 약 3시간 49분이 걸립니다. 진단 데이터를 업로드하는 데 시간이 오래 걸리는 경우 지원 환경이 지연되거나 영향을 줄 수 있습니다.

로그 컬렉션 보기

Azure Stack Hub에서 수집된 로그의 기록은 다음 날짜 및 시간과 함께 도움말 + 지원의 로그 컬렉션 페이지에 표시됩니다.

수집된 시간: 로그 수집 작업이 시작된 시기입니다.
상태: 진행 중이거나 완료되었습니다.
로그 시작: 수집하려는 기간의 시작입니다.
로그 종료: 기간의 끝입니다.
형식: 수동 또는 자동 관리 로그 컬렉션인 경우

도움말 + 지원의 로그 컬렉션

추가 정보

Azure Stack Hub 로그 및 고객 데이터 처리

진단 로그 수집

사전에 로그 보내기

데이터 처리 방법

지금 로그 보내기

관리자 포털을 사용하여 지금 로그 전송

PowerShell을 사용하여 지금 로그 전송

데이터 처리 방법

로그를 로컬로 저장

대역폭 고려 사항

로그 컬렉션 보기

추가 정보

피드백

피드백

추가 리소스