Creare risorse di Azure Time Series Insights Gen1 usando i modelli di Azure Resource Manager

Questo articolo descrive come creare e distribuire risorse di Azure Time Series Insights usando modelli di Azure Resource Manager, PowerShell e il provider di risorse di Azure Time Series Insights.

Azure Time Series Insights supporta le risorse seguenti:

Un modello di Resource Manager è un file JSON che definisce l'infrastruttura e la configurazione delle risorse in un gruppo di risorse. I documenti seguenti descrivono i file modello in modo più dettagliato:

• Distribuzione del modello di Azure Resource Manager
• Distribuire le risorse con i modelli di Azure Resource Manager e Azure PowerShell
• Tipi di risorsa Microsoft.TimeSeriesInsights

Il modello di avvio rapido timeseriesinsights-environment-with-eventhub viene pubblicato in GitHub. Questo modello crea un ambiente Azure Time Series Insights, un'origine evento figlio configurata per l'utilizzo di eventi da un hub eventi e criteri di accesso che concedono l'accesso ai dati dell'ambiente. Se non è specificato un hub eventi esistente, ne verrà creato uno con la distribuzione.

Specificare i parametri e il modello di distribuzione

La procedura seguente descrive come usare PowerShell per distribuire un modello di Azure Resource Manager che crea un ambiente Azure Time Series Insights, un'origine evento figlio configurata per l'utilizzo di eventi da un hub eventi e criteri di accesso che concedono l'accesso ai dati dell'ambiente. Se non è specificato un hub eventi esistente, ne verrà creato uno con la distribuzione.

1. Installare Azure PowerShell seguendo le istruzioni riportate in Introduzione ai cmdlet di Azure PowerShell.

