Reunir diagnósticos usando o portal do Azure

Neste guia de instruções, você aprenderá a reunir um pacote de diagnóstico remoto para um site do Azure Private 5G Core (AP5GC) usando o portal do Azure. O pacote de diagnóstico pode ser fornecido ao suporte do Azure para ajudá-lo com problemas.

Você deve sempre coletar diagnósticos o mais rápido possível depois de encontrar um problema e enviá-los com sua solicitação de suporte. Consulte Como abrir uma solicitação de suporte para o Azure Private 5G Core.

Pré-requisitos

Você já deve ter um site AP5GC implantado para coletar diagnósticos.

Configurar uma conta de armazenamento

Você precisa configurar uma conta de armazenamento para armazenar o pacote de diagnóstico.

1. Crie uma conta de armazenamento para diagnóstico com a seguinte configuração adicional:
   1. Na guia Proteção de dados, em Controle de acesso, selecione Habilitar suporte para imutabilidade no nível da versão. Isso permitirá que você especifique uma política de retenção baseada em tempo para a conta na próxima etapa.
   2. Se você quiser que o conteúdo de sua conta de armazenamento seja excluído automaticamente após um período de tempo, configure uma política de retenção baseada em tempo padrão para sua conta de armazenamento.
   3. Crie um contêiner para seus diagnósticos.
   4. Anote a URL do blob do contêiner. Por exemplo:
      https://storageaccountname.blob.core.windows.net/diagscontainername
      1. Navegue até sua conta de armazenamento.
      2. Selecione o símbolo ... no lado direito do blob de contêiner que você deseja usar para a coleta de diagnósticos.
      3. Selecione Propriedades do contêiner no menu de contexto.
      4. Copie o conteúdo do campo URL na visualização Propriedades do contêiner.
2. Crie uma identidade atribuída pelo usuário e atribua-a à conta de armazenamento criada acima com a função Colaborador de Dados de Blob de Armazenamento.

   Dica

   Talvez você já tenha criado e associado uma identidade atribuída pelo usuário ao criar o site.

3. Navegue até o recurso Plano de controle principal de pacote do site.
4. Selecione Identidade em Configurações no menu lateral esquerdo.
5. Selecione Adicionar.
6. Selecione a identidade gerenciada assinada pelo usuário que você criou e selecione Adicionar.

Reunir diagnósticos para um site

1. Entre no portal do Azure.

2. Navegue até a página de visão geral do Painel de Controle do Núcleo de Pacotes do site para o qual você deseja coletar diagnósticos.

3. Selecione Coleção de diagnósticos na seção Ajuda do lado esquerdo. Isso abrirá um modo de exibição Coleção de Diagnósticos.

4. Insira a URL do blob da conta de armazenamento que foi configurada para armazenamento de diagnóstico e acrescente o nome do arquivo que você deseja fornecer ao diagnóstico. Por exemplo: https://storageaccountname.blob.core.windows.net/diagscontainername/diagsPackageName.zip

   Dica

   A URL do blob da conta de armazenamento deve ter sido anotada durante a criação. Se não fosse:

   1. Navegue até sua conta de armazenamento.
   2. Selecione o símbolo ... no lado direito do blob de contêiner que você deseja usar para a coleta de diagnósticos.
   3. Selecione Propriedades do contêiner no menu de contexto.
   4. Copie o conteúdo do campo URL na visualização Propriedades do contêiner.

5. Selecione Coleção de diagnósticos.

6. O serviço online AP5GC gerará um pacote na URL da conta de armazenamento fornecida. Depois que o portal informar que isso foi bem-sucedido, você poderá baixar o pacote de diagnóstico pronto para compartilhar com o suporte do Azure.

   1. Para baixar o pacote de diagnóstico, navegue até a URL da conta de armazenamento, clique com o botão direito do mouse no arquivo e selecione Download.
   2. Para abrir uma solicitação de suporte e compartilhar o pacote de diagnóstico com o suporte do Azure, consulte Como abrir uma solicitação de suporte para o Azure Private 5G Core.

Solução de problemas

• Se a coleta de arquivos de diagnóstico falhar, um log de atividades aparecerá no portal permitindo que você solucione problemas via ARM:
  • Se uma URL de contêiner inválida foi passada, a solicitação será rejeitada e relatará 400 Solicitação incorreta. Repita o processo com a URL do contêiner correta.
  • Se a parte assíncrona da operação falhar, o recurso de operação assíncrona será definido como Falha e relatará um motivo de falha.
• Verifique se a mesma identidade atribuída pelo usuário foi adicionada ao site e à conta de armazenamento.
• Verifique se o contêiner de armazenamento tem uma política de imutabilidade configurada. Em caso afirmativo, remova a política ou verifique se a conta de armazenamento tem o suporte à imutabilidade em nível de versão habilitado, conforme descrito em Configurar uma conta de armazenamento. Isso é necessário porque o arquivo de diagnóstico é transmitido para o contêiner da conta de armazenamento, portanto, o contêiner deve oferecer suporte a atualizações de blob. Para obter mais informações, consulte Políticas de retenção baseadas em tempo para dados de blob imutáveis.
• Se isso não resolver o problema, compartilhe a ID de correlação da solicitação com falha com o suporte AP5GC para investigação. Consulte Como abrir uma solicitação de suporte para o Azure Private 5G Core.

Próximas etapas

• Executar captura de pacotes em uma instância de núcleo de pacote
• Monitorar o Azure Private 5G Core com métricas de plataforma do Azure Monitor
• Monitorar o Azure Private 5G Core com painéis de núcleo de pacote