Skapa Azure Time Series Insights Gen 1-resurser med hjälp av Azure Resource Manager-mallar

Artikel
2020-09-30

Notera

Time Series Insights-tjänsten dras tillbaka den 7 juli 2024. Överväg att migrera befintliga miljöer till alternativa lösningar så snart som möjligt. Mer information om utfasning och migrering finns i vår dokumentation.

Försiktighet

Det här är en artikel i Gen1.

Den här artikeln beskriver hur du skapar och distribuerar Azure Time Series Insights-resurser med hjälp av Azure Resource Manager-mallar, PowerShell och Azure Time Series Insights-resursprovidern.

Azure Time Series Insights stöder följande resurser:

Resurs	Beskrivning
Miljö	En Azure Time Series Insights-miljö är en logisk gruppering av händelser som läss från händelseköer, lagras och görs tillgängliga för frågor. Mer information finns i Planera din Azure Time Series Insights-miljö
Händelsekälla	En händelsekälla är en anslutning till en händelsekö från vilken Azure Time Series Insights läser och matar in händelser i miljön. Händelsekällor som stöds för närvarande är IoT Hub och Event Hub.
Referensdatauppsättning	Referensdatauppsättningar ger metadata om händelserna i miljön. Metadata i referensdatauppsättningarna kopplas till händelser under ingressen. Referensdatauppsättningar definieras som resurser med hjälp av deras egenskaper för händelsenyckeln. De faktiska metadata som utgör referensdatauppsättningen laddas upp eller ändras via API:er för dataplanet.
Åtkomstprincip	Åtkomstprinciper ger behörighet att utfärda datafrågor, ändra referensdata i miljön och dela sparade frågor och perspektiv som är associerade med miljön. Mer information finns i Bevilja dataåtkomst till en Azure Time Series Insights-miljö med azure-portalen

En Resource Manager-mall är en JSON-fil som definierar infrastrukturen och konfigurationen av resurser i en resursgrupp. Följande dokument beskriver mallfiler i detalj:

Snabbstartsmallen timeseriesinsights-environment-with-eventhub publiceras på GitHub. Den här mallen skapar en Azure Time Series Insights-miljö, en underordnad händelsekälla som konfigurerats för att använda händelser från en händelsehubb och åtkomstprinciper som ger åtkomst till miljöns data. Om en befintlig händelsehubb inte har angetts skapas en med distributionen.

Anteckning

Vi rekommenderar att du använder Azure Az PowerShell-modulen för att interagera med Azure. Kom igång genom att läsa Installera Azure PowerShell. Information om hur du migrerar till Az PowerShell-modulen finns i Migrera Azure PowerShell från AzureRM till Az.

Ange distributionsmall och parametrar

Följande procedur beskriver hur du använder PowerShell för att distribuera en Azure Resource Manager-mall som skapar en Azure Time Series Insights-miljö, en underordnad händelsekälla som konfigurerats för att använda händelser från en händelsehubb och åtkomstprinciper som ger åtkomst till miljöns data. Om en befintlig händelsehubb inte har angetts skapas en med distributionen.

Installera Azure PowerShell genom att följa anvisningarna i Komma igång med Azure PowerShell.

Klona eller kopiera mallen timeseriesinsights-environment-with-eventhub från GitHub.

Skapa en parameterfil

Om du vill skapa en parameterfil kopierar du filen 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"
      }
  }
}

Obligatoriska parametrar

Parameter	Beskrivning
eventHubNamespaceName	Namnområdet för källhändelsehubben.
eventHubName	Namnet på källhändelsehubben.
konsumentgruppenamn	Namnet på den konsumentgrupp som Azure Time Series Insights-tjänsten ska använda för att läsa data från händelsehubben. OBS! För att undvika resurskonkurrering måste den här konsumentgruppen vara dedikerad till Azure Time Series Insights-tjänsten och inte delas med andra läsare.
miljönamn	Namnet på miljön. Namnet kan inte innehålla: `<`, `>`, `%`, `&`, `:`, `\\`, `?`, `/`och eventuella kontrolltecken. Alla andra tecken tillåts.
händelsekällansNamn	Namnet på barnresursen för händelsekällan. Namnet kan inte innehålla: `<`, `>`, `%`, `&`, `:`, `\\`, `?`, `/`och eventuella kontrolltecken. Alla andra tecken tillåts.

Valfria parametrar

