Distribuire un prodotto dati di Informazioni dettagliate operatori di Azure

Questo articolo illustra come creare un'istanza di Azure Operator Insights Data Product.

Nota

L'accesso è attualmente disponibile solo per richiesta. Altre informazioni sono incluse nel modulo dell'applicazione. Apprezziamo la pazienza del nostro lavoro per consentire un accesso più ampio al prodotto Dati di Informazioni dettagliate operatori di Azure. Richiedere l'accesso compilando il modulo.

Prerequisiti

• Una sottoscrizione di Azure a cui l'account utente deve essere assegnato il ruolo Collaboratore. Se necessario, creare una sottoscrizione gratuita prima di iniziare.
• Accesso concesso ad Azure Operator Insights per la sottoscrizione. Richiedere l'accesso completando il modulo.
• (Facoltativo) Se si prevede di integrare Data Product con Microsoft Purview, è necessario disporre di un account Purview attivo. Prendere nota dell'ID raccolta Purview quando si configura Microsoft Purview con un prodotto dati.
• Dopo aver ottenuto l'accesso alla sottoscrizione, registrare Microsoft.NetworkAnalytics e Microsoft.HybridNetwork Resource Providers (RP) per continuare. Per indicazioni sulla registrazione di provider di risorse nella sottoscrizione, vedere Registrare i provider di risorse in Azure.

Preparare l portale di Azure o l'ambiente dell'interfaccia della riga di comando di Azure

È possibile usare il portale di Azure o l'interfaccia della riga di comando di Azure per seguire i passaggi descritti in questo articolo.

Portale

Verificare che sia possibile accedere al portale di Azure e accedere alla sottoscrizione.

Interfaccia della riga di comando di Azure

È possibile eseguire i comandi dell'interfaccia della riga di comando di Azure in uno dei due modi seguenti:

• È possibile eseguire i comandi dell'interfaccia della riga di comando nel portale di Azure, in Azure Cloud Shell.
• È possibile installare l'interfaccia della riga di comando ed eseguire i relativi comandi in locale.

Usare Azure Cloud Shell

Azure Cloud Shell è una shell Bash gratuita che è possibile eseguire direttamente nel portale di Azure. L'interfaccia della riga di comando di Azure è preinstallata e configurata per l'uso con l'account corrente. Selezionare il pulsante Cloud Shell nel menu nella sezione in alto a destra del portale di Azure:

Il pulsante avvia una shell interattiva che è possibile usare per eseguire i passaggi riportati in questo articolo della guida pratica:

Installare l'interfaccia della riga di comando di Azure in locale

È anche possibile installare e usare l'interfaccia della riga di comando di Azure in locale. Se si prevede di utilizzare l'interfaccia della riga di comando di Azure a livello locale, verificare di aver installato l'ultima versione dell'interfaccia della riga di comando di Azure. Vedere Installare l'interfaccia della riga di comando di Azure.

Per accedere all'installazione locale dell'interfaccia della riga di comando, eseguire il comando az sign-in:

az login

Cambiare la sottoscrizione attiva

Le sottoscrizioni di Azure hanno sia un nome che un ID. È possibile passare a una sottoscrizione diversa con az account set, specificando il nome o l'ID della sottoscrizione desiderati.

• Per usare il nome per modificare la sottoscrizione attiva:

  az account set --subscription "<SubscriptionName>"
  

• Per usare l'ID per modificare la sottoscrizione attiva:

  az account set --subscription "<SubscriptionID>"
  

Nota

Sostituire tutti i valori visualizzati nel formato <KeyVaultName> con i valori per la distribuzione.

Creare un gruppo di risorse

Un gruppo di risorse è un contenitore logico in cui vengono distribuite e gestite le risorse di Azure.

Portale

Se si prevede di usare la crittografia dei dati basata su CMK o Microsoft Purview, configurare ora un gruppo di risorse:

1. Accedere al portale di Azure.
2. Selezionare Gruppi di risorse.
3. Selezionare Crea e seguire le istruzioni.

