Coleta de log de diagnósticoDiagnostic log collection

Azure Stack Hub é uma coleção de componentes do Windows e serviços do Azure locais interagindo entre si.Azure Stack Hub is a collection of both Windows components and on-premises Azure services interacting with each other. Todos esses componentes e serviços geram seu próprio conjunto de logs.All these components and services generate their own set of logs. Como Suporte da Microsoft usa esses logs para identificar e corrigir seus problemas, oferecemos coleta de logs de diagnóstico.Since Microsoft Support uses these logs to identify and fix your issues, we offer diagnostic log collection. A coleta de log de diagnóstico ajuda você a coletar e compartilhar rapidamente os logs de diagnóstico com o Suporte da Microsoft.Diagnostic log collection helps you quickly collect and share diagnostic logs with Microsoft Support.

Importante

Você precisa registrar Azure Stack Hub para usar a coleta de log de diagnóstico.You have to register Azure Stack Hub to use diagnostic log collection. Se você ainda não registrou Azure Stack Hub, use o ponto de extremidade privilegiado (PEP) para compartilhar logs.If you haven't registered Azure Stack Hub, use the privileged endpoint (PEP) to share logs.

Azure Stack Hub tem várias maneiras de coletar, salvar e enviar logs de diagnóstico para Suporte da Microsoft.Azure Stack Hub has multiple ways to collect, save, and send diagnostic logs to Microsoft Support. Dependendo da conectividade com o Azure, as opções para coletar e enviar logs são:Depending on connectivity to Azure, your options for collecting and sending logs are:

O fluxograma abaixo mostra qual opção usar para enviar logs de diagnóstico em cada caso.The flowchart below shows which option to use for sending diagnostic logs in each case. Se Azure Stack Hub puder se conectar ao Azure, é recomendável habilitar a coleta de logs proativo , que carregará automaticamente os logs de diagnóstico para um blob de armazenamento controlado pela Microsoft no Azure quando um alerta crítico for gerado.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. Como alternativa, você pode coletar logs sob demanda usando enviar logs agora.You can alternatively collect logs on-demand by using Send logs now. Se Azure Stack Hub estiver desconectado do Azure, você poderá salvar os logs localmente.If Azure Stack Hub is disconnected from Azure, you can Save logs locally.

O fluxograma mostra como enviar logs agora para a Microsoft

Enviar logs proativamenteSend logs proactively

A coleta proativa de logs coleta e envia automaticamente os logs de diagnóstico do Hub Azure Stack para a Microsoft antes de você abrir um caso de suporte.Proactive log collection automatically collects and sends diagnostic logs from Azure Stack Hub to Microsoft before you open a support case. Esses logs são coletados apenas quando um alerta de integridade do sistema é gerado e são acessados somente por suporte da Microsoft no contexto de um caso de suporte.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.

A coleta proativa de logs pode ser desabilitada e reabilitada a qualquer momento.Proactive log collection can be disabled and re-enabled anytime. Siga estas etapas para configurar a coleta de logs proativo.Follow these steps to set up proactive log collection.

  1. Entre no portal do administrador do Azure Stack Hub.Sign in to the Azure Stack Hub administrator portal.
  2. Abra a ajuda + visão geral de suporte.Open Help + support Overview.
  3. Se a faixa for exibida, selecione habilitar coleta de log proativo.If the banner appears, select Enable proactive log collection. Ou você pode selecionar configurações e definir a coleção de logs proativo para habilitar e, em seguida, selecionar salvar.Or you can select Settings and set Proactive log collection to Enable , then select Save.

Observação

Se as configurações de local do log estiverem configuradas para um compartilhamento de arquivos local, verifique se as políticas de gerenciamento do ciclo de vida impedirão que o compartilhamento atinja sua cota de tamanho.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 Hub não monitora o compartilhamento de arquivos local nem impõe nenhuma política de retenção.Azure Stack Hub does not monitor local file share or enforce any retention policies.

Como os dados são manipuladosHow the data is handled

Você concorda em coleções de logs automáticas periódicas pela Microsoft com base apenas em alertas de integridade do sistema do Hub Azure Stack.You agree to periodic automatic log collections by Microsoft based only on Azure Stack Hub system health alerts. Você também reconhece e concorda com o upload e a retenção desses logs em uma conta de armazenamento do Azure gerenciada e controlada pela Microsoft.You also acknowledge and consent to the upload and retention of those logs in an Azure storage account managed and controlled by Microsoft.

