진단 로그 수집Diagnostic log collection

Azure Stack 허브는 서로 상호 작용 하는 Windows 구성 요소 및 온-프레미스 Azure 서비스의 컬렉션입니다.Azure Stack Hub is a collection of both Windows components and on-premises Azure services interacting with each other. 이러한 모든 구성 요소 및 서비스는 자체 로그 집합을 생성 합니다.All these components and services generate their own set of logs. Microsoft 지원는 이러한 로그를 사용 하 여 문제를 식별 하 고 해결 하므로 진단 로그 수집을 제공 합니다.Since Microsoft Support uses these logs to identify and fix your issues, we offer diagnostic log collection. 진단 로그 수집을 사용 하면 Microsoft 지원로 진단 로그를 신속 하 게 수집 하 고 공유할 수 있습니다.Diagnostic log collection helps you quickly collect and share diagnostic logs with Microsoft Support.

중요

진단 로그 수집을 사용 하려면 Azure Stack 허브를 등록 해야 합니다.You have to register Azure Stack Hub to use diagnostic log collection. Azure Stack Hub를 등록 하지 않은 경우 권한 있는 끝점 (PEP) 을 사용 하 여 로그를 공유 합니다.If you haven't registered Azure Stack Hub, use the privileged endpoint (PEP) to share logs.

Azure Stack 허브에는 Microsoft 지원에 진단 로그를 수집, 저장 및 전송 하는 여러 가지 방법이 있습니다.Azure Stack Hub has multiple ways to collect, save, and send diagnostic logs to Microsoft Support. Azure에 대 한 연결에 따라 로그를 수집 하 고 보내는 데 사용할 수 있는 옵션은 다음과 같습니다.Depending on connectivity to Azure, your options for collecting and sending logs are:

아래의 순서도는 각 사례에서 진단 로그를 보내는 데 사용할 수 있는 옵션을 보여 줍니다.The flowchart below shows which option to use for sending diagnostic logs in each case. Azure Stack 허브가 Azure에 연결할 수 있는 경우 중요 한 경고가 발생 하면 Azure에서 자동으로 진단 로그를 Microsoft에서 제어 하는 저장소 blob에 업로드 하는 자동 관리 로그 수집 을 사용 하는 것이 좋습니다.If Azure Stack Hub can connect to Azure, we recommend enabling Proactive log collection, which will automatically upload diagnostic logs to a Microsoft-controlled storage blob in Azure when a critical alert gets raised. 또는 지금 로그 보내기 를 사용 하 여 요청 시 로그를 수집할 수 있습니다.You can alternatively collect logs on-demand by using Send logs now. Azure에서 Azure Stack 허브의 연결이 끊어지면 로그를 로컬로 저장할 수 있습니다.If Azure Stack Hub is disconnected from Azure, you can Save logs locally.

이제 Microsoft에 로그를 전송 하는 방법을 보여 주는 순서도

사전에 로그 보내기Send logs proactively

지원 사례를 열기 전에 자동 관리 로그 수집은 자동으로 Azure Stack 허브에서 Microsoft로 진단 로그를 수집 하 여 보냅니다.Proactive log collection automatically collects and sends diagnostic logs from Azure Stack Hub to Microsoft before you open a support case. 이러한 로그는 시스템 상태 경고가 발생 하는 경우에만 수집 되 고 지원 사례의 컨텍스트에서 Microsoft 지원만 액세스할 수 있습니다.These logs are only collected when a system health alert is raised and are only accessed by Microsoft Support in the context of a support case.

