Implantar um produto de dados do Azure Operator Insights

Neste artigo, você aprenderá a criar uma instância do Produto de Dados do Azure Operator Insights.

Nota

Atualmente, o acesso só está disponível mediante solicitação. O formulário de candidatura contém mais informações. Agradecemos sua paciência enquanto trabalhamos para permitir um acesso mais amplo ao Produto de Dados do Azure Operator Insights. Solicite o acesso preenchendo este formulário.

Pré-requisitos

• Uma assinatura do Azure para a qual a conta de usuário deve receber a função de Colaborador. Se necessário, crie uma assinatura gratuita antes de começar.
• Acesso concedido ao Azure Operator Insights para a assinatura. Solicite o acesso preenchendo este formulário.
• (Opcional) Se você planeja integrar o Data Product ao Microsoft Purview, deve ter uma conta Purview ativa. Anote a ID da coleção Purview ao configurar o Microsoft Purview com um Produto de Dados.
• Depois de obter o acesso à sua assinatura, registre os RPs (Resource Providers) Microsoft.NetworkAnalytics e Microsoft.HybridNetwork para continuar. Para obter orientação sobre como registrar RPs em sua assinatura, consulte Registrar provedores de recursos no Azure.

Preparar seu portal do Azure ou ambiente da CLI do Azure

Você pode usar o portal do Azure ou a CLI do Azure para seguir as etapas neste artigo.

Portal

Confirme que pode iniciar sessão no portal do Azure e aceder à subscrição.

CLI do Azure

Você pode executar comandos da CLI do Azure de duas maneiras:

• Você pode executar comandos da CLI de dentro do portal do Azure, no Azure Cloud Shell.
• Você pode instalar a CLI e executar comandos da CLI localmente.

Utilizar o Azure Cloud Shell

O Azure Cloud Shell é um shell Bash gratuito que pode ser executado diretamente no portal do Azure. A CLI do Azure está pré-instalada e configurada para ser usada com sua conta. Selecione o botão Cloud Shell no menu na seção superior direita do portal do Azure:

O botão inicia um shell interativo que você pode usar para executar as etapas descritas neste artigo de instruções:

Instalar a CLI do Azure localmente

Também pode instalar e utilizar a CLI do Azure localmente. Se você planeja usar a CLI do Azure localmente, certifique-se de ter instalado a versão mais recente da CLI do Azure. Consulte Instalar a CLI do Azure.

Para fazer login na instalação local da CLI, execute o comando az sign-in:

az login

Alterar a subscrição ativa

As assinaturas do Azure têm um nome e uma ID. Você pode mudar para uma assinatura diferente com az conta definida, especificando o nome ou ID da assinatura desejada.

• Para usar o nome para alterar a assinatura ativa:

  az account set --subscription "<SubscriptionName>"
  

• Para usar a ID para alterar a assinatura ativa:

  az account set --subscription "<SubscriptionID>"
  

Nota

Substitua todos os valores mostrados no formulário <KeyVaultName> pelos valores para sua implantação.

Criar um grupo de recursos

Um grupo de recursos é um contentor lógico no qual os recursos do Azure são implementados e geridos.

Portal

Se você planeja usar a criptografia de dados baseada em CMK ou o Microsoft Purview, configure um grupo de recursos agora:

1. Inicie sessão no portal do Azure.
2. Selecione Grupos de recursos.
3. Selecione Criar e siga as instruções.

Para obter mais informações, consulte Criar grupos de recursos.

Se você não planeja usar a criptografia de data baseada em CMK ou o Microsoft Purview, poderá configurar um grupo de recursos agora ou quando criar o recurso Produto de Dados.

CLI do Azure

Use o az group create comando para criar um grupo de recursos chamado <ResourceGroup> na região onde você deseja implantar.

az group create --name "<ResourceGroup>" --location "<Region>"

Configurar recursos para criptografia de dados baseada em CMK ou Microsoft Purview

Se você planeja usar a criptografia de dados baseada em CMK ou o Microsoft Purview, você deve configurar uma instância do Cofre de Chaves do Azure e uma identidade gerenciada atribuída pelo usuário (UAMI) primeiro.

Configurar uma chave em um Cofre de Chaves do Azure