Os dados serão usados apenas para solucionar problemas de alertas de integridade do sistema e não serão usados para marketing, propaganda ou outras finalidades comerciais sem o seu consentimento.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. Os dados podem ser retidos por até 90 dias e os dados que a Microsoft coletas serão tratados seguindo nossas práticas de privacidade padrão.The data can be retained for up to 90 days and any data Microsoft collects will be handled following our standard privacy practices.

Todos os dados coletados anteriormente com seu consentimento não serão afetados pela revogação da sua permissão.Any data previously collected with your consent won't be affected by the revocation of your permission.

Os logs coletados usando a coleção de logs proativo são carregados para uma conta de armazenamento do Azure gerenciada e controlada pela Microsoft.Logs collected using Proactive log collection are uploaded to an Azure storage account managed and controlled by Microsoft. Esses logs podem ser acessados pela Microsoft no contexto de um caso de suporte e para melhorar a integridade do hub de 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.

Enviar logs agoraSend logs now

Dica

Economize tempo usando logs de envio proativamente em vez de enviar logs agora.Save time by using Send logs proactively instead of Send logs now.

Enviar logs agora é uma opção na qual você coleta e carrega manualmente os logs de diagnóstico do Azure Stack Hub, geralmente antes de abrir um caso de suporte.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.

Há duas maneiras pelas quais você pode enviar logs de diagnóstico manualmente para Suporte da Microsoft:There are two ways you can manually send diagnostic logs to Microsoft Support:

Se Azure Stack Hub estiver conectado ao Azure, é recomendável usar o portal do administrador, pois é a maneira mais simples de enviar os logs diretamente para a 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. Se o portal não estiver disponível, em vez disso, você deverá enviar logs usando o PowerShell.If the portal is unavailable, you should instead send logs using PowerShell.

Enviar logs agora com o portal do administradorSend logs now with the administrator portal

Para enviar logs agora usando o portal do administrador:To send logs now using the administrator portal:

  1. Abra ajuda + suporte > coleção de logs > enviar logs agora.Open Help + support > Log Collection > Send logs now.
  2. Especifique a hora de início e a hora de término para a coleta de log.Specify the start time and end time for log collection.
  3. Escolha o fuso horário local.Choose the local time zone.
  4. Selecione coletar e carregar.Select Collect and Upload.

Se você estiver desconectado da Internet ou quiser salvar apenas os logs localmente, use o método Get-AzureStackLog para enviar logs.If you are disconnected from the internet or want to only save logs locally, use the Get-AzureStackLog method to send logs.

Enviar logs agora com o PowerShellSend logs now with PowerShell

Se você estiver usando o método enviar logs agora e quiser usar o PowerShell em vez do portal do administrador, poderá usar o Send-AzureStackDiagnosticLog cmdlet para coletar e enviar logs específicos.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.

  • Os parâmetros FromDate e ToDate podem ser usados para coletar logs por um período de tempo específico.The FromDate and ToDate parameters can be used to collect logs for a particular time period. Se esses parâmetros não forem especificados, os logs serão coletados nas últimas quatro horas por padrão.If these parameters aren't specified, logs are collected for the past four hours by default.

  • Use o parâmetro FilterByNode para filtrar os logs por nome do computador.Use the FilterByNode parameter to filter logs by computer name. Por exemplo:For example:

    Send-AzureStackDiagnosticLog -FilterByNode azs-xrp01
    
  • Use o parâmetro FilterByLogType para filtrar logs por tipo.Use the FilterByLogType parameter to filter logs by type. Você pode optar por filtrar por arquivo, compartilhamento ou WindowsEvent.You can choose to filter by File, Share, or WindowsEvent. Por exemplo:For example:

    Send-AzureStackDiagnosticLog -FilterByLogType File
    
  • Use o parâmetro FilterByResourceProvider para enviar logs de diagnóstico para os provedores de recursos de agregação de valor (RPS).Use the FilterByResourceProvider parameter to send diagnostic logs for value-add Resource Providers (RPs). A sintaxe geral é:The general syntax is:

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

    Para enviar logs de diagnóstico para o Hub IoT:To send diagnostic logs for IoT Hub:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider IotHub
    

    Para enviar logs de diagnóstico para hubs de eventos:To send diagnostic logs for Event Hubs:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider eventhub
    

    Para enviar logs de diagnóstico para Azure Stack Edge:To send diagnostic logs for Azure Stack Edge:

    Send-AzureStackDiagnosticLog -FilterByResourceProvide databoxedge
    
  • Use o parâmetro FilterByRole para enviar logs de diagnóstico das funções VirtualMachines e BareMetal:Use the FilterByRole parameter to send diagnostic logs from VirtualMachines and BareMetal roles:

    Send-AzureStackDiagnosticLog -FilterByRole VirtualMachines,BareMetal
    
  • Para enviar logs de diagnóstico de funções VirtualMachines e BareMetal, com filtragem de data para os arquivos de log das últimas 8 horas: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)
    
  • Para enviar logs de diagnóstico de funções VirtualMachines e BareMetal, com filtragem de data para arquivos de log para o período de tempo entre 8 horas atrás e 2 horas atrás: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)
    