Parameter	Beskrivning
existingEventHubResourceId	Ett valfritt resurs-ID för en befintlig händelsehubb som ska anslutas till Azure Time Series Insights-miljön via händelsekällan. OBS! Användaren som distribuerar mallen måste ha behörighet att utföra åtgärden listkeys på händelsehubben. Om inget värde skickas skapas en ny händelsehubb av mallen.
miljövisningsnamn	Ett valfritt vänligt namn som ska visas i verktyg eller användargränssnitt i stället för miljönamnet.
environmentSkuName	Namnet på SKU:n. För mer information, läs sidan Prissättning för Azure Time Series Insights.
environmentSkuCapacity	Enhetskapaciteten för SKU:n. För mer information, läs sidan Prissättning för Azure Time Series Insights.
miljödataretentionstid	Det minsta tidsintervallet för miljöns händelser är tillgängligt för frågor. Värdet måste anges i ISO 8601-format, till exempel `P30D` för en kvarhållningsprincip på 30 dagar.
namn på händelsekälla	Ett valfritt eget namn som ska visas i verktyg eller användargränssnitt i stället för händelsekällans namn.
händelseKällaTidsstämpelEgenskapsNamn	Händelseegenskapen som ska användas som händelsekällans tidsstämpel. Om ett värde inte har angetts för timestampPropertyName, eller om null eller tom sträng har angetts, används tiden för att skapa händelsen.
eventKällartNyckelNamn	Namnet på den delade åtkomstnyckel som Azure Time Series Insights-tjänsten använder för att ansluta till händelsehubben.
åtkomstpolicyläsarobjekt-ID:er	En lista över objekt-ID:n för användare eller program i Microsoft Entra ID som ska ha läsaråtkomst till miljön. ObjectId för tjänstens huvudnamn kan hämtas genom att anropa cmdletarna Get-AzADUser eller Get-AzADServicePrincipal. Det finns ännu inte stöd för att skapa en åtkomstprincip för Microsoft Entra-grupper.
accessPolicyContributorObjectIds	En lista över objekt-ID:t för användare eller program i Microsoft Entra-ID som ska ha deltagaråtkomst till miljön. ObjectId för tjänstens huvudnamn kan hämtas genom att anropa cmdletarna Get-AzADUser eller Get-AzADServicePrincipal. Det finns ännu inte stöd för att skapa en åtkomstprincip för Microsoft Entra-grupper.

Till exempel skulle följande parameterfil användas för att skapa en miljö och en händelsekälla som läser händelser från en befintlig händelsehubb. Den skapar också två åtkomstprinciper som ger deltagare åtkomst till miljön.

{
    "$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"
            ]
        }
    }
}

Mer information finns i artikeln Parameters.

Distribuera snabbstartsmallen lokalt med PowerShell

Viktig

De kommandoradsåtgärder som visas nedan beskriver Az PowerShell-modulen.

Logga in på ditt Azure-konto i PowerShell.
- Kör följande kommando från en PowerShell-prompt:
```
Connect-AzAccount
```
- Du uppmanas att logga in på ditt Azure-konto. När du har loggat in kör du följande kommando för att visa dina tillgängliga prenumerationer:
```
Get-AzSubscription
```
- Det här kommandot returnerar en lista över tillgängliga Azure-prenumerationer. Välj en prenumeration för den aktuella sessionen genom att köra följande kommando. Ersätt <YourSubscriptionId> med GUID för den Azure-prenumeration som du vill använda:
```
Set-AzContext -SubscriptionID <YourSubscriptionId>
```
Skapa en ny resursgrupp om den inte finns.
- Om du inte har någon befintlig resursgrupp skapar du en ny resursgrupp med kommandot New-AzResourceGroup. Ange namnet på den resursgrupp och plats som du vill använda. Till exempel:
```
New-AzResourceGroup -Name MyDemoRG -Location "West US"
```
- Om det lyckas visas en sammanfattning av den nya resursgruppen.
```
ResourceGroupName : MyDemoRG
Location          : westus
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/<GUID>/resourceGroups/MyDemoRG
```

Testa distributionen.

Verifiera distributionen genom att köra cmdleten Test-AzResourceGroupDeployment. När du testar distributionen anger du parametrar precis som när du kör distributionen.

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

Skapa distributionen
- Om du vill skapa den nya distributionen kör du cmdleten New-AzResourceGroupDeployment och anger nödvändiga parametrar när du uppmanas till det. Parametrarna innehåller ett namn för distributionen, namnet på resursgruppen och sökvägen eller URL:en till mallfilen. Om parametern Läge inte anges används standardvärdet för Inkrement. Mer information finns i stegvisa och fullständiga distributioner.
- Följande kommando uppmanar dig att ange de fem obligatoriska parametrarna i PowerShell-fönstret:
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
```
- Om du vill ange en parameterfil i stället använder du följande kommando:
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
```
- Du kan också använda infogade parametrar när du kör distributions-cmdleten. Kommandot är följande:
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -parameterName "parameterValue"
```
- Om du vill köra en fullständig distribution anger du parametern Mode till Complete:
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -Mode Complete -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
```

Verifiera utplaceringen

Om resurserna har distribuerats visas en sammanfattning av distributionen i PowerShell-fönstret:

 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 :

Distribuera snabbstartsmallen via Azure-portalen
- Snabbstartsmallens startsida på GitHub innehåller också knappen Distribuera till Azure. När du klickar på den öppnas en anpassad distributionssida i Azure-portalen. På den här sidan kan du ange eller välja värden för var och en av parametrarna från de obligatoriska parametrarna eller valfria parametrar tabeller. När du har fyllt i inställningarna initieras malldistributionen genom att klicka på knappen Köp.

Nästa steg

Information om hur du programmatiskt hanterar Azure Time Series Insights-resurser med hjälp av REST-API:er finns i Azure Time Series Insights Management.

Dela via

Skapa Azure Time Series Insights Gen 1-resurser med hjälp av Azure Resource Manager-mallar

Ange distributionsmall och parametrar

Distribuera snabbstartsmallen lokalt med PowerShell

Nästa steg

Ytterligare resurser