Per altre informazioni, vedere Creare gruppi di risorse.

Se non si prevede di usare la crittografia della data basata su CMK o Microsoft Purview, è possibile configurare un gruppo di risorse ora o quando si crea la risorsa Data Product.

Interfaccia della riga di comando di Azure

Usare il az group create comando per creare un gruppo di risorse denominato <ResourceGroup> nell'area in cui si vuole distribuire.

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

Configurare le risorse per la crittografia dei dati basata su CMK o Microsoft Purview

Se si prevede di usare la crittografia dei dati basata su CMK o Microsoft Purview, è necessario configurare prima un'istanza di Azure Key Vault e un'identità gestita assegnata dall'utente.

Configurare una chiave in un insieme di credenziali delle chiavi di Azure

Un'istanza di Azure Key Vault archivia la chiave gestita dal cliente (CMK) per la crittografia dei dati. Il prodotto dati usa questa chiave per crittografare i dati oltre e sopra la crittografia di archiviazione standard. Per eseguire questo passaggio, è necessario disporre delle autorizzazioni di proprietario del gruppo di sottoscrizioni/risorse.

Portale

1. Creare una risorsa di Azure Key Vault nella stessa sottoscrizione e nello stesso gruppo di risorse configurato in Creare un gruppo di risorse.
2. Fornire all'account utente il ruolo Amministrazione istrator dell'insieme di credenziali delle chiavi nella risorsa azure Key Vault. Questa operazione viene eseguita tramite la scheda Controllo di accesso (IAM) nella risorsa di Azure Key Vault.
3. Passare all'oggetto e selezionare Chiavi. Seleziona Genera/Importa.
4. Immettere un nome per la chiave e selezionare Crea.
5. Selezionare la chiave appena creata e selezionare la versione corrente della chiave.
6. Copiare l'URI dell'identificatore di chiave negli Appunti da usare durante la creazione del prodotto dati.

Interfaccia della riga di comando di Azure

Creare un insieme di credenziali delle chiavi

Usare il comando dell'interfaccia della riga di comando di Azure az keyvault create per creare un insieme di credenziali delle chiavi nel gruppo di risorse del passaggio precedente. È necessario specificare:

• Nome dell'insieme di credenziali delle chiavi: stringa da 3 a 24 caratteri che può contenere solo numeri (0-9), lettere (a-z, A-Z) e trattini (-). Ogni insieme di credenziali delle chiavi deve avere un nome univoco.
• Gruppo di risorse creato in Creare un gruppo di risorse.
• Area in cui è stato creato il gruppo di risorse.

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

L'output di questo comando mostra le proprietà dell'istanza di Key Vault appena creata. Prendere nota di:

• Nome insieme di credenziali: nome specificato al --name parametro eseguito.
• URI dell'insieme di credenziali: nell'esempio l'URI è https://<KeyVaultName>.vault.azure.net/. Le applicazioni che usano l'insieme di credenziali tramite l'API REST devono usare questo URI.

A questo punto, l'account Azure è l'unico autorizzato a eseguire qualsiasi operazione su questo nuovo insieme di credenziali.

Assegnare ruoli per l'insieme di credenziali delle chiavi

Fornire all'account utente il ruolo Amministrazione istrator dell'insieme di credenziali delle chiavi nella risorsa azure Key Vault.

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

Creazione di una chiave

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

Nella schermata di output copiare e KeyID archiviarlo negli Appunti per usarlo in un secondo momento.

Configurare un'identità gestita assegnata dall'utente

Portale

1. Creare un'identità gestita assegnata dall'utente usando l'ID Microsoft Entra per la crittografia basata su CMK. Il prodotto dati usa anche l'identità gestita assegnata dall'utente (UAMI) per interagire con l'account Microsoft Purview.
2. Passare alla risorsa di Azure Key Vault creata in precedenza e assegnare uAMI con il ruolo di Amministrazione istrator di Key Vault.

Interfaccia della riga di comando di Azure

Creare un'identità gestita assegnata dall'utente

