Share via

Créer des ressources Azure Time Series Insights Gen1 à l’aide de modèles Resource Manager

  • Article

Remarque

Le service Time Series Insights (TSI) ne sera plus pris en charge après le mois de mars 2025. Pensez à migrer dès que possible les environnements TSI existants vers d’autres solutions. Pour plus d’informations sur la dépréciation et la migration, consultez notre documentation.

Attention

Il s’agit d’un article Gen1.

Cet article explique comment créer et déployer des ressources Azure Time Series Insights à l’aide de modèles Resource Manager, de PowerShell et du fournisseur de ressources Azure Time Series Insights.

Azure Time Series Insights prend en charge les ressources suivantes :

Ressource Description
Environnement Un environnement Azure Time Series Insights est un regroupement logique d’événements lus à partir de répartiteurs, stockés et rendus interrogeables. Pour plus d’informations, consultez Planifier votre environnement Azure Time Series Insights
Source de l'événement Une source d’événement est une connexion à un répartiteur d’événements à partir duquel Azure Time Series Insights lit et ingère des événements dans l’environnement. Sont actuellement pris en charge IoT Hub et Event Hub.
Jeu de données de référence Les jeux de données de référence fournissent des métadonnées sur les événements de l’environnement. Les métadonnées des jeux de données de référence seront jointes à des événements au cours de l’entrée. Les jeux de données de référence sont définis comme des ressources par leurs propriétés de clé d’événement. Les métadonnées qui composent le jeu de données de référence sont chargées ou modifiées par le biais d’API de plan de données.
Stratégie d’accès Les stratégies d’accès accordent l’autorisation de générer des requêtes de données, de manipuler les données de référence dans l’environnement et de partager des requêtes enregistrées et des perspectives associées à l’environnement. Pour plus d’informations, consultez Accorder l’accès aux données à un environnement Azure Time Series Insights à l’aide du portail Azure.

Un modèle Resource Manager est un fichier JSON qui définit l’infrastructure et la configuration de ressources dans un groupe de ressources. Les documents suivants décrivent plus en détail les fichiers modèles :

Le modèle de démarrage rapide timeseriesinsights-environment-with-eventhub est publié sur GitHub. Il crée un environnement Azure Time Series Insights, une source d’événement enfant configurée pour consommer des événements à partir d’un Event Hub et des stratégies qui accordent l’accès aux données de l’environnement. Si aucun hub d’événements existant n’est spécifié, il en sera créé un avec le déploiement.

Remarque

Nous vous recommandons d’utiliser le module Azure Az PowerShell pour interagir avec Azure. Pour commencer, consultez Installer Azure PowerShell. Pour savoir comment migrer vers le module Az PowerShell, consultez Migrer Azure PowerShell depuis AzureRM vers Az.

Spécifier le modèle et les paramètres de déploiement

La procédure suivante explique comment utiliser PowerShell pour déployer un modèle Resource Manager qui crée un environnement Azure Time Series Insights, une source d’événement enfant configurée pour consommer des événements à partir d’un Event Hub et des stratégies qui accordent l’accès aux données de l’environnement. Si aucun hub d’événements existant n’est spécifié, il en sera créé un avec le déploiement.

  1. Installez Azure PowerShell en suivant les instructions disponibles dans Prise en main d’Azure PowerShell.

  2. Clonez ou copiez le modèle timeseriesinsights-environment-with-eventhub sur GitHub.

    • Créer un fichier de paramètres

      Pour créer un fichier de paramètres, copiez le fichier 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"
      }
  }
}

    • Paramètres obligatoires

      Paramètre Description
      eventHubNamespaceName Espace de noms du hub de la source de l’événement.
      eventHubName Nom du hub de la source de l’événement.
      consumerGroupName Nom du groupe de consommateurs que le service Azure Time Series Insights utilisera pour lire les données à partir de l’Event Hub. REMARQUE : pour éviter la contention de ressources, ce groupe de consommateurs doit être dédié au service Azure Time Series Insights et ne doit pas être partagé avec d’autres lecteurs.
      environmentName Nom de l’environnement. Le nom ne peut pas contenir : <, >, %, &, :, \\, ?, /, ni aucun caractère de contrôle. Tous les autres caractères sont autorisés.
      eventSourceName Nom de la ressource enfant de la source de l’événement. Le nom ne peut pas contenir : <, >, %, &, :, \\, ?, /, ni aucun caractère de contrôle. Tous les autres caractères sont autorisés.

    • Paramètres facultatifs

      Paramètre Description
      existingEventHubResourceId ID de ressource facultatif d’un Event Hub existant qui sera connecté à l’environnement Azure Time Series Insights par le biais de la source de l’événement. REMARQUE : L’utilisateur qui déploie le modèle doit avoir des privilèges pour réaliser l’opération listkeys sur le hub d’événements. Si aucune valeur n’est transmise, un nouveau hub d’événements sera créé par le modèle.
      environmentDisplayName Nom convivial facultatif à afficher dans les outils et les interfaces utilisateur à la place du nom de l’environnement.
      environmentSkuName Nom du la référence SKU. Pour plus d’informations, consultez la page Tarification d’Azure Time Series Insights.
      environmentSkuCapacity Capacité unitaire de la référence SKU. Pour plus d’informations, consultez la page Tarification d’Azure Time Series Insights.
      environmentDataRetentionTime Période minimale durant laquelle les événements de l’environnement seront interrogeables. La valeur doit être spécifiée au format ISO 8601, par exemple, P30D pour une stratégie de rétention de 30 jours.
      eventSourceDisplayName Nom convivial facultatif à afficher dans les outils et les interfaces utilisateur à la place du nom de la source de l’événement.
      eventSourceTimestampPropertyName Propriété de l’événement qui sera utilisée comme horodateur de la source de l’événement. Si aucune valeur n’est spécifiée pour timestampPropertyName, ou si la valeur Null ou une chaîne vide est spécifiée, l’heure de création de l’événement sera utilisée.
      eventSourceKeyName Nom de la clé d’accès partagé que le service Azure Time Series Insights utilisera pour se connecter à l’Event Hub.
      accessPolicyReaderObjectIds Une liste des ID objet des utilisateurs et des applications dans Microsoft Entra ID qui doivent avoir l’accès Lecteur à l’environnement. L’ID objet du principal du service s’obtient en appelant la cmdlet Get-AzADUser ou la cmdlet Get-AzADServicePrincipal. La création d’une stratégie d’accès n’est pas encore prise en charge pour les groupes Microsoft Entra.
      accessPolicyContributorObjectIds Une liste des ID objet des utilisateurs et des applications dans Microsoft Entra ID qui doivent avoir l’accès Contributeur à l’environnement. L’ID objet du principal du service s’obtient en appelant la cmdlet Get-AzADUser ou la cmdlet Get-AzADServicePrincipal. La création d’une stratégie d’accès n’est pas encore prise en charge pour les groupes Microsoft Entra.

    • Par exemple, le fichier de paramètres suivant serait utilisé pour créer un environnement et une source d’événement qui lirait les événements à partir d’un hub d’événements existant. Il crée également deux stratégies qui accordent l’accès Collaborateur à l’environnement.

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

    • Pour plus d’informations, consultez l’article Paramètres.

