Partilhar via


Coleta de log de diagnóstico

Você pode compartilhar logs de diagnóstico criados pelo Azure Stack Hub. Os componentes do Windows e os serviços locais do Azure criam esses logs. O suporte da Microsoft pode usar os logs para corrigir ou identificar problemas com sua instância do Azure Stack Hub.

Para começar a usar a coleta de logs de diagnóstico do Azure Stack Hub, você precisa registrar sua instância. Se você não registrou o Azure Stack Hub, use o ponto de extremidade privilegiado (PEP) para compartilhar logs.

Você tem várias maneiras de enviar logs de diagnóstico para o suporte da Microsoft. Dependendo da sua conectividade com o Azure, as suas opções incluem:

A coleta proativa de logs carrega automaticamente os logs de diagnóstico em um blob de armazenamento controlado pela Microsoft no Azure quando um alerta crítico é gerado. Você também pode coletar logs sob demanda usando Enviar logs agora. Para um Azure Stack Hub que funciona num ambiente desconectado ou se estiver a ter problemas de conectividade, opte por Salvar logs localmente.

Enviar registos de forma proativa

A coleção de logs proativa recolhe e envia automaticamente logs de diagnóstico do Azure Stack Hub para a Microsoft antes de abrir um pedido de suporte. Esses logs só são coletados quando um alerta de integridade do sistema é gerado, e o suporte da Microsoft só acessa esses logs no contexto de um caso de suporte.

A partir do Azure Stack Hub versão 2008, a coleta proativa de logs usa um algoritmo aprimorado para capturar logs mesmo durante condições de erro que não são visíveis para um operador. Essa melhoria ajuda a garantir que as informações de diagnóstico corretas sejam coletadas no momento certo, sem a necessidade de qualquer interação do operador. O suporte da Microsoft pode começar a solucionar problemas e resolver problemas mais cedo em alguns casos. As melhorias iniciais do algoritmo concentram-se em operações de correção e atualização.

Quando um evento dispara esses alertas, o Azure Stack Hub envia proativamente os logs para a Microsoft. Além disso, o Azure Stack Hub envia logs para a Microsoft que são acionados por outros eventos de falha. Esses eventos não são visíveis para o operador.

É altamente recomendável habilitar a coleta proativa de logs. Permite à equipa de produto diagnosticar problemas em virtude de eventos de falha e melhorar a qualidade do produto.

Observação

Se a coleta de logs proativa estiver habilitada e se renovar ou alterar o seu registro do Azure Stack Hub, conforme descrito em Renovar ou alterar registro, deve ativar novamente a coleta de logs proativa.

O Azure Stack Hub coleta proativamente logs para:

Alert Tipo de ID de falha
Atualização precisa de atenção Urp.UpdateWarning
Falha na atualização Urp.UpdateFailure
Alert Tipo de ID de falha
Corrupção de dados do servidor de tabela StorageService.Table.server.data.corruption-Crítico
Nó inacessível para posicionamento de máquina virtual AzureStack.ComputeController.HostUnresponsive
Os dados do serviço de blob estão corrompidos StorageService.Blob.service.data.is.corrupted-Crítico
Corrupção de dados de conta e serviço de contêiner StorageService.Account.e.Container.Service.corrupção.de.dados-Crítico

A partir do Azure Stack Hub versão 2108, se a coleta proativa de logs estiver desabilitada, os logs serão capturados e armazenados localmente para eventos de falha proativa. A Microsoft só acessa os logs locais no contexto de um caso de suporte.

A coleta proativa de logs pode ser desabilitada e reativada a qualquer momento. Siga estas etapas para configurar a coleta proativa de logs.

  1. Entre no portal do administrador do Azure Stack Hub.
  2. Abra a Visão geral da Ajuda + suporte.
  3. Se o banner aparecer, selecione Ativar recolha proativa de logs. Ou você pode selecionar Configurações e definir Coleta de log proativa como Habilitar e, em seguida, selecionar Salvar.