Observação

Se você estiver desconectado da Internet ou quiser salvar apenas os logs localmente, use o método Get-AzureStackLog para enviar logs.If you are disconnected from the internet or want to only save logs locally, use Get-AzureStackLog method to send logs.

Como os dados são manipuladosHow the data is handled

Ao iniciar a coleta de log de diagnóstico do Hub Azure Stack, você reconhece e concorda em carregar esses logs e mantê-los em uma conta de armazenamento do Azure gerenciada e controlada pela Microsoft.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. Suporte da Microsoft pode acessar esses logs imediatamente com o caso de suporte sem precisar se envolver com o cliente para coleta de logs.Microsoft Support can access these logs right away with the support case without having to engage with the customer for log collection.

Salvar logs localmenteSave logs locally

Você pode salvar os logs em um compartilhamento de protocolo SMB local quando Azure Stack Hub é desconectado do Azure.You can save logs to a local Server Message Block (SMB) share when Azure Stack Hub is disconnected from Azure. Na folha configurações , insira o caminho e um nome de usuário e senha com permissão para gravar no compartilhamento.In the Settings blade, enter the path and a username and password with permission to write to the share. Durante um caso de suporte, Suporte da Microsoft fornecerá etapas detalhadas sobre como obter esses logs locais transferidos.During a support case, Microsoft Support will provide detailed steps on how to get these local logs transferred. Se o portal do administrador não estiver disponível, você poderá usar Get-AzureStackLog para salvar os logs localmente.If the Administrator portal is unavailable, you can use Get-AzureStackLog to save logs locally.

Captura de tela das opções de coleta de log de diagnóstico

Considerações sobre largura de bandaBandwidth considerations

O tamanho médio da coleta de log de diagnóstico varia de acordo com a execução de forma proativa ou manual.The average size of diagnostic log collection varies based on whether it runs proactively or manually. O tamanho médio da coleta de log proativo é de cerca de 2 GB.The average size for Proactive log collection is around 2 GB. O tamanho da coleção para enviar logs agora depende de quantas horas estão sendo coletadas.The collection size for Send logs now depends on how many hours are being collected.

A tabela a seguir lista as considerações para ambientes com conexões limitadas ou métricas para o Azure.The following table lists considerations for environments with limited or metered connections to Azure.

Conexão de redeNetwork connection ImpactoImpact
Baixa largura de banda/conexão de alta latênciaLow-bandwidth/high-latency connection O carregamento de log levará um longo período de tempo para ser concluído.Log upload will take an extended amount of time to complete.
Conexão compartilhadaShared connection O upload também pode afetar outros aplicativos/usuários que compartilham a conexão de rede.The upload may also impact other apps/users sharing the network connection.
Conexão limitadaMetered connection Pode haver um custo adicional de seu ISP para o uso extra da rede.There may be an additional charge from your ISP for the extra network usage.

Exibir coleção de logsView log collection

O histórico de logs coletados do hub de Azure Stack aparece na página de coleta de log em ajuda + suporte , com as seguintes datas e horários:The history of logs collected from Azure Stack Hub appears on the Log collection page in Help + support , with the following dates and times:

  • Hora coletada : quando a operação de coleta de log foi iniciada.Time Collected : When the log collection operation began.
  • Status : em andamento ou concluído.Status : Either in progress or complete.
  • Início dos logs : início do período de tempo para o qual você deseja coletar.Logs start : Start of the time period for which you want to collect.
  • Término dos logs : fim do período de tempo.Logs end : End of the time period.
  • Tipo : se for uma coleção de logs manual ou proativa.Type : If it's a manual or proactive log collection.

Coleções de log em ajuda + suporte

Alertas de coleta de log de diagnóstico proativoProactive diagnostic log collection alerts

Se habilitada, a coleta de log proativo carregará os logs somente quando um dos eventos a seguir for gerado.If enabled, proactive log collection uploads logs only when one of the following events is raised.

Por exemplo, a atualização falhou é um alerta que dispara a coleta de log de diagnóstico proativo.For example, Update failed is an alert that triggers proactive diagnostic log collection. Se estiver habilitado, os logs de diagnóstico serão capturados proativamente durante uma falha de atualização para ajudar a Suporte da Microsoft a solucionar o problema.If it's enabled, diagnostic logs are proactively captured during an update failure to help Microsoft Support troubleshoot the problem. Os logs de diagnóstico são coletados apenas quando o alerta de atualização falha é gerado.The diagnostic logs are only collected when the alert for Update failed is raised.

