Compartilhar via


Coleta de logs 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 coleção de logs de diagnóstico do Azure Stack Hub, você precisa registrar sua instância. Se você ainda não registrou o 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 o suporte da Microsoft. Dependendo da conectividade com o Azure, suas opções incluem:

A coleção proativa de logs carrega automaticamente 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 é executado em um ambiente desconectado ou se você estiver tendo problemas de conectividade, escolha salvar logs localmente.

Enviar logs de forma proativa

A coleção 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ó são coletados quando um alerta de integridade do sistema é gerado e o suporte da Microsoft acessa apenas esses logs no contexto de um caso de suporte.

A partir do Azure Stack Hub versão 2008, a coleção de logs proativa 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 certas sejam coletadas no momento certo sem precisar de nenhuma interação do operador. O suporte da Microsoft pode iniciar a solução de problemas e resolver problemas mais cedo em alguns casos. As melhorias iniciais do algoritmo se concentram em operações de patch 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 incidentes de erro. Esses eventos não são visíveis para o operador.

É altamente recomendável habilitar a coleção de logs proativa. Ele permite que a equipe do produto diagnostice problemas devido a eventos de falha e melhore a qualidade do produto.

Observação

Se a coleção proativa de logs estiver habilitada e você renovar ou alterar o registro do Azure Stack Hub, conforme descrito em Renovar ou alterar o registro, você deverá reabilitar a coleta proativa de logs.

O Azure Stack Hub coleta proativamente logs 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 Serviço de Armazenamento.Tabela.servidor.dados.corrupção-Crítico
Nó inacessível para alocação de máquina virtual AzureStack.ComputeController.HostUnresponsive
Os dados do serviço blob estão corrompidos StorageService.Blob.serviço.dados.é.corrompido-Crítico
Dados de conta e serviço de contêiner corrompidos ServiçoDeArmazenamento.Conta.e.ServiçoDeContêiner.corrupção.de.dados-Crítico

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

A coleta proativa de logs pode ser desabilitada e re-habilitada a qualquer momento. Siga estas etapas para configurar a coleção de logs proativa.

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

Observação

Se as configurações de local de log estiverem configuradas para um compartilhamento de arquivos local, verifique se as políticas de gerenciamento do ciclo de vida impedem que o armazenamento de compartilhamento atinja sua cota de tamanho. O Azure Stack Hub não monitora o compartilhamento de arquivos local nem impõe políticas de retenção.

Como os dados são tratados

Você concorda com a coleta periódica automática de logs pela Microsoft, baseada apenas em alertas de integridade do sistema do Azure Stack Hub. Você também reconhece e consente o upload 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 marketing, publicidade ou quaisquer outras finalidades comerciais sem o seu consentimento. Os dados podem ser retidos por até 90 dias e a Microsoft manipula todos os dados coletados seguindo nossas práticas de privacidade padrão.

A revogação de sua permissão não afeta nenhum dado coletado anteriormente com seu consentimento.

Os logs coletados usando a coleção 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 melhorar a integridade do Azure Stack Hub.

Enviar logs agora

Dica

Economize tempo ao usar 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 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 Enviar logs agora , 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 por 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 pelo 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 adição de valor. A sintaxe geral é:

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

    Para enviar logs de diagnóstico para RP SQL:

    Send-AzureStackDiagnosticLog -FilterByResourceProvider SQLAdapter
    

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

    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 de funções VirtualMachines e BareMetal.

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

    $fromDate = (Get-Date).AddHours(-8)
    Invoke-Command -Session $pepsession -ScriptBlock {Send-AzureStackDiagnosticLog -FilterByRole VirtualMachines,BareMetal -FromDate $using:fromDate}
    
  • Para enviar logs de diagnóstico das funções VirtualMachines e BareMetal, com filtragem de data nos arquivos de log para o período entre 8 horas 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 através do portal do administrador

Para enviar logs agora usando o portal do administrador:

  1. Abra Ajuda + suporte > Coleta de Logs > Enviar logs agora.
  2. Escolha o fuso horário local.
  3. Selecione Coletar e Carregar.

Importante

Você não pode 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 acessar esses logs imediatamente com o caso de suporte, sem interação com o cliente para o recolhimento dos logs.

Salvar logs localmente

Você pode salvar logs em um compartilhamento SMB (Bloco de Mensagens do Servidor) local quando o Azure Stack Hub é 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.

No painel Configurações, insira o caminho e um nome de usuário e senha que tenham permissão para gravar no compartilhamento. Durante um caso de suporte, o suporte da Microsoft funciona 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 tela das opções de coleta de logs de diagnóstico

Considerações sobre largura de banda

O tamanho médio da coleção de logs de diagnóstico varia de acordo com se ela for realizada de forma proativa ou manual. O tamanho médio da coleção 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 sendo coletadas 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 tarifadas ao Azure.

Conexão de rede Impacto
Conexão de baixa largura de banda/alta latência O upload de log leva um longo período de 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 encargo do SEU ISP para o uso extra da rede.

Por exemplo, se a conexão com a internet ou a velocidade de link do Azure Stack Hub for de 5 Megabits/segundo (baixa velocidade de conexão), levará aproximadamente 57 minutos para enviar 2 GB de dados de log de diagnóstico para o suporte da Microsoft. Para uma coleção de log manual de 8 GB usando uma velocidade de link de 5 Megabits/segundo, leva aproximadamente 3 horas e 49 minutos para carregar os dados. Esse tempo estendido para carregar dados de diagnóstico pode atrasar ou afetar a experiência de suporte.

Exibir 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 horários:

  • Tempo coletado: quando a operação de coleta de logs começou.
  • Status: em andamento ou concluído.
  • Início dos logs: início do período de tempo para o qual você deseja coletar.
  • Término dos logs: Fim do período de tempo.
  • Tipo: se é uma coleta de logs manual ou proativa.

Coleções de logs na Ajuda + suporte

Próximas etapas

Gerenciamento de dados do cliente e log do Azure Stack Hub