Déployer le modèle de démarrage rapide localement avec PowerShell

Important

Les opérations de ligne de commande affichées ci-dessous décrivent le Module Az PowerShell.

  1. Dans PowerShell, connectez-vous à votre compte Azure.

    • À partir d’une invite de commandes PowerShell, exécutez la commande suivante :

      Connect-AzAccount

    • Vous êtes invité à ouvrir une session sur votre compte Azure. Une fois connecté, exécutez la commande suivante pour afficher vos abonnements disponibles :

      Get-AzSubscription

    • Cette commande renvoie la liste des abonnements Azure disponibles. Choisissez un abonnement pour la session en cours en exécutant la commande suivante. Remplacez <YourSubscriptionId> par le GUID de l’abonnement Azure que vous souhaitez utiliser :

      Set-AzContext -SubscriptionID <YourSubscriptionId>

  2. Créez un groupe de ressources s'il n'en existe pas.

    • Si vous n’avez pas de groupe de ressources, créez-en un avec la commande New-AzResourceGroup. Indiquez le nom du groupe de ressources et l'emplacement que vous souhaitez utiliser. Par exemple :

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

    • En cas de réussite, un résumé du nouveau groupe de ressources s’affiche.

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

  3. Testez le déploiement.

    • Validez votre déploiement en exécutant l’applet de commande Test-AzResourceGroupDeployment. Lorsque vous testez le déploiement, indiquez les paramètres exactement comme vous le feriez lors de l'exécution du déploiement.

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

  4. Créer le déploiement

    • Pour créer le déploiement, exécutez l’applet de commande New-AzResourceGroupDeployment et indiquez les paramètres nécessaires quand vous y êtes invité. Les paramètres incluent un nom pour votre déploiement, le nom de votre groupe de ressources, le chemin d’accès ou l’URL du fichier de modèle. Si le paramètre Mode n’est pas spécifié, la valeur par défaut Incremental est utilisée. Pour plus d’informations, consultez Déploiements incrémentiels et complets.

    • La commande suivante vous invite à entrer les cinq paramètres requis dans la fenêtre PowerShell :

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

    • Pour spécifier un fichier de paramètres à la place, utilisez la commande suivante :

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

    • Vous pouvez également utiliser des paramètres inclus lorsque vous exécutez l'applet de commande de déploiement. La commande est la suivante :

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

    • Pour exécuter un déploiement complet, affectez la valeur Complet au paramètre Mode :

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

  5. Vérifier le déploiement

    • Si les ressources sont déployées avec succès, un résumé du déploiement s’affiche dans la fenêtre PowerShell :

       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. Déployer le modèle de démarrage rapide sur le Portail Azure

    • La page d’accueil du modèle de démarrage rapide sur GitHub comporte également un bouton Déployer sur Azure. Il ouvre une page Déploiement personnalisé sur le Portail Azure. Sur cette page, vous pouvez entrer ou sélectionner des valeurs pour chacun des paramètres des tables Paramètres requis et Paramètres facultatifs. Après avoir rempli les paramètres, cliquez sur le bouton Acheter pour lancer le déploiement du modèle.

Bouton Déployer sur Azure

Étapes suivantes