Azure Stack 허브 버전 2008부터, 자동 관리 로그 수집에서는 운영자에 게 표시 되지 않는 오류 조건 중에도 로그를 캡처하는 향상 된 알고리즘을 사용 합니다.Beginning with Azure Stack Hub version 2008, proactive log collection uses an improved algorithm that captures logs even during error conditions that aren’t visible to an operator. 이렇게 하면 운영자 상호 작용 없이 적절 한 시간에 적절 한 진단 정보가 수집 됩니다.This makes sure that the right diagnostic info is collected at the right time without needing any operator interaction. Microsoft 지원에서 문제 해결을 시작 하 고, 경우에 따라 문제를 해결할 수 있습니다.Microsoft support can begin troubleshooting and resolve problems sooner in some cases. 초기 알고리즘 향상은 패치 및 업데이트 작업에 중점을 둡니다.Initial algorithm improvements focus on patch and update operations. 더 많은 작업이 최적화 되 고 이점이 증가 하므로 자동 관리 로그 수집을 사용 하는 것이 좋습니다.Enabling proactive log collections is recommended as more operations are optimized and the benefits increase.

자동 관리 로그 수집을 사용 하지 않도록 설정 하 고 언제 든 지 다시 사용 하도록 설정할 수 있습니다.Proactive log collection can be disabled and re-enabled anytime. 자동 관리 로그 수집을 설정 하려면 다음 단계를 수행 합니다.Follow these steps to set up proactive log collection.

  1. Azure Stack Hub 관리자 포털에 로그인합니다.Sign in to the Azure Stack Hub administrator portal.
  2. 도움말 + 지원 개요 를 엽니다.Open Help + support Overview.
  3. 배너가 표시 되 면 자동 관리 로그 수집 사용 을 선택 합니다.If the banner appears, select Enable proactive log collection. 또는 설정 을 선택 하 고 자동 관리 로그 수집사용 으로 설정 하 고 저장 을 선택할 수 있습니다.Or you can select Settings and set Proactive log collection to Enable, then select Save.

참고

로컬 파일 공유에 대해 로그 위치 설정이 구성 된 경우 수명 주기 관리 정책에 따라 공유 저장소가 크기 할당량에 도달 하지 않도록 해야 합니다.If log location settings are configured for a local file share, make sure lifecycle management policies will prevent share storage from reaching its size quota. Azure Stack 허브는 로컬 파일 공유를 모니터링 하거나 보존 정책을 적용 하지 않습니다.Azure Stack Hub does not monitor local file share or enforce any retention policies.

데이터를 처리 하는 방법How the data is handled

Azure Stack 허브 시스템 상태 경고만 기반으로 Microsoft에서 정기 자동 로그 수집에 동의 합니다.You agree to periodic automatic log collections by Microsoft based only on Azure Stack Hub system health alerts. Microsoft에서 관리 하 고 제어 하는 Azure 저장소 계정에서 해당 로그의 업로드 및 보존에 대 한 승인 및 승인이 승인 됩니다.You also acknowledge and consent to the upload and retention of those logs in an Azure storage account managed and controlled by Microsoft.

데이터는 시스템 상태 경고 문제 해결에만 사용 되며 사용자 동의 없이 마케팅, 광고 또는 기타 상업적 용도로 사용 되지 않습니다.The data will be used only troubleshooting system health alerts and won't be used for marketing, advertising, or any other commercial purposes without your consent. 데이터는 최대 90 일 동안 보존 될 수 있으며 Microsoft에서 수집 하는 데이터는 표준 개인 정보 취급방침에 따라 처리 됩니다.The data can be retained for up to 90 days and any data Microsoft collects will be handled following our standard privacy practices.

사용자의 동의를 통해 이전에 수집 된 모든 데이터는 사용 권한의 해지에 의해 영향을 받지 않습니다.Any data previously collected with your consent won't be affected by the revocation of your permission.

자동 관리 로그 수집 을 사용 하 여 수집 된 로그는 Microsoft에서 관리 하 고 제어 하는 Azure 저장소 계정에 업로드 됩니다.Logs collected using Proactive log collection are uploaded to an Azure storage account managed and controlled by Microsoft. 이러한 로그는 지원 사례의 컨텍스트에서 Microsoft가 액세스 하 고 Azure Stack 허브의 상태를 향상 시킬 수 있습니다.These logs may be accessed by Microsoft in the context of a support case and to improve the health of Azure Stack Hub.