Per creare un'identità gestita assegnata dall'utente, all'account deve essere assegnato il ruolo Collaboratore di identità gestite.

Usare il az identity create comando per creare un'identità gestita assegnata dall'utente. Il parametro -g specifica il gruppo di risorse in cui creare l'identità gestita assegnata dall'utente. Il parametro -n specifica il nome. Sostituire i valori dei <parametri ResourceGroup> e <UserAssignedIdentityName> con i propri valori.

Importante

Per la creazione di identità gestite assegnate dall'utente, sono supportati solo caratteri alfanumerici (0-9, a-z, A-Z) e il trattino (-).

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

Copiare dalla principalId schermata di output e archiviarlo negli Appunti per usarlo in un secondo momento.

Assegnare l'identità gestita assegnata dall'utente all'insieme di credenziali delle chiavi

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

Creare una risorsa del prodotto dati di Informazioni dettagliate operatori di Azure

Si crea la risorsa Azure Operator Insights Data Product.

Portale

1. Accedere al portale di Azure.

2. Nella barra di ricerca cercare Informazioni dettagliate operatori e selezionare Informazioni dettagliate operatore di Azure - Prodotti dati.

3. Nella pagina Informazioni dettagliate operatore di Azure - Prodotti dati selezionare Crea.

4. Nella scheda Informazioni di base della pagina Crea un prodotto dati:

   1. Selezionare la propria sottoscrizione.
   2. Selezionare il gruppo di risorse creato in precedenza per la risorsa Key Vault.
   3. In Dettagli istanza completare i campi seguenti:
      • Nome : immettere il nome della risorsa Prodotto dati. Il nome deve iniziare con una lettera minuscola e può contenere solo lettere minuscole e numeri.
      • Server di pubblicazione : selezionare l'organizzazione che ha creato e pubblicato il prodotto dati da distribuire.
      • Product : selezionare il nome del prodotto dati.
      • Versione : selezionare la versione.

   Al termine, selezionare Avanti: Avanzate.

   

5. Nella scheda Avanzate della pagina Crea un prodotto dati:

   1. Abilitare Purview se si sta integrando con Microsoft Purview. Selezionare la sottoscrizione per l'account Purview, selezionare l'account Purview e immettere l'ID raccolta Purview.
   2. Abilitare la chiave gestita dal cliente se si usa la chiave gestita dal cliente per la crittografia dei dati.
   3. Selezionare l'identità gestita assegnata dall'utente configurata come prerequisito.
   4. Incollare con attenzione l'URI dell'identificatore di chiave creato durante la configurazione di Azure Key Vault come prerequisito.

6. Per aggiungere uno o più proprietari per il prodotto dati, che verrà visualizzato anche in Microsoft Purview, selezionare Aggiungi proprietario, immettere l'indirizzo di posta elettronica e selezionare Aggiungi proprietari.

7. Nella scheda Tag della pagina Crea un prodotto dati selezionare o immettere la coppia nome/valore usata per classificare la risorsa Data Product.

8. Selezionare Rivedi e crea.

9. Seleziona Crea. L'istanza del prodotto dati viene creata in circa 20-25 minuti. Durante questo periodo, viene effettuato il provisioning di tutti i componenti sottostanti. Al termine di questo processo, è possibile usare l'inserimento dati, esplorare dashboard e query di esempio e così via.

Interfaccia della riga di comando di Azure

Per creare un prodotto dati di Informazioni dettagliate operatori di Azure con i parametri minimi obbligatori, usare il comando seguente:

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

Usare i valori seguenti per <ProductName> e <ProductMajorVersion>.

Data prodotto	<ProductName>	<ProductMajorVersion>
Qualità dell'esperienza - McC GIGW affermata	Quality of Experience - Affirmed MCC GIGW	1.0
Qualità dell'esperienza - MCC PGW o GGSN affermati	Quality of Experience - Affirmed MCC PGW or GGSN	1.0
Monitoraggio - McC confermato	Monitoring - Affirmed MCC	0 oppure 1

Per creare un dataproduct di Informazioni dettagliate operatori di Azure con tutti i parametri, usare il comando seguente:

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"}'

