Coleta de log de diagnóstico

Você pode compartilhar logs de diagnóstico criados por Azure Stack Hub. Esses logs são criados pelos componentes Windows e serviços locais do Azure. Suporte da Microsoft pode usar os logs para corrigir ou identificar problemas com sua Azure Stack Hub instância.

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

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

O fluxograma mostra qual opção usar para enviar logs de diagnóstico. Se Azure Stack Hub se conectar ao Azure, habilita a coleta de log proativa. A coleta proativa de logs carrega automaticamente os logs de diagnóstico para 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 executado em um ambiente desconectado ou se você estiver tendo problemas de conectividade, escolha Salvar logs localmente.

Flowchart shows how to send logs now to Microsoft

Enviar logs proativamente

A coleta proativa de logs coleta e envia automaticamente logs de diagnóstico do Azure Stack Hub para a Microsoft antes de abrir um caso de suporte. Esses logs são coletados somente quando um alerta de saúde do sistema é gerado e são acessados somente por Suporte da Microsoft no contexto de um caso de suporte.

A partir Azure Stack Hub versão 2008, a coleta de logs proativo usa um algoritmo aprimorado que captura logs mesmo durante condições de erro que não são visíveis para um operador. Isso garante que as informações de diagnóstico corretas são coletadas no momento certo sem a necessidade de nenhuma 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 se concentram nas operações de atualização e patch.

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

Habilenciar a coleta de log proativa é altamente recomendável. Ele permite que a equipe do produto dia diagnosticar problemas devido a eventos de falha e melhorar a qualidade do produto.

Azure Stack Hub coleta logs proativamente para:

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

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

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

  1. Entre no portal do administrador do Azure Stack Hub.
  2. Abra Ajuda + Visão geral do suporte.
  3. Se a faixa for exibida, selecione Habilitar coleta de log proativa. Ou você pode selecionar Configurações coleção de logproativa como Habilitare, em seguida, selecionar Salvar.

Observação

Se as configurações de local de log estão configuradas para um compartilhamento de arquivos local, certifique-se de que as políticas de gerenciamento do ciclo de vida impedirão que o armazenamento de compartilhamento atinja sua cota de tamanho. Azure Stack Hub monitora o compartilhamento de arquivos local ou impõe políticas de retenção.

Como os dados são tratados

Você concorda com coleções de log automáticas periódicas da Microsoft com base apenas Azure Stack Hub de saúde do sistema. Você também reconhece e consente com o upload e a retenção desses logs em uma conta de armazenamento do Azure gerenciada e controlada pela Microsoft.

Os dados serão usados apenas para solucionar problemas de alertas de saúde do sistema e não serão usados para marketing, publicidade ou qualquer outra finalidade comercial sem seu consentimento. Os dados podem ser retidos por até 90 dias e todos os dados coletados pela Microsoft serão tratados seguindo nossas práticas de privacidade padrão.

Todos os dados coletados anteriormente com seu consentimento não serão afetados pela revogação de sua permissão.

Os logs coletados usando a coleta de logs proativos são carregados em uma conta de armazenamento do Azure gerenciada e controlada pela Microsoft. Esses logs podem ser acessados pela Microsoft no contexto de um caso de suporte e para melhorar a Azure Stack Hub.

Enviar logs agora

Dica

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

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

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

Se Azure Stack Hub estiver conectado ao Azure, recomendamos usar o portal do administrador porque é a maneira mais simples de enviar os logs diretamente para a Microsoft. Se o portal não estiver disponível, você deverá enviar logs usando o PowerShell.

Observação

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

Enviar logs agora com o portal do administrador

Para enviar logs agora usando o portal do administrador:

  1. Abra Ajuda + suporte Logs de envio de coleta de logs > agora.
  2. Especifique a hora de início e a hora de término da coleta de log.
  3. Escolha o fuso horário local.
  4. Selecione Coletar e Upload.

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

Enviar logs agora com o 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 cmdlet para coletar e enviar logs específicos.

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

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

    Send-AzureStackDiagnosticLog -FilterByNode azs-xrp01
    
  • Use o parâmetro FilterByLogType 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 RPs (provedores de recursos) de valor agregado. 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 RP do MySQL:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider MySQLAdapter
    
    
    To send diagnostic logs for Event Hubs:
    
    ```powershell
    Send-AzureStackDiagnosticLog -FilterByResourceProvider eventhub
    

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

    Send-AzureStackDiagnosticLog -FilterByResourceProvide databoxedge
    
  • Use o parâmetro FilterByRole para enviar logs de diagnóstico de funções VirtualMachines e BareMetal:

    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 nas ú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 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 método Get-AzureStackLog para enviar logs.

Como os dados são tratados

Ao iniciar a coleta de log 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. Suporte da Microsoft pode acessar esses logs imediatamente com o caso de suporte sem precisar entrar em contato com o cliente para coleta de logs.

Salvar logs localmente

Você pode salvar logs em um compartilhamento SMB (Bloco de Mensagens do Servidor) local quando Azure Stack Hub está desconectado do Azure. Você pode, por exemplo, executar um ambiente desconectado. Se você estiver normalmente conectado, mas estiver enfrentando problemas de conectividade, poderá salvar logs localmente para ajudar na solução de problemas.

Na folha Configurações, insira o caminho e um nome de usuário e senha com permissão para gravar no compartilhamento. Durante um caso de suporte, Suporte da Microsoft 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.

Screenshot of diagnostic log collection options

Considerações sobre largura de banda

O tamanho médio da coleta de log de diagnóstico varia de acordo com se ela é executado de forma proativa ou manual. O tamanho médio da coleta de log proativo é de cerca de 2 GB. O tamanho da coleção para Enviar logs agora depende de quantas horas estão sendo coletadas.

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

Conexão de rede Impacto
Conexão de baixa largura de banda/alta latência O upload de log levará muito tempo para ser concluído.
Conexão compartilhada O upload também pode afetar outros aplicativos/usuários que compartilham a conexão de rede.
Conexão limitada Pode haver outro custo do ISP para o uso extra da rede.

Exibir coleção de log

O histórico de logs coletados Azure Stack Hub na página Coleta de logs em Ajuda + suporte, com as seguintes datas e horas:

  • Tempo coletado:quando a operação de coleta de log foi iniciada.
  • Status:em andamento ou concluído.
  • Início doslogs: início do período de tempo para o qual você deseja coletar.
  • Término dos logs:fim do período de tempo.
  • Digite: se for uma coleção de log manual ou proativa.

Log collections in Help + support

Confira também

Azure Stack Hub log e tratamento de dados do cliente