2. Clonare o copiare il modello timeseriesinsights-environment-with-eventhub da GitHub.

   • Creare un file di parametri

     Per creare un file di parametri, copiare il file timeseriesinsights-environment-with-eventhub .

     {
       "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
       "contentVersion": "1.0.0.0",
       "parameters": {
           "eventHubNamespaceName": {
               "value": "GEN-UNIQUE"
           },
           "eventHubName": {
               "value": "GEN-UNIQUE"
           },
           "consumerGroupName": {
               "value": "GEN-UNIQUE"
           },
           "environmentName": {
             "value": "GEN-UNIQUE"
           },
           "eventSourceName": {
             "value": "GEN-UNIQUE"
           }
       }
     }
     

   • Parametri necessari

     Parametro	Descrizione
     eventHubNamespaceName	Lo spazio dei nomi dello hub eventi di origine.
     eventHubName	Il nome dello hub eventi di origine.
     consumerGroupName	Nome del gruppo di consumer che verrà usato dal servizio Azure Time Series Insights per leggere i dati dall'hub eventi. NOTA: per evitare conflitti di risorse, questo gruppo di consumer deve essere dedicato al servizio Azure Time Series Insights e non condiviso con altri lettori.
     environmentName	Il nome dell'ambiente. Il nome non può includere i caratteri seguenti: <, >, %, &, :, \\, ?, /, né caratteri di controllo. Sono consentiti tutti gli altri caratteri.
     eventSourceName	Specificare il nome della risorsa figlio dell'origine evento. Il nome non può includere i caratteri seguenti: <, >, %, &, :, \\, ?, /, né caratteri di controllo. Sono consentiti tutti gli altri caratteri.

   • Parametri facoltativi

     Parametro	Descrizione
     existingEventHubResourceId	ID risorsa facoltativo di un hub eventi esistente che verrà connesso all'ambiente Azure Time Series Insights tramite l'origine evento. NOTA: l'utente che distribuisce il modello deve disporre delle autorizzazioni necessarie per eseguire l'operazione listkey nell'hub eventi di origine. Se non viene superato alcun valore, verrà creato un nuovo hub eventi dal modello.
     environmentDisplayName	Un nome descrittivo facoltativo da visualizzare nelle interfacce degli strumenti o utente al posto del nome dell'ambiente.
     environmentSkuName	Il nome dello SKU. Per altre informazioni, vedere la pagina dei prezzi di Azure Time Series Insights.
     environmentSkuCapacity	La capacità unità dello Sku. Per altre informazioni, vedere la pagina dei prezzi di Azure Time Series Insights.
     environmentDataRetentionTime	L'intervallo di tempo minimo per gli eventi dell'ambiente sarà disponibile per la query. Il valore deve essere specificato nel formato ISO 8601, ad esempio P30D per i criteri di conservazione di 30 giorni.
     eventSourceDisplayName	Un nome descrittivo facoltativo da visualizzare nelle interfacce degli strumenti o utente al posto del nome dell'origine evento.
     eventSourceTimestampPropertyName	La proprietà di evento che verrà usata come timestamp dell'origine evento. Se non è specificato un valore per timestampPropertyName o se viene specificato null o una stringa vuota, verrà usata l'ora di creazione dell'evento.
     eventSourceKeyName	Nome della chiave di accesso condiviso che verrà usata dal servizio Azure Time Series Insights per connettersi all'hub eventi.
     accessPolicyReaderObjectIds	Elenco di ID oggetto degli utenti o delle applicazioni in Microsoft Entra ID che devono avere accesso reader all'ambiente. L'objectId dell'entità servizio può essere ottenuto chiamando il cmdlet Get-AzADUser o Get-AzADServicePrincipal. La creazione di un criterio di accesso per i gruppi di Microsoft Entra non è ancora supportata.
     accessPolicyContributorObjectIds	Elenco di ID oggetto degli utenti o delle applicazioni in Microsoft Entra ID che devono avere accesso collaboratore all'ambiente. L'objectId dell'entità servizio può essere ottenuto chiamando il cmdlet Get-AzADUser o Get-AzADServicePrincipal. La creazione di un criterio di accesso per i gruppi di Microsoft Entra non è ancora supportata.

   • Ad esempio, per creare un ambiente verrebbe usato il file dei parametri seguente e un'origine evento che legge gli eventi da un hub eventi esistente. Crea inoltre due criteri di accesso che concedono l'accesso per i collaboratori all'ambiente.

     {
         "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
         "contentVersion": "1.0.0.0",
         "parameters": {
             "eventHubNamespaceName": {
                 "value": "tsiTemplateTestNamespace"
             },
             "eventHubName": {
                 "value": "tsiTemplateTestEventHub"
             },
             "consumerGroupName": {
                 "value": "tsiTemplateTestConsumerGroup"
             },
             "environmentName": {
                 "value": "tsiTemplateTestEnvironment"
             },
             "eventSourceName": {
                 "value": "tsiTemplateTestEventSource"
             },
             "existingEventHubResourceId": {
                 "value": "/subscriptions/{yourSubscription}/resourceGroups/MyDemoRG/providers/Microsoft.EventHub/namespaces/tsiTemplateTestNamespace/eventhubs/tsiTemplateTestEventHub"
             },
             "accessPolicyContributorObjectIds": {
                 "value": [
                     "AGUID001-0000-0000-0000-000000000000",
                     "AGUID002-0000-0000-0000-000000000000"
                 ]
             }
         }
     }
     

   • Per altre informazioni, leggere l'articolo Parametri.

Distribuire il modello di avvio rapido in locale tramite PowerShell

1. In PowerShell accedere all'account Azure.

   • Al prompt di PowerShell, eseguire il comando seguente:

     Connect-AzAccount
     

   • Il sistema chiede di accedere all'account Azure. Dopo l'accesso, eseguire il comando seguente per visualizzare le sottoscrizioni disponibili:

     Get-AzSubscription
     

   • Questo comando restituisce un elenco delle sottoscrizioni di Azure disponibili. Scegliere una sottoscrizione per la sessione corrente eseguendo il comando seguente. Sostituire <YourSubscriptionId> con il GUID della sottoscrizione di Azure che si vuole usare:

     Set-AzContext -SubscriptionID <YourSubscriptionId>
     