Distribuire informazioni dettagliate di esempio

Dopo aver creato l'istanza del prodotto dati, è possibile distribuire un dashboard di informazioni dettagliate di esempio. Questo dashboard funziona con i dati di esempio che sono stati associati all'istanza del prodotto dati.

1. Passare alla risorsa Prodotto dati nella portale di Azure e selezionare la scheda Autorizzazioni nella sezione Sicurezza.
2. Selezionare Aggiungi lettore. Digitare l'indirizzo di posta elettronica dell'utente da aggiungere al ruolo Lettore prodotto dati.

Nota

Il ruolo lettore è necessario per avere accesso all'URL di utilizzo delle informazioni dettagliate.

3. Scaricare il file di modello JSON di esempio per il dashboard del prodotto dati:
   • Qualità dell'esperienza - Confermato MCC GIGW: https://go.microsoft.com/fwlink/p/?linkid=2254536
   • Monitoraggio - McC confermato: https://go.microsoft.com/fwlink/p/?linkid=2254551
4. Copiare l'URL di consumo dalla schermata Panoramica del prodotto dati negli Appunti.
5. Aprire un Web browser, incollare l'URL e selezionare INVIO.
6. Quando l'URL viene caricato, selezionare l'opzione Dashboard nel riquadro di spostamento a sinistra.
7. Selezionare l'elenco a discesa Nuovo dashboard e selezionare Importa dashboard da file. Passare a selezionare il file JSON scaricato in precedenza, specificare un nome per il dashboard e selezionare Crea.
8. Selezionare i tre puntini (...) nell'angolo superiore destro della pagina dell'URL di consumo e selezionare Origini dati.
9. Selezionare l'icona a forma di matita accanto al nome dell'origine dati per modificare l'origine dati.
10. Nella sezione URI cluster sostituire l'URL con l'URL di consumo del prodotto dati e selezionare Connetti.
11. Nell'elenco a discesa Database selezionare il database. In genere, il nome del database corrisponde al nome dell'istanza del prodotto dati. Seleziona Applica.

Nota

Questi dashboard sono basati su dati sintetici e potrebbero non avere esempi completi o rappresentativi dell'esperienza reale.

Esplorare i dati di esempio con Kusto

L'URL di consumo consente anche di scrivere una query Kusto personalizzata per ottenere informazioni dettagliate dai dati.

1. Nella pagina Panoramica copiare l'URL di utilizzo e incollarlo in una nuova scheda del browser per visualizzare il database e l'elenco delle tabelle.

   

2. Usare il piano di query ADX per scrivere query Kusto.

   • Per Qualità dell'esperienza - McC GIGW affermativo, provare le query seguenti:

     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
     

   • Per il monitoraggio - Prodotto dati MCC confermato, provare le query seguenti:

     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
     

Facoltativamente, eliminare le risorse di Azure

Se si usa questo prodotto dati per esplorare Azure Operator Insights, è necessario eliminare le risorse create per evitare i costi di Azure non necessari.

Portale

1. Nella home page del portale di Azure selezionare Gruppi di risorse.
2. Selezionare il gruppo di risorse per il prodotto Azure Operator Insights Data Product e verificare che contenga l'istanza di Azure Operator Insights Data Product.
3. Nella parte superiore della pagina Panoramica per il gruppo di risorse selezionare Elimina gruppo di risorse.
4. Immettere il nome del gruppo di risorse per confermare l'eliminazione e selezionare Elimina.

Interfaccia della riga di comando di Azure

az group delete --name "ResourceGroup"

Passaggio successivo

Caricare i dati nel prodotto dati:

1. Leggere la documentazione relativa al prodotto dati per determinare i requisiti per l'inserimento.
2. Configurare una soluzione di inserimento:
   • Per usare l'agente di inserimento di Azure Operator Insights, installare e configurare l'agente.
   • Per usare Azure Data Factory, seguire Usare Azure Data Factory per inserire dati in un prodotto dati di Informazioni dettagliate operatori di Azure.