Creación de recursos de Azure Time Series Insights Gen 1 mediante plantillas de Azure Resource Manager

Artículo
09/30/2020

Nota

El servicio Time Series Insights se retirará el 7 de julio de 2024. Considere la posibilidad de migrar entornos existentes a soluciones alternativas lo antes posible. Para obtener más información sobre el desuso y la migración, visite nuestra documentación de .

Cautela

Este es un artículo de Gen1.

En este artículo se describe cómo crear e implementar recursos de Azure Time Series Insights mediante plantillas de Azure Resource Manager, PowerShell y el proveedor de recursos de Azure Time Series Insights.

Azure Time Series Insights admite los siguientes recursos:

Recurso	Descripción
Medio ambiente	Un entorno de Azure Time Series Insights es una agrupación lógica de eventos que se leen desde agentes de eventos, se almacenan y están disponibles para la consulta. Para más información, consulte Planeamiento del entorno de Azure Time Series Insights
Origen del evento	Un origen de eventos es una conexión a un agente de eventos desde el que Azure Time Series Insights lee e ingiere eventos en el entorno. Los orígenes de eventos admitidos actualmente son IoT Hub y Event Hub.
Conjunto de datos de referencia	Los conjuntos de datos de referencia proporcionan metadatos sobre los eventos del entorno. Los metadatos de los conjuntos de datos de referencia se combinarán con eventos durante el ingreso. Los conjuntos de datos de referencia se definen como recursos mediante sus propiedades de clave de evento. Los metadatos reales que componen el conjunto de datos de referencia se cargan o modifican a través de las API del plano de datos.
Directiva de acceso	Las directivas de acceso conceden permisos para emitir consultas de datos, manipular datos de referencia en el entorno y compartir consultas guardadas y perspectivas asociadas al entorno. Para más información, consulte Concesión de acceso a datos a un entorno de Azure Time Series Insights mediante Azure Portal

Una plantilla de Resource Manager es un archivo JSON que define la infraestructura y la configuración de los recursos de un grupo de recursos. En los documentos siguientes se describen los archivos de plantilla con mayor detalle:

de implementación de plantillas de Azure Resource Manager
Implementación de recursos con plantillas de Resource Manager y Azure PowerShell
Tipos de recursos Microsoft.TimeSeriesInsights

La plantilla de inicio rápido TimeSeriesInsights-environment-with-eventhub se publica en GitHub. Esta plantilla crea un entorno de Azure Time Series Insights, un origen de eventos secundario configurado para consumir eventos de un centro de eventos y directivas de acceso que conceden acceso a los datos del entorno. Si no se especifica un centro de eventos existente, se creará uno con la implementación.

Nota

Se recomienda usar el módulo de PowerShell de Azure Az para interactuar con Azure. Para empezar, consulte Instalación de Azure PowerShell. Para obtener información sobre cómo migrar al módulo Az PowerShell, consulte Migración de Azure PowerShell de AzureRM a Az.

Especificar la plantilla de implementación y los parámetros

En el procedimiento siguiente se describe cómo usar PowerShell para implementar una plantilla de Azure Resource Manager que crea un entorno de Azure Time Series Insights, un origen de eventos secundario configurado para consumir eventos de un centro de eventos y directivas de acceso que conceden acceso a los datos del entorno. Si no se especifica un centro de eventos existente, se creará uno con la implementación.

Instale Azure PowerShell siguiendo las instrucciones de Introducción a Azure PowerShell.

Clone o copie la plantilla timeseriesinsights-environment-with-eventhub de GitHub.

Creación de un archivo de parámetros

Para crear un archivo de parámetros, copie el archivo 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"
      }
  }
}

Parámetros necesarios

Parámetro	Descripción
eventHubNamespaceName	Espacio de nombres del hub de eventos de origen.
nombreDelHubDeEventos	Nombre del centro de eventos de origen.
nombreDelGrupoDeConsumidores	Nombre del grupo de consumidores que usará el servicio Azure Time Series Insights para leer los datos del centro de eventos. NOTA: Para evitar la contención de recursos, este grupo de consumidores debe estar dedicado al servicio Azure Time Series Insights y no compartirlo con otros lectores.
nombreDelEntorno	Nombre del entorno. El nombre no puede incluir: `<`, `>`, `%`, `&`, `:`, `\\`, `?`, `/`y cualquier carácter de control. Se permiten todos los demás caracteres.
nombreFuenteEvento	Nombre del recurso secundario del origen del evento. El nombre no puede incluir: `<`, `>`, `%`, `&`, `:`, `\\`, `?`, `/`y cualquier carácter de control. Se permiten todos los demás caracteres.

Parámetros opcionales