자동 관리 진단 로그 수집 경고Proactive diagnostic log collection alerts

사용 하도록 설정 하면 다음 이벤트 중 하나가 발생할 때 자동 관리 로그 수집에서 로그를 업로드 합니다.If enabled, proactive log collection uploads logs when one of the following events is raised.

예를 들어 업데이트 실패 는 자동 관리 진단 로그 수집을 트리거하는 경고입니다.For example, Update failed is an alert that triggers proactive diagnostic log collection. 사용 하도록 설정 된 경우 문제 해결을 Microsoft 지원 하는 데 도움이 되는 업데이트 오류 동안 진단 로그가 사전에 캡처됩니다.If it's enabled, diagnostic logs are proactively captured during an update failure to help Microsoft Support troubleshoot the problem. 진단 로그는 업데이트 실패 에 대 한 경고가 발생 한 경우에만 수집 됩니다.The diagnostic logs are only collected when the alert for Update failed is raised.

경고 제목Alert title FaultIdTypeFaultIdType
원격 서비스에 연결할 수 없음Unable to connect to the remote service UsageBridge 오류UsageBridge.NetworkError
업데이트 실패Update failed Urp. UpdateFailureUrp.UpdateFailure
저장소 리소스 공급자 인프라/종속성을 사용할 수 없음Storage Resource Provider infrastructure/dependencies not available StorageResourceProviderDependencyUnavailableStorageResourceProviderDependencyUnavailable
노드가 컨트롤러에 연결 되지 않았습니다.Node not connected to controller ServerHostNotConnectedToControllerServerHostNotConnectedToController
경로 게시 실패Route publication failure SlbMuxRoutePublicationFailureSlbMuxRoutePublicationFailure
저장소 리소스 공급자 내부 데이터 저장소를 사용할 수 없음Storage Resource Provider internal data store unavailable StorageResourceProvider.StorageResourceProvider. DataStoreConnectionFailDataStoreConnectionFail
스토리지 디바이스 오류Storage device failure Microsoft.. m y m.Microsoft.Health.FaultType.VirtualDisks.Detached
상태 컨트롤러에서 저장소 계정에 액세스할 수 없음Health controller can't access storage account Microsoft Health. StorageErrorMicrosoft.Health.FaultType.StorageError
실제 디스크에 대 한 연결이 끊어졌습니다.Connectivity to a physical disk has been lost PhysicalDisk. LostCommunication.Microsoft.Health.FaultType.PhysicalDisk.LostCommunication
Blob 서비스가 노드에서 실행 되 고 있지 않습니다.The blob service isn't running on a node StorageService.... a. a. 노드-중요StorageService.The.blob.service.is.not.running.on.a.node-Critical
인프라 역할 비정상Infrastructure role unhealthy Microsoft. 형식. GenericExceptionFaultMicrosoft.Health.FaultType.GenericExceptionFault
Table service 오류Table service errors StorageService-중요StorageService.Table.service.errors-Critical
파일 공유가 80% 활용 됨A file share is over 80% utilized 인프라를 입력 합니다. 경고.Microsoft.Health.FaultType.FileShare.Capacity.Warning.Infra
배율 단위 노드가 오프라인 상태Scale unit node is offline FRP. 하트 비트.FRP.Heartbeat.PhysicalNode
인프라 역할 인스턴스를 사용할 수 없음Infrastructure role instance unavailable FRP. InfraVMFRP.Heartbeat.InfraVM
인프라 역할 인스턴스를 사용할 수 없음Infrastructure role instance unavailable FRP. NonHaVmFRP.Heartbeat.NonHaVm
인프라 역할, 디렉터리 관리에서 시간 동기화 오류를 보고 했습니다.The infrastructure role, Directory Management, has reported time synchronization errors DirectoryServiceTimeSynchronizationErrorDirectoryServiceTimeSynchronizationError
보류 중인 외부 인증서가 만료됨Pending external certificate expiration 인증서 만료. ExternalCert. 경고CertificateExpiration.ExternalCert.Warning
보류 중인 외부 인증서가 만료됨Pending external certificate expiration 인증서 만료. ExternalCert. 중요CertificateExpiration.ExternalCert.Critical
메모리 용량이 부족하여 특정 클래스 및 크기에 대한 가상 머신을 프로비저닝할 수 없음Unable to provision virtual machines for specific class and size due to low memory capacity AzureStack. ComputeController. VmCreationFailure 메모리AzureStack.ComputeController.VmCreationFailure.LowMemory
가상 머신 배치 시 노드에 액세스할 수 없음Node inaccessible for virtual machine placement AzureStack. ComputeController가 응답 하지 않습니다.AzureStack.ComputeController.HostUnresponsive
백업 실패Backup failed AzureStack. Backupfailed일반 오류AzureStack.BackupController.BackupFailedGeneralFault
실패 한 작업과의 충돌로 인해 예약 된 백업을 건너뛰었습니다.The scheduled backup was skipped due to a conflict with failed operations AzureStack. BackupControllerAzureStack.BackupController.BackupSkippedWithFailedOperationFault