2. Se non esiste, creare un nuovo gruppo di risorse.

   • Se non è disponibile un gruppo di risorse esistente, creare un nuovo gruppo di risorse con il comando New-AzResourceGroup. Specificare il nome del gruppo di risorse e la posizione che si vuole usare, Ad esempio:

     New-AzResourceGroup -Name MyDemoRG -Location "West US"
     

   • Se il nuovo gruppo di risorse è stato creato correttamente, viene visualizzato il relativo riepilogo.

     ResourceGroupName : MyDemoRG
     Location          : westus
     ProvisioningState : Succeeded
     Tags              :
     ResourceId        : /subscriptions/<GUID>/resourceGroups/MyDemoRG
     

3. Testare la distribuzione.

   • Convalidare la distribuzione eseguendo il cmdlet Test-AzResourceGroupDeployment. Durante il test della distribuzione, specificare esattamente gli stessi parametri di quando si esegue la distribuzione.

     Test-AzResourceGroupDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
     

4. Creare la distribuzione

   • Per creare la nuova distribuzione, eseguire il cmdlet New-AzResourceGroupDeployment e specificare i parametri necessari quando viene richiesto. I parametri includono il nome della distribuzione, il nome del gruppo di risorse e il percorso o l'URL del file di modello. Se il parametro Mode non è specificato, viene usato il valore predefinito Incremental. Per altre informazioni, leggere Distribuzioni incrementali e complete.

   • Il comando seguente richiede cinque parametri obbligatori nella finestra di PowerShell:

     New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
     

   • Per specificare invece un file di parametri, usare il comando seguente:

     New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
     

   • È anche possibile usare i parametri inline quando si esegue il cmdlet di distribuzione. Il comando è il seguente:

     New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -parameterName "parameterValue"
     

   • Per eseguire una distribuzione completa, impostare il parametro Mode su Complete:

     New-AzResourceGroupDeployment -Name MyDemoDeployment -Mode Complete -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
     

5. Verificare la distribuzione

   • Se le risorse vengono distribuite correttamente, nella finestra di PowerShell viene visualizzato il riepilogo della distribuzione:

      DeploymentName          : MyDemoDeployment
      ResourceGroupName       : MyDemoRG
      ProvisioningState       : Succeeded
      Timestamp               : 10/11/2019 3:20:37 AM
      Mode                    : Incremental
      TemplateLink            :
      Parameters              :
                                Name                                Type                       Value
                                ==================================  =========================  ==========
                                eventHubNewOrExisting               String                     new
                                eventHubResourceGroup               String                     MyDemoRG
                                eventHubNamespaceName               String                     tsiquickstartns
                                eventHubName                        String                     tsiquickstarteh
                                consumerGroupName                   String                     tsiquickstart
                                environmentName                     String                     tsiquickstart
                                environmentDisplayName              String                     tsiquickstart
                                environmentSkuName                  String                     S1
                                environmentSkuCapacity              Int                        1
                                environmentDataRetentionTime        String                     P30D
                                eventSourceName                     String                     tsiquickstart
                                eventSourceDisplayName              String                     tsiquickstart
                                eventSourceTimestampPropertyName    String
                                eventSourceKeyName                  String                     manage
                                accessPolicyReaderObjectIds         Array                      []
                                accessPolicyContributorObjectIds    Array                      []
                                location                            String                     westus
     
      Outputs                 :
                                 Name              Type                       Value
                                 ================  =========================  ==========
                                 dataAccessFQDN    String
                                 11aa1aa1-a1aa-1a1a-a11a-aa111a111a11.env.timeseries.azure.com
     
      DeploymentDebugLogLevel :
     

6. Distribuire il modello di avvio rapido tramite il portale di Azure

   • La home page del modello di avvio rapido GitHub include inoltre il Distribuisci in Azure. Facendo clic su di esso si apre la pagina Distribuzione personalizzata nel portale di Azure. In questa pagina, è possibile immettere o selezionare i valori per ognuno dei parametri dalle tabelle dei parametri obbligatori o dei parametri facoltativi. Dopo aver immesso le impostazioni, facendo clic sul pulsante Acquisto si avvierà la distribuzione del modello.

Passaggi successivi

• Per informazioni sulla gestione a livello di codice delle risorse di Azure Time Series Insights tramite le API REST, vedere Gestione di Azure Time Series Insights.