Observação

Se as definições de local do registo estiverem configuradas para uma partilha de ficheiros local, assegure-se de que as políticas de gestão do ciclo de vida impeçam que o armazenamento da partilha atinja o seu limite do tamanho. O Azure Stack Hub não monitoriza a partilha de ficheiros local nem impõe quaisquer políticas de retenção.

Como os dados são tratados

Você concorda com coletas automáticas periódicas de logs pela Microsoft com base apenas em alertas de integridade do sistema do Azure Stack Hub. Você também reconhece e concorda com o carregamento e a retenção desses logs em uma conta de armazenamento do Azure gerenciada e controlada pela Microsoft.

Os dados são usados para solucionar problemas de alertas de integridade do sistema e não são usados para fins de marketing, publicidade ou quaisquer outros fins comerciais sem o seu consentimento. Os dados podem ser retidos por até 90 dias e a Microsoft lida com quaisquer dados coletados seguindo nossas práticas de privacidade padrão.

A revogação da sua permissão não afeta quaisquer dados previamente recolhidos com o seu consentimento.

Os logs coletados usando a coleta proativa de logs são carregados em uma conta de armazenamento do Azure gerenciada e controlada pela Microsoft. A Microsoft pode acessar esses logs no contexto de um caso de suporte e para melhorar a integridade do Azure Stack Hub.

Enviar registos agora

Sugestão

Poupe tempo usando Enviar logs proativamente em vez de Enviar logs agora.

Enviar logs agora é uma opção em que você coleta e carrega manualmente seus logs de diagnóstico do Azure Stack Hub, geralmente antes de abrir um caso de suporte.

Há duas maneiras de enviar manualmente os logs de diagnóstico para o Suporte da Microsoft:

Observação

Se você enviar logs usando o portal do administrador ou o cmdlet do PowerShell, o Test-AzureStack será executado automaticamente em segundo plano para coletar informações de diagnóstico.

Enviar logs agora com o PowerShell

Se você estiver usando o método Send logs now , poderá usar o Send-AzureStackDiagnosticLog cmdlet para coletar e enviar logs específicos.

  • Os parâmetros FromDate e ToDate podem ser usados para coletar logs para um período de tempo específico. Se esses parâmetros não forem especificados, os logs serão coletados nas últimas quatro horas por padrão.

  • Use o FilterByNode parâmetro para filtrar logs por nome do computador. Por exemplo:

    Send-AzureStackDiagnosticLog -FilterByNode azs-xrp01
    
  • Use o FilterByLogType parâmetro para filtrar logs por tipo. Você pode optar por filtrar por Arquivo, Compartilhamento ou WindowsEvent. Por exemplo:

    Send-AzureStackDiagnosticLog -FilterByLogType File
    
  • Use o parâmetro FilterByResourceProvider para enviar logs de diagnóstico para Provedores de Recursos (RPs) de valor acrescentado. A sintaxe geral é:

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

    Para enviar logs de diagnóstico para SQL RP:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider SQLAdapter
    

    Para enviar logs de diagnóstico para o MySQL RP:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider MySQLAdapter
    

    Para enviar logs de diagnóstico para Hubs de Eventos:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider eventhub
    

    Para enviar logs de diagnóstico para o Azure Stack Edge:

    Send-AzureStackDiagnosticLog -FilterByResourceProvide databoxedge
    
  • Use o parâmetro FilterByRole para enviar logs de diagnóstico das funções de Máquinas Virtuais e Bare Metal:

    Send-AzureStackDiagnosticLog -FilterByRole VirtualMachines,BareMetal
    
  • Para enviar logs de diagnóstico de funções VirtualMachines e BareMetal, com filtragem de data para arquivos de log das últimas 8 horas:

    $fromDate = (Get-Date).AddHours(-8)
    Invoke-Command -Session $pepsession -ScriptBlock {Send-AzureStackDiagnosticLog -FilterByRole VirtualMachines,BareMetal -FromDate $using:fromDate}
    
  • 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:

    $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}
    

