Dela via

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

  • Artikel

Kommentar

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.

Varning

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
Environment 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 hjälp av 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.

Kommentar

Vi rekommenderar att du använder Azure Az PowerShell-modulen för att interagera med Azure. Information om hur du kommer igång finns i Installera Azure PowerShell. Information om hur du migrerar till Az PowerShell-modulen finns i artikeln om att 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.

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

  2. 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 Description
      eventHubNamespaceName Namnområdet för källhändelsehubben.
      eventHubName Namnet på källhändelsehubben.
      consumerGroupName 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.
      environmentName Namnet på miljön. Namnet kan inte innehålla: <, >, %, &, :, \\, ?, /och några kontrolltecken. Alla andra tecken tillåts.
      eventSourceName Namnet på den underordnade resursen för händelsekällan. Namnet kan inte innehålla: <, >, %, &, :, \\, ?, /och några kontrolltecken. Alla andra tecken tillåts.

    • Valfria parametrar

      Parameter Description
      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 listkeys-åtgärden på händelsehubben. Om inget värde skickas skapas en ny händelsehubb av mallen.
      environmentDisplayName Ett valfritt eget namn som ska visas i verktyg eller användargränssnitt i stället för miljönamnet.
      environmentSkuName Namnet på SKU:n. Mer information finns på sidan priser för Azure Time Series Insights.
      environmentSkuCapacity Enhetskapaciteten för SKU:n. Mer information finns på sidan priser för Azure Time Series Insights.
      environmentDataRetentionTime Det minsta tidsintervallet för miljöns händelser är tillgängligt för frågor. Värdet måste anges i FORMATET ISO 8601, till exempel P30D för en kvarhållningsprincip på 30 dagar.
      eventSourceDisplayName Ett valfritt eget namn som ska visas i verktyg eller användargränssnitt i stället för händelsekällans namn.
      eventSourceTimestampPropertyName 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.
      eventSourceKeyName Namnet på den delade åtkomstnyckel som Azure Time Series Insights-tjänsten använder för att ansluta till händelsehubben.
      accessPolicyReaderObjectIds En lista över objekt-ID:t 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 Parametrar .

Distribuera snabbstartsmallen lokalt med PowerShell

Viktigt!

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

  1. 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>

  2. 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

  3. 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

  4. 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 att göra 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 har angetts används standardvärdet för Inkrementell . Mer information finns i Inkrementella 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 Läge till Slutför:

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

  5. Verifiera distributionen

    • 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 :

  6. Distribuera snabbstartsmallen via Azure-portalen

    • Snabbstartsmallens startsida på GitHub innehåller även 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 parametertabellerna . När du har fyllt i inställningarna initierar du malldistributionen genom att klicka på knappen Köp .

Knappen Distribuera till Azure

Nästa steg