Uma instância do Azure Key Vault armazena sua Chave Gerenciada pelo Cliente (CMK) para criptografia de dados. O Produto de Dados usa essa chave para criptografar seus dados além da criptografia de armazenamento padrão. Você precisa ter permissões de proprietário do grupo de Assinatura/Recursos para executar esta etapa.

Portal

1. Crie um recurso do Cofre da Chave do Azure na mesma assinatura e grupo de recursos que você configurou em Criar um grupo de recursos.
2. Forneça à sua conta de utilizador a função de Administrador do Cofre de Chaves no recurso Cofre de Chaves do Azure. Isso é feito por meio da guia Controle de Acesso (IAM) no recurso Azure Key Vault.
3. Navegue até o objeto e selecione Chaves. Selecione Gerar/Importar.
4. Insira um nome para a chave e selecione Criar.
5. Selecione a chave recém-criada e selecione a versão atual da chave.
6. Copie o URI do identificador de chave para a área de transferência para usar ao criar o produto de dados.

CLI do Azure

Criar um cofre de chaves

Use o comando CLI az keyvault create do Azure para criar um Cofre da Chave no grupo de recursos da etapa anterior. Deve fornecer:

• Um nome para o cofre de chaves: uma cadeia de 3 a 24 caracteres que pode conter apenas números (0-9), letras (a-z, A-Z) e hífenes (-). Cada cofre de chaves deve ter um nome exclusivo.
• O grupo de recursos que você criou em Criar um grupo de recursos.
• A região na qual você criou o grupo de recursos.

az keyvault create --name "<KeyVaultName>" --resource-group "<ResourceGroup>" --location "<Region>"

A saída deste comando mostra as propriedades do cofre de chaves recém-criado. Tome nota de:

• Nome do cofre: o nome que você forneceu para o --name parâmetro que você executou.
• URI do Vault: No exemplo, o URI é https://<KeyVaultName>.vault.azure.net/. As aplicações que utilizam o cofre através da respetiva API têm de utilizar este URI.

Nesta altura, a sua conta do Azure é a única autorizada a realizar quaisquer operações neste novo cofre.

Atribuir funções para o cofre de chaves

Forneça à sua conta de utilizador a função de Administrador do Cofre de Chaves no recurso Cofre de Chaves do Azure.

az role assignment create --role "Key Vault Administrator" --assignee <YourEmailAddress> --scope /subscriptions/<SubscriptionID>/resourcegroups/<ResourceGroup>/providers/Microsoft.KeyVault/vaults/<KeyVaultName>

Criar uma chave

az keyvault key create --vault-name "<KeyVaultName>" -n <keyName> --protection software

Na tela de saída, copie o e armazene-o KeyID em sua área de transferência para uso posterior.

Configurar uma identidade gerenciada atribuída pelo usuário

Portal

1. Crie uma identidade gerenciada atribuída pelo usuário usando o Microsoft Entra ID para criptografia baseada em CMK. O Produto de Dados também usa a identidade gerenciada atribuída ao usuário (UAMI) para interagir com a conta do Microsoft Purview.
2. Navegue até o recurso Cofre de Chaves do Azure que você criou anteriormente e atribua a função UAMI com Administrador do Cofre de Chaves .

CLI do Azure

Criar uma identidade gerida atribuída pelo utilizador

Para criar uma identidade gerenciada atribuída pelo usuário, sua conta precisa da atribuição de função de Colaborador de Identidade Gerenciada.

Use o comando para criar uma identidade gerenciada atribuída pelo az identity create usuário. O parâmetro -g especifica o grupo de recursos onde criar a identidade gerenciada atribuída pelo usuário. O parâmetro -n especifica seu nome. Substitua os valores dos <parâmetros ResourceGroup> e <UserAssignedIdentityName> pelos seus próprios valores.

Importante

Quando você cria identidades gerenciadas atribuídas pelo usuário, apenas caracteres alfanuméricos (0-9, a-z e A-Z) e o hífen (-) são suportados.

az identity create -g <ResourceGroup> -n <UserAssignedIdentityName>

Copie o da tela de saída e armazene-o principalId na área de transferência para uso posterior.

Atribuir a identidade gerenciada atribuída pelo usuário ao cofre de chaves

az role assignment create --role "Key Vault Administrator" --assignee <principalId> --scope /subscriptions/<SubscriptionID>/resourcegroups/<ResourceGroup>/providers/Microsoft.KeyVault/vaults/<KeyVaultName>