지금 로그 보내기Send logs now

지금 로그를 전송 하는 대신 사전에 로그 보내기 를 사용 하 여 시간을 절약 합니다.Save time by using Send logs proactively instead of Send logs now.

이제 로그 보내기는 지원 사례를 열기 전에 Azure Stack 허브에서 진단 로그를 수동으로 수집 하 고 업로드 하는 옵션입니다.Send logs now is an option where you manually collect and upload your diagnostic logs from Azure Stack Hub, usually before opening a support case.

Microsoft 지원에 진단 로그를 수동으로 보낼 수 있는 방법에는 두 가지가 있습니다.There are two ways you can manually send diagnostic logs to Microsoft Support:

Azure Stack 허브가 Azure에 연결 된 경우 로그를 Microsoft에 직접 보내는 가장 간단한 방법 이므로 관리자 포털을 사용 하는 것이 좋습니다.If Azure Stack Hub is connected to Azure, we recommend using the administrator portal because it's the simplest way to send the logs directly to Microsoft. 포털을 사용할 수 없는 경우에는 PowerShell을 사용 하 여 로그를 전송 해야 합니다.If the portal is unavailable, you should instead send logs using PowerShell.

관리자 포털을 사용 하 여 지금 로그 보내기Send logs now with the administrator portal

관리자 포털을 사용 하 여 지금 로그를 보내려면:To send logs now using the administrator portal:

  1. 도움말 + 지원 > 로그 수집 > 지금 로그 보내기 를 엽니다.Open Help + support > Log Collection > Send logs now.
  2. 로그 수집에 대 한 시작 시간 및 종료 시간을 지정 합니다.Specify the start time and end time for log collection.
  3. 현지 표준 시간대를 선택 합니다.Choose the local time zone.
  4. 수집 및 업로드 를 선택 합니다.Select Collect and Upload.

인터넷에서 연결을 끊고 로그를 로컬로 저장 하려는 경우에는 Get AzureStackLog 메서드를 사용 하 여 로그를 보냅니다.If you are disconnected from the internet or want to only save logs locally, use the Get-AzureStackLog method to send logs.

PowerShell을 사용 하 여 지금 로그 보내기Send logs now with PowerShell

