Configurar o registo de erros no Azure Data Lake Storage

Este artigo mostra-lhe como configurar a sua conta do Azure Data Lake Storage para permitir que o Intelligent Recommendations escreva dados do registo de erros nela.

Atualmente, os clientes podem ver registos de erros relacionados com o processo de ingestão de dados e registos de avaliação da modelação que lhe permitem analisar o desempenho dos seus modelos.

Para ativar o registo do Intelligent Recommendations, primeiro tem de conceder permissões de escrita ao Intelligent Recommendations para um contentor na sua conta do Data Lake Storage.

Selecionar um contentor e uma pasta raiz

Para selecionar o contentor e a pasta que o Intelligent Recommendations utiliza para registar os relatórios:

1. Inicie sessão no portal do Azure e selecione a secção Armazenamento.

2. Escolha a subscrição utilizada para criar a sua conta do Intelligent Recommendations, escolha uma conta do Data Lake Storage e, em seguida, selecione Contentores.

   

3. Escolha o contentor, o mesmo que utilizou na pasta raiz para o Intelligent Recommendations. No nosso exemplo, o contentor é ircontainer e a pasta raiz é ir_root.

4. Em seguida, selecione ou crie a pasta de destino para os registos escritos pelo Intelligent Recommendations. Neste exemplo, criámos uma pasta denominada ir_logs.

   

Nota

Caso tenha utilizado o mesmo contentor para partilhar dados com o Intelligent Recommendations e para registar dados de volta para o Data Lake Storage, recomendamos vivamente que utilize uma pasta diferente para escrever registos de erros no Data Lake Storage que a pasta raiz utilizada para partilhar dados com o Intelligent Recommendations.

Configurar a segurança para o contentor

Para configurar a segurança do seu contentor e permitir que os registos sejam escritos na pasta de registos da conta de armazenamento dedicada, tem de conceder acesso ao Intelligent Recommendations para escrever registos utilizando identidades geridas atribuídas pelo sistema ou atribuídas pelo utilizador. Estes passos utilizam a identidade gerida atribuída pelo sistema. Para mais informações sobre como configurar a segurança utilizando uma identidade gerida atribuída pelo utilizador, aceda a Identidade Atribuída pelo Utilizador para o Intelligent Recommendations.

Antes de continuar, certifique-se de que tem o ID da subscrição e conta de Armazenamento que a sua empresa utilizará para partilhar dados com o Intelligent Recommendations.

Abordagem de identidade gerida atribuída pelo sistema

Para configurar a segurança com a identidade gerida atribuída pelo sistema:

1. Abra a sua conta do Intelligent Recommendations.
2. No painel esquerdo, selecione Identidade.
3. No separador Atribuído pelo sistema, passe Estado para ATIVADO e selecione Guardar.

4. Regresse à conta de armazenamento e selecione Contentores no painel de navegação esquerdo e selecione o seu ircontainer (ou qualquer que seja o nome que tenha dado ao contentor).
5. No painel esquerdo, selecione Controlo de Acesso (IAM).

6. Para permitir que o serviço Intelligent Recommendations escreva dados de registos, atribua a permissão Contribuidor de Dados de Blobs de Armazenamento:

   1. Em Conceder acesso a este recurso, selecione Adicionar a atribuição de função.
   2. Em Função, selecione Contribuidor de Dados de Blobs de Armazenamento e, em seguida, selecione Seguinte.
   3. No ecrã seguinte, na secção Atribuir acesso a, selecione Identidade Gerida e, em seguida, selecione + Selecionar membros.

   

   4. Em Identidade gerida, selecione a categoria Conta do Intelligent Recommendations.

   

   5. Em seguida, vê uma lista de Contas do Intelligent Recommendations. Escolha a conta relevante que tem acesso a esta conta de armazenamento e, em seguida, selecione Selecionar.

   

   6. Finalize a sua decisão selecionando o botão "Rever + Atribuir".

Verificar as atribuições de funções

Verifique se tem o conjunto de permissões correto regressando à sua conta de armazenamento e ao ircontainer.

1. No seu ircontainer, selecione Controlo de Acesso (IAM) no painel esquerdo.
2. Selecione Vista na secção Acesso para ver este recurso.
3. Pesquise pelo serviço Intelligent Recommendations e verifique se o serviço está listado na secção Atribuições de funções com Contribuidor de Dados de Blobs de Armazenamento. Se esta função estiver em falta, volte atrás e volte a adicionar a função utilizando os passos descritos anteriormente.

Nota

Também é possível configurar permissões ao nível da pasta (permissões de ACL). Para mais informações sobre permissões de ACL, aceda a Listas de controlo de acesso no Azure Data Lake Storage Gen2.

Configurar a caraterística de relatórios

O passo seguinte é configurar a sua pasta raiz designada como a localização para a qual os relatórios serão registados.

1. Aceda à sua conta do Intelligent Recommendations.
2. Selecione o separador Relatórios.
3. Introduza o URL da pasta de registos. Se já tiver componentes de modelação nesta conta de IR, vê nesta fase uma lista dos seus componentes de modelação. Quando seleciona um deles, é criada automaticamente uma pasta de registos com o nome "root_reports" no contentor que está definido na cadeia de ligação do componente de modelação e os registos desta conta de IR são escritos nessa pasta.
4. Pode selecionar o botão "Verificar Acesso" para verificar se a conta de IR tem permissões para escrever registos no contentor no qual a pasta de registos está localizada.
5. Selecione Atualizar.

Nota

Esta pasta não precisa de existir. Se não for publicada nenhuma ligação aqui, será criada uma pasta após a primeira tentativa de escrever dados nela.

Aceder aos registos

Agora que configurou com êxito, os registos de repetição de escrita são escritos na pasta de destino onde escolheu todos os ciclos de preparação. Os ciclos de preparação são executados uma vez após cada janela de tempo pré-determinada e também podem ser acionados manualmente. Para mais informações, aceda a Acionar manualmente o ciclo de modelação.

Dentro da pasta, encontra uma subpasta para cada um dos seus componentes de modelação. Em cada subpasta, encontra duas pastas:

• ingestão de dados: contém os registos relacionados com a ingestão de dados
• estatísticas: contém os registos relacionados com o desempenho do modelo.

Para mais informações sobre a análise destes registos, aceda a Registos de erros.

Consulte também

Referência da API Intelligent Recommendations
Guia de início rápido: Configurar e executar o Intelligent Recommendations com dados de amostra
Guia de início rápido: Fazer uma chamada à API autenticada
Descrição geral da implementação
Utilizar contratos de dados para partilhar dados