Título do alertaAlert title FaultIdTypeFaultIdType
Não é possível se conectar ao serviço remotoUnable to connect to the remote service UsageBridge. NetworkErrorUsageBridge.NetworkError
Falha na atualizaçãoUpdate failed Urp.UpdateFailureUrp.UpdateFailure
Infraestrutura/dependências do provedor de recursos de armazenamento não disponíveisStorage Resource Provider infrastructure/dependencies not available StorageResourceProviderDependencyUnavailableStorageResourceProviderDependencyUnavailable
Nó não conectado ao controladorNode not connected to controller ServerHostNotConnectedToControllerServerHostNotConnectedToController
Falha na publicação da rotaRoute publication failure SlbMuxRoutePublicationFailureSlbMuxRoutePublicationFailure
Armazenamento de dados interno do provedor de recursos de armazenamento não disponívelStorage Resource Provider internal data store unavailable StorageResourceProvider.StorageResourceProvider. DataStoreConnectionFailDataStoreConnectionFail
Falha do dispositivo de armazenamentoStorage device failure Microsoft. Health. FaultType. VirtualDisks. desanexadoMicrosoft.Health.FaultType.VirtualDisks.Detached
O controlador de integridade não pode acessar a conta de armazenamentoHealth controller can't access storage account Microsoft. Health. FaultType. StorageErrorMicrosoft.Health.FaultType.StorageError
A conectividade com um disco físico foi perdidaConnectivity to a physical disk has been lost Microsoft. Health. FaultType. PhysicalDisk. LostCommunicationMicrosoft.Health.FaultType.PhysicalDisk.LostCommunication
O serviço BLOB não está sendo executado em um nóThe blob service isn't running on a node StorageService. o. blob. Service. is. not. running. on. a. nó-críticoStorageService.The.blob.service.is.not.running.on.a.node-Critical
Função de infraestrutura não íntegraInfrastructure role unhealthy Microsoft. Health. FaultType. GenericExceptionFaultMicrosoft.Health.FaultType.GenericExceptionFault
Erros do serviço TabelaTable service errors StorageService. Table. Service. Errors-CriticalStorageService.Table.service.errors-Critical
Um compartilhamento de arquivos está acima de 80% utilizadoA file share is over 80% utilized Microsoft. Health. FaultType. FileShare. Capacity. Warning. infraMicrosoft.Health.FaultType.FileShare.Capacity.Warning.Infra
O nó da unidade de escala está offlineScale unit node is offline FRP. Pulsação. PhysicalNodeFRP.Heartbeat.PhysicalNode
Instância de função de infraestrutura indisponívelInfrastructure role instance unavailable FRP. Pulsação. InfraVMFRP.Heartbeat.InfraVM
Instância de função de infraestrutura indisponívelInfrastructure role instance unavailable FRP. Pulsação. NonHaVmFRP.Heartbeat.NonHaVm
A função de infraestrutura, gerenciamento de diretório, relatou erros de sincronização de horárioThe infrastructure role, Directory Management, has reported time synchronization errors DirectoryServiceTimeSynchronizationErrorDirectoryServiceTimeSynchronizationError
Validade pendente do certificado externoPending external certificate expiration CertificateExpiration. ExternalCert. WarningCertificateExpiration.ExternalCert.Warning
Validade pendente do certificado externoPending external certificate expiration CertificateExpiration. ExternalCert. CriticalCertificateExpiration.ExternalCert.Critical
Não é possível provisionar máquinas virtuais para a classe e o tamanho específicos devido à baixa capacidade de memóriaUnable to provision virtual machines for specific class and size due to low memory capacity AzureStack. ComputeController. VmCreationFailure. LowMemoryAzureStack.ComputeController.VmCreationFailure.LowMemory
Nó inacessível para o posicionamento da máquina virtualNode inaccessible for virtual machine placement AzureStack. ComputeController. HostUnresponsiveAzureStack.ComputeController.HostUnresponsive
Falha no backupBackup failed AzureStack. BackupController. BackupFailedGeneralFaultAzureStack.BackupController.BackupFailedGeneralFault
O backup agendado foi ignorado devido a um conflito com operações com falhaThe scheduled backup was skipped due to a conflict with failed operations AzureStack. BackupController. BackupSkippedWithFailedOperationFaultAzureStack.BackupController.BackupSkippedWithFailedOperationFault

Confira tambémSee also

Log do hub de Azure Stack e tratamento de dados do clienteAzure Stack Hub log and customer data handling