Parámetro	Descripción
existingEventHubResourceId	Identificador de recurso opcional de un centro de eventos existente que se conectará al entorno de Azure Time Series Insights a través del origen del evento. NOTA: El usuario que implementa la plantilla debe tener privilegios para realizar la operación listkeys en el centro de eventos. Si no se pasa ningún valor, la plantilla creará un nuevo centro de eventos.
environmentDisplayName	Nombre opcional amigable que se mostrará en herramientas o interfaces de usuario en vez del nombre del entorno.
environmentSkuName	Nombre del SKU. Para más información, consulte la página de precios de Azure Time Series Insights.
environmentSkuCapacity	Capacidad de unidad de la SKU. Para más información, consulte la página de precios de Azure Time Series Insights.
tiempoDeRetenciónDeDatosDelEntorno	El intervalo mínimo de tiempo de los eventos del entorno estará disponible para la consulta. El valor debe especificarse en el formato ISO 8601, por ejemplo, `P30D` para una directiva de retención de 30 días.
nombreDeVisualizaciónDelOrigenDelEvento	Nombre amigable opcional que se mostrará en las herramientas o interfaces de usuario en lugar del nombre de origen del evento.
eventSourceTimestampPropertyName	Propiedad de evento que se usará como marca de tiempo del origen del evento. Si no se especifica un valor para timestampPropertyName o si se especifica null o empty-string, se usará la hora de creación del evento.
eventSourceKeyName	Nombre de la clave de acceso compartido que usará el servicio Azure Time Series Insights para conectarse al centro de eventos.
IdentificadoresDeObjetoDeLectorDePolíticaDeAcceso	Lista de identificadores de objeto de los usuarios o aplicaciones de Microsoft Entra ID que deben tener acceso lector al entorno. El objectId de la entidad de servicio se puede obtener llamando a los cmdlets Get-AzADUser o Get-AzADServicePrincipal. Todavía no se admite la creación de una directiva de acceso para grupos de Microsoft Entra.
accessPolicyContributorObjectIds	Lista de identificadores de objeto de los usuarios o aplicaciones de Microsoft Entra ID que deben tener acceso de colaborador al entorno. El objectId de la entidad de servicio se puede obtener llamando a los cmdlets Get-AzADUser o Get-AzADServicePrincipal. Todavía no se admite la creación de una directiva de acceso para grupos de Microsoft Entra.

Por ejemplo, el siguiente archivo de parámetros se usaría para crear un entorno y un origen de eventos que lea los eventos de un centro de eventos existente. También crea dos directivas de acceso que conceden acceso de colaborador al entorno.

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

Para obtener más información, lea el artículo Parámetros.

Implementación de la plantilla de inicio rápido localmente mediante PowerShell

Importante

Las operaciones de línea de comandos que se muestran a continuación describen el módulo Az de PowerShell.

En PowerShell, inicie sesión en su cuenta de Azure.
- Desde una consola de PowerShell, ejecute el siguiente comando:
```
Connect-AzAccount
```
- Se le pedirá que inicie sesión en su cuenta de Azure. Después de iniciar sesión, ejecute el siguiente comando para ver las suscripciones disponibles:
```
Get-AzSubscription
```
- Este comando devuelve una lista de suscripciones de Azure disponibles. Elija una suscripción para la sesión actual mediante la ejecución del comando siguiente. Reemplace <YourSubscriptionId> por el GUID de la suscripción de Azure que desea usar:
```
Set-AzContext -SubscriptionID <YourSubscriptionId>
```
Cree un nuevo grupo de recursos si no existe uno.
- Si no tiene un grupo de recursos existente, cree un nuevo grupo de recursos con el comando New-AzResourceGroup . Proporcione el nombre del grupo de recursos y la ubicación que desea usar. Por ejemplo:
```
New-AzResourceGroup -Name MyDemoRG -Location "West US"
```
- Si se ejecuta correctamente, se muestra un resumen del nuevo grupo de recursos.
```
ResourceGroupName : MyDemoRG
Location          : westus
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/<GUID>/resourceGroups/MyDemoRG
```
Pruebe la implementación.
- Ejecute el cmdlet Test-AzResourceGroupDeployment para validar la implementación. Al probar la implementación, proporcione parámetros exactamente como lo haría al ejecutar la implementación.
```
Test-AzResourceGroupDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
```
Crea la implementación
- Para crear la nueva implementación, ejecute el cmdlet New-AzResourceGroupDeployment y proporcione los parámetros necesarios cuando se le solicite. Los parámetros incluyen un nombre para la implementación, el nombre del grupo de recursos y la ruta de acceso o dirección URL al archivo de plantilla. Si no se especifica el parámetro Mode, se usa el valor predeterminado de Incremental. Para obtener más información, lea despliegues incrementales y completos.
- El siguiente comando le pide los cinco parámetros necesarios en la ventana de PowerShell:
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
```
- Para especificar un archivo de parámetros en su lugar, use el siguiente comando:
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
```
- También puede usar parámetros en línea al ejecutar el cmdlet de implementación. El comando es el siguiente:
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -parameterName "parameterValue"
```
- Para ejecutar una implementación completa, establezca el parámetro Mode en Complete:
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -Mode Complete -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
```

Comprobación de la implementación

Si los recursos se implementan correctamente, se muestra un resumen de la implementación en la ventana de 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 :

Implementación de la plantilla de inicio rápido a través de Azure Portal
- La página de inicio de la plantilla "Quickstart" en GitHub también incluye un botón Implementar en Azure. Al hacer clic en ella, se abre una página Implementación personalizada en Azure Portal. En esta página, puede escribir o seleccionar valores para cada uno de los parámetros en las tablas de los parámetros necesarios o los parámetros opcionales. Después de rellenar la configuración, al hacer clic en el botón Comprar se iniciará la implementación de la plantilla.

Pasos siguientes

Para obtener información sobre la administración mediante programación de recursos de Azure Time Series Insights mediante API REST, lea Administración de Azure Time Series Insights.

Compartir vía

Creación de recursos de Azure Time Series Insights Gen 1 mediante plantillas de Azure Resource Manager

Especificar la plantilla de implementación y los parámetros

Implementación de la plantilla de inicio rápido localmente mediante PowerShell

Pasos siguientes

Recursos adicionales