Criar um recurso do Produto de Dados do Azure Operator Insights

Você cria o recurso do Produto de Dados do Azure Operator Insights.

Portal

1. Inicie sessão no portal do Azure.

2. Na barra de pesquisa, procure Operator Insights e selecione Azure Operator Insights - Data Products.

3. Na página Azure Operator Insights - Produtos de Dados, selecione Criar.

4. Na guia Noções básicas da página Criar um produto de dados:

   1. Selecione a sua subscrição.
   2. Selecione o grupo de recursos que você criou anteriormente para o recurso Cofre da Chave.
   3. Em Detalhes da instância, preencha os seguintes campos:
      • Nome - Insira o nome do recurso Produto de dados. O nome deve começar com uma letra minúscula e pode conter apenas letras minúsculas e números.
      • Publicador - Selecione a organização que criou e publicou o Produto de Dados que você deseja implantar.
      • Produto - Selecione o nome do Produto de Dados.
      • Versão - Selecione a versão.

   Selecione Next: Avançado.

   

5. Na guia Avançado da página Criar um Produto de Dados:

   1. Habilite o Purview se estiver integrando com o Microsoft Purview. Selecione a assinatura da sua conta Purview, selecione sua conta Purview e insira o ID da coleção Purview.
   2. Habilite a chave gerenciada pelo cliente se estiver usando CMK para criptografia de dados.
   3. Selecione a identidade gerenciada atribuída pelo usuário que você configurou como pré-requisito.
   4. Cole cuidadosamente o URI do Identificador de Chave que foi criado quando você configurou o Cofre de Chaves do Azure como pré-requisito.

6. Para adicionar um ou mais proprietários para o Produto de Dados, que também aparecerá no Microsoft Purview, selecione Adicionar proprietário, insira o endereço de email e selecione Adicionar proprietários.

7. Na guia Marcas da página Criar um Produto de Dados, selecione ou insira o par nome/valor usado para categorizar seu recurso Produto de Dados.

8. Selecione Rever + criar.

9. Selecione Criar. Sua instância do Data Product é criada em cerca de 20 a 25 minutos. Durante esse período, todos os componentes subjacentes são provisionados. Após a conclusão desse processo, você pode trabalhar com sua ingestão de dados, explorar exemplos de painéis e consultas, e assim por diante.

CLI do Azure

Para criar um Produto de Dados do Azure Operator Insights com os parâmetros mínimos necessários, use o seguinte comando:

az network-analytics data-product create --name <DataProductName> --resource-group <ResourceGroup> --location <Region> --publisher Microsoft --product <ProductName> --major-version  <ProductMajorVersion>

Use os seguintes valores para <ProductName> e <ProductMajorVersion>.

Data do Produto	<Nome do Produto>	<ProductMajorVersion>
Qualidade de Experiência - Afirmado MCC GIGW	Quality of Experience - Affirmed MCC GIGW	1.0
Qualidade de Experiência - Afirmada MCC PGW ou GGSN	Quality of Experience - Affirmed MCC PGW or GGSN	1.0
Monitoramento - MCC Afirmado	Monitoring - Affirmed MCC	0 ou 1

Para criar um DataProduct do Azure Operator Insights com todos os parâmetros, use o seguinte comando:

az network-analytics data-product create --name <DataProductName> --resource-group <ResourceGroup> --location <Region> --publisher Microsoft --product <ProductName> --major-version  <ProductMajorVersion --owners <<xyz@email>> --customer-managed-key-encryption-enabled Enabled --key-encryption-enable Enabled --encryption-key '{"keyVaultUri":"<VaultURI>","keyName":"<KeyName>","keyVersion":"<KeyVersion>"}' --purview-account <PurviewAccount> --purview-collection <PurviewCollection> --identity '{"type":"userAssigned","userAssignedIdentities":{"/subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<UserAssignedIdentityName>"}}' --tags '{"key1":"value1","key2":"value2"}'

Implantar insights de exemplo

Depois que a instância do Produto de Dados for criada, você poderá implantar um painel de insights de exemplo. Esse painel funciona com os dados de exemplo fornecidos junto com a instância do Produto de Dados.