Observação

Se você estiver desconectado da Internet ou quiser salvar apenas logs localmente, use o comando Get-AzureStackLog para enviar logs.

Envie logs agora com o portal do administrador

Para enviar logs agora usando o portal do administrador:

  1. Abra Ajuda + suporte > Coleção > de logs Envie logs agora.
  2. Escolha o fuso horário local.
  3. Selecione Coletar e Carregar.

Importante

Não é possível especificar um intervalo de tempo ou filtrar logs ao usar o portal do administrador. Por padrão, os logs são coletados nas últimas quatro horas.

Se você estiver desconectado da Internet ou quiser salvar apenas logs localmente, use o método Get-AzureStackLog para enviar logs.

Como os dados são tratados

Ao iniciar a coleta de logs de diagnóstico do Azure Stack Hub, você reconhece e consente em carregar esses logs e retê-los em uma conta de armazenamento do Azure gerenciada e controlada pela Microsoft. O suporte da Microsoft pode aceder a esses logs imediatamente juntamente com o caso de suporte, sem ter que interagir com o cliente para a recolha de logs.

Guardar logs localmente

Pode guardar registos numa partilha local SMB (Server Message Block) quando o Azure Stack Hub estiver desconectado do Azure. Você pode, por exemplo, executar um ambiente desconectado. Se estiver normalmente ligado, mas tiver problemas de conectividade, pode guardar os registos localmente para ajudar na resolução de problemas.

Na folha Configurações, insira o caminho e um nome de utilizador e senha com permissão para gravar na partilha. Durante um caso de suporte, o suporte da Microsoft trabalha para fornecer etapas detalhadas sobre como transferir esses logs locais. Se o portal do administrador não estiver disponível, você poderá usar Get-AzureStackLog para salvar logs localmente.

Captura de ecrã das opções de recolha de registos de diagnóstico

Considerações de largura de banda

O tamanho médio da coleta de log de diagnóstico varia consoante se é executada de forma proativa ou manual. O tamanho médio da coleta proativa de logs é de cerca de 2 GB. O tamanho da coleção para logs de envio agora depende de quantas horas (até 4 horas) estão a ser recolhidas e do número de nós físicos na unidade de escala do Azure Stack Hub (de 4 a 16 nós).

A tabela a seguir lista considerações para ambientes com conexões limitadas ou medidas para o Azure.

Conexão de rede Impacto
Conexão de baixa largura de banda/alta latência O carregamento de logs leva muito tempo para ser concluído.
Conexão compartilhada O carregamento também pode afetar outras aplicações/utilizadores que partilham a ligação de rede.
Ligação medida Pode haver outra cobrança do seu ISP pelo uso extra da rede.

Por exemplo, se a ligação à Internet ou a velocidade do link do Azure Stack Hub for de 5 Megabits por segundo (baixa largura de banda), levará aproximadamente 57 minutos para carregar 2 GB de dados de log de diagnóstico para o suporte da Microsoft. Para uma recolha manual de registos de 8 GB utilizando uma velocidade de ligação de 5 Megabits/segundo, demora aproximadamente 3 horas e 49 minutos a carregar os dados. Esse longo período de tempo para carregar dados de diagnóstico pode atrasar ou afetar a experiência de suporte.

Ver coleção de logs

O histórico de logs coletados do Azure Stack Hub aparece na página de coleta de logs na Ajuda + suporte no portal, com as seguintes datas e horas:

  • Tempo coletado: quando a operação de coleta de log começou.
  • Estado: Em curso ou concluído.
  • Início dos logs: Início do período de tempo para o qual você deseja coletar.
  • Fim dos registos: Término do período.
  • Tipo: Se for uma recolha de registos manual ou proactiva.

Registrar coleções na Ajuda + suporte

Próximos passos

Log do Azure Stack Hub e tratamento de dados do cliente