지금 Send logs 메서드를 사용 하 고 관리자 포털 대신 PowerShell을 사용 하려는 경우 cmdlet을 사용 하 여 Send-AzureStackDiagnosticLog 특정 로그를 수집 하 고 보낼 수 있습니다.If you're using the Send logs now method and want to use PowerShell instead of the administrator portal, you can use the Send-AzureStackDiagnosticLog cmdlet to collect and send specific logs.

  • FromDateToDate 매개 변수를 사용 하 여 특정 기간 동안 로그를 수집할 수 있습니다.The FromDate and ToDate parameters can be used to collect logs for a particular time period. 이러한 매개 변수를 지정 하지 않으면 기본적으로 지난 4 시간 동안 로그가 수집 됩니다.If these parameters aren't specified, logs are collected for the past four hours by default.

  • 컴퓨터 이름별로 로그를 필터링 하려면 Filterbynode 매개 변수를 사용 합니다.Use the FilterByNode parameter to filter logs by computer name. 예를 들면 다음과 같습니다.For example:

    Send-AzureStackDiagnosticLog -FilterByNode azs-xrp01
    
  • Filterbylogtype 매개 변수를 사용 하 여 유형별로 로그를 필터링 합니다.Use the FilterByLogType parameter to filter logs by type. 파일, 공유 또는 WindowsEvent 필터링 하도록 선택할 수 있습니다.You can choose to filter by File, Share, or WindowsEvent. 예를 들면 다음과 같습니다.For example:

    Send-AzureStackDiagnosticLog -FilterByLogType File
    
  • FilterByResourceProvider 매개 변수를 사용 하 여 RPs (값 추가 리소스 공급자)에 대 한 진단 로그를 보냅니다.Use the FilterByResourceProvider parameter to send diagnostic logs for value-add Resource Providers (RPs). 일반적인 구문은 다음과 같습니다.The general syntax is:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider <<value-add RP name>>
    

    SQL RP에 대 한 진단 로그를 보내려면:To send diagnostic logs for SQL RP:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider SQLAdapter
    

    MySQL RP에 대 한 진단 로그를 보내려면:To send diagnostic logs for MySQL RP:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider MySQLAdapter
    

    IoT Hub에 대 한 진단 로그를 보내려면:To send diagnostic logs for IoT Hub:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider IotHub
    

    Event Hubs에 대 한 진단 로그를 보내려면:To send diagnostic logs for Event Hubs:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider eventhub
    

    Azure Stack Edge에 대 한 진단 로그를 보내려면:To send diagnostic logs for Azure Stack Edge:

    Send-AzureStackDiagnosticLog -FilterByResourceProvide databoxedge
    
  • Filterbyrole 매개 변수를 사용 하 여 VirtualMachines 및 BareMetal 역할에서 진단 로그를 보냅니다.Use the FilterByRole parameter to send diagnostic logs from VirtualMachines and BareMetal roles:

    Send-AzureStackDiagnosticLog -FilterByRole VirtualMachines,BareMetal
    
  • 지난 8 시간 동안 로그 파일에 대 한 날짜 필터링을 사용 하 여 VirtualMachines 및 BareMetal 역할에서 진단 로그를 보내려면 다음을 수행 합니다.To send diagnostic logs from VirtualMachines and BareMetal roles, with date filtering for log files for the past 8 hours:

    Send-AzureStackDiagnosticLog -FilterByRole VirtualMachines,BareMetal -FromDate (Get-Date).AddHours(-8)
    
  • VirtualMachines 및 BareMetal 역할에서 진단 로그를 보내려면 8 시간 전 및 2 시간 전 기간의 로그 파일에 대 한 날짜 필터링을 사용 합니다.To send diagnostic logs from VirtualMachines and BareMetal roles, with date filtering for log files for the time period between 8 hours ago and 2 hours ago:

    Send-AzureStackDiagnosticLog -FilterByRole VirtualMachines,BareMetal -FromDate (Get-Date).AddHours(-8) -ToDate (Get-Date).AddHours(-2)
    

참고

인터넷에서 연결을 끊고 로그를 로컬로 저장 하려는 경우 Get AzureStackLog 메서드를 사용 하 여 로그를 보냅니다.If you are disconnected from the internet or want to only save logs locally, use Get-AzureStackLog method to send logs.

데이터를 처리 하는 방법How the data is handled

Azure Stack Hub에서 진단 로그 수집을 시작 하 여 Microsoft에서 관리 하 고 제어 하는 Azure storage 계정에 로그를 업로드 하 고 업로드 하는 것을 승인 하 고 동의 합니다.By initiating diagnostic log collection from Azure Stack Hub, you acknowledge and consent to uploading those logs and retaining them in an Azure storage account managed and controlled by Microsoft. 로그 수집을 위해 고객에 게 참여 하지 않고도 지원 사례를 사용 하 여 이러한 로그에 즉시 액세스할 수 Microsoft 지원.Microsoft Support can access these logs right away with the support case without having to engage with the customer for log collection.

로컬에 로그 저장Save logs locally

Azure에서 Azure Stack 허브의 연결이 끊어질 때 로컬 SMB (서버 메시지 블록) 공유에 로그를 저장할 수 있습니다.You can save logs to a local Server Message Block (SMB) share when Azure Stack Hub is disconnected from Azure. 설정 블레이드에서 공유에 대 한 쓰기 권한이 있는 경로와 사용자 이름 및 암호를 입력 합니다.In the Settings blade, enter the path and a username and password with permission to write to the share. 지원 사례 중 Microsoft 지원은 이러한 로컬 로그를 전송 하는 방법에 대 한 자세한 단계를 제공 합니다.During a support case, Microsoft Support will provide detailed steps on how to get these local logs transferred. 관리자 포털을 사용할 수 없는 경우 Get AzureStackLog 를 사용 하 여 로컬에 로그를 저장할 수 있습니다.If the Administrator portal is unavailable, you can use Get-AzureStackLog to save logs locally.

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

대역폭 고려 사항Bandwidth considerations

진단 로그 수집의 평균 크기는 사전에 또는 수동으로 실행 되는지에 따라 달라 집니다.The average size of diagnostic log collection varies based on whether it runs proactively or manually. 자동 관리 로그 수집 의 평균 크기는 약 2gb입니다.The average size for Proactive log collection is around 2 GB. 이제 전송 로그 의 컬렉션 크기가 수집 되는 시간에 따라 달라 집니다.The collection size for Send logs now depends on how many hours are being collected.

다음 표에는 Azure에 대 한 제한 된 또는 요금제 연결이 있는 환경에 대 한 고려 사항이 나와 있습니다.The following table lists considerations for environments with limited or metered connections to Azure.

네트워크 연결Network connection 영향Impact
낮은 대역폭/대기 시간이 긴 연결Low-bandwidth/high-latency connection 로그 업로드를 완료 하는 데 오랜 시간이 걸립니다.Log upload will take an extended amount of time to complete.
공유 연결Shared connection 또한 업로드는 네트워크 연결을 공유 하는 다른 앱/사용자에 게 영향을 줄 수 있습니다.The upload may also impact other apps/users sharing the network connection.
요금제 연결Metered connection 추가 네트워크 사용량에 대 한 ISP의 추가 요금이 있을 수 있습니다.There may be an additional charge from your ISP for the extra network usage.

로그 수집 보기View log collection

Azure Stack 허브에서 수집 된 로그 기록은 도움말 + 지원로그 수집 페이지에서 다음 날짜 및 시간으로 표시 됩니다.The history of logs collected from Azure Stack Hub appears on the Log collection page in Help + support, with the following dates and times:

  • 수집 된 시간: 로그 수집 작업이 시작 된 시간입니다.Time Collected: When the log collection operation began.
  • 상태: 진행 중 또는 완료 중입니다.Status: Either in progress or complete.
  • 로그 시작: 수집 하려는 기간의 시작 시간입니다.Logs start: Start of the time period for which you want to collect.
  • 로그 끝: 기간의 끝입니다.Logs end: End of the time period.
  • 형식: 수동 또는 자동 로그 컬렉션인 경우입니다.Type: If it's a manual or proactive log collection.

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

참조See also

Azure Stack 허브 로그 및 고객 데이터 처리Azure Stack Hub log and customer data handling