1. Navegue até o recurso Produto de Dados no portal do Azure e selecione a guia Permissões na seção Segurança.
2. Selecione Adicionar leitor. Digite o endereço de e-mail do usuário a ser adicionado à função de leitor do Produto de Dados.

Nota

A função de leitor é necessária para que você tenha acesso à URL de consumo de insights.

3. Baixe o arquivo de modelo JSON de exemplo para o painel do seu Produto de Dados:
   • Qualidade de Experiência - Afirmado MCC GIGW: https://go.microsoft.com/fwlink/p/?linkid=2254536
   • Monitoramento - MCC afirmado: https://go.microsoft.com/fwlink/p/?linkid=2254551
4. Copie o URL de consumo da tela Visão geral do Produto de Dados para a área de transferência.
5. Abra um navegador da Web, cole o URL e selecione enter.
6. Quando o URL carregar, selecione na opção Painéis no painel de navegação esquerdo.
7. Selecione a lista suspensa Novo painel e selecione Importar painel do arquivo. Navegue para selecionar o arquivo JSON baixado anteriormente, forneça um nome para o painel e selecione Criar.
8. Selecione os três pontos (...) no canto superior direito da página URL de consumo e selecione Fontes de dados.
9. Selecione o ícone de lápis ao lado do Nome da fonte de dados para editar a fonte de dados.
10. Na seção URI do cluster, substitua a URL pela URL de consumo do produto de dados e selecione conectar.
11. Na lista suspensa Banco de dados, selecione seu Banco de dados. Normalmente, o nome do banco de dados é o mesmo que o nome da instância do Produto de Dados. Selecione Aplicar.

Nota

Esses painéis são baseados em dados sintéticos e podem não ter exemplos completos ou representativos da experiência do mundo real.

Explore dados de exemplo usando o Kusto

O URL de consumo também permite que você escreva sua própria consulta Kusto para obter insights dos dados.

1. Na página Visão geral, copie o URL de consumo e cole-o em uma nova guia do navegador para ver o banco de dados e a lista de tabelas.

   

2. Use o plano de consulta ADX para escrever consultas Kusto.

   • Para Qualidade de Experiência - Afirmado MCC GIGW, tente as seguintes consultas:

     enriched_flow_events_sample
     | summarize Application_count=count() by flowRecord_dpiStringInfo_application
     | order by Application_count desc
     | take 10
     

     enriched_flow_events_sample
     | summarize SumDLOctets = sum(flowRecord_dataStats_downLinkOctets) by bin(eventTimeFlow, 1h)
     | render columnchart
     

   • Para Monitoring - Affirmed MCC Data Product, tente as seguintes consultas:

     SYSTEMCPUSTATISTICSCORELEVEL_SAMPLE
     | where systemCpuStats_core >= 25 and systemCpuStats_core <= 36
     | summarize p90ssm_avg_1_min_cpu_util=round(percentile(ssm_avg_1_min_cpu_util, 90), 2) by resourceId
     

     PGWCALLPERFSTATSGRID_SAMPLE
     | summarize clusterTotal=max(NumUniqueSubscribers) by bin(timestamp, 1d)
     | render linechart
     

Opcionalmente, exclua os recursos do Azure

Se estiver a utilizar este Produto de Dados para explorar o Azure Operator Insights, deve eliminar os recursos que criou para evitar custos desnecessários do Azure.

Portal

1. Na página inicial do portal do Azure, selecione Grupos de recursos.
2. Selecione o grupo de recursos para o seu Produto de Dados do Azure Operator Insights e verifique se ele contém a instância do Produto de Dados do Azure Operator Insights.
3. Na parte superior da página Visão geral do seu grupo de recursos, selecione Excluir grupo de recursos.
4. Digite o nome do grupo de recursos para confirmar a exclusão e selecione Excluir.

CLI do Azure

az group delete --name "ResourceGroup"

Próximo passo

Carregue dados para o seu Produto de Dados:

1. Leia a documentação do seu Produto de Dados para determinar quaisquer requisitos de ingestão.
2. Configure uma solução de ingestão:
   • Para usar o agente de ingestão do Azure Operator Insights, instale e configure o agente.
   • Para usar o Azure Data Factory, siga Usar o Azure Data Factory para ingerir dados em um Produto de Dados do Azure Operator Insights.