Las métricas de la plataforma miden el rendimiento de los distintos aspectos de los recursos de Azure. La telemetría de la plataforma reglas de recopilación de datos (DCR) permite recopilar y exportar las métricas de plataforma de los recursos de Azure admitidos. En este artículo se muestra cómo crear un DCR para la exportación de métricas.
Nota:
Aunque puede usar DCR y la configuración de diagnóstico al mismo tiempo, debe deshabilitar cualquier configuración de diagnóstico para las métricas al usar DCR para evitar la recopilación de datos duplicada.
Comparación con la configuración de diagnóstico
Antes de esta característica, solo podía exportar métricas de plataforma mediante la configuración de diagnóstico. La configuración de diagnóstico sigue siendo necesaria para los tipos de recursos que aún no admiten DCR.
Las DCR de telemetría de plataforma proporcionan varias ventajas sobre la configuración de diagnóstico:
- La configuración de DCR permite exportar métricas con dimensiones.
- La configuración de DCR permite el filtrado basado en el nombre de la métrica para poder exportar solo las métricas que necesita.
- Las DCR son más flexibles y escalables que la configuración de diagnóstico. Use un único DCR con varios recursos, mientras que se requiere una configuración de diagnóstico independiente para cada recurso.
- La latencia de un extremo a otro para los DCR es de hasta tres minutos, mientras que la latencia de exportación de la configuración de diagnóstico es de seis a diez minutos.
Destinos de la exportación
Las métricas se pueden exportar a los siguientes destinos.
| Tipo de destino |
Detalles |
| Áreas de trabajo de Log Analytics |
La exportación a áreas de trabajo de Log Analytics se puede realizar entre regiones. El área de trabajo de Log Analytics y la DCR deben estar en la misma región, pero los recursos que se supervisan pueden estar en cualquier región. Las métricas enviadas a un área de trabajo de Log Analytics se almacenan en la tabla AzureMetricsV2. |
| Cuentas de almacenamiento de Azure |
La cuenta de almacenamiento, la DCR y los recursos que se supervisan deben estar todos en la misma región. |
| Event Hubs |
Event Hubs, la DCR y los recursos que se supervisan deben estar en la misma región. |
Nota:
La latencia para exportar métricas es de aproximadamente 3 minutos. Espere hasta 15 minutos para que las métricas empiecen a aparecer en el destino después de la configuración inicial.
Limitaciones
Las DCR para la exportación de métricas tienen las siguientes limitaciones:
- Solo se puede especificar un destino por DCR. Para enviar a varios destinos, cree varias DCR.
- Un máximo de 5 DCR se puede asociar a un único recurso de Azure.
- La exportación de métricas con DCR no soporta la exportación de métricas de granularidad horaria.
Recursos y regiones admitidos
Para obtener la lista actual de recursos admitidos y regiones admitidas, consulte Métricas exporta recursos y regiones admitidos.
Cree una regla de colección de datos (DCR) para la exportación de métricas
En este artículo se describe cómo crear una regla de recopilación de datos (DCR) para la exportación de métricas mediante Azure Portal, la CLI de Azure, PowerShell, api o plantillas de ARM.
Importante
Para enviar datos de telemetría de plataforma a cuentas de almacenamiento o Event Hubs, el recurso, la regla de colección de datos y la cuenta de almacenamiento de destino o Event Hubs deben estar todos en la misma región.
Creación de una regla de recopilación de datos mediante Azure Portal
En el menú Supervisión de Azure Portal, seleccione Reglas de recopilación de datos y, a continuación, Crear.
Seleccione el vínculo de la parte superior de la página para usar la nueva experiencia de creación de DCR.
En la página Crear regla de recopilación de datos , escriba un nombre de regla, seleccione una suscripción, un grupo de recursos y una región para el DCR.
Seleccione PlatformTelemetry para el tipo de telemetría y Habilitar identidad administrada si desea enviar métricas a una cuenta de almacenamiento o Event Hubs.
En la página Recursos , seleccione Agregar recursos para agregar los recursos de los que desea recopilar métricas.
Seleccione Siguiente para ir a la pestaña Recopilar y entregar .
Seleccione Agregar nuevo origen de datos.
El tipo de recurso del recurso especificado en el paso anterior se selecciona automáticamente. Agregue más tipos de recursos si desea usar esta regla para recopilar métricas de varios tipos de recursos en el futuro. Seleccione Las acciones de un tipo de recurso si desea quitar algunas de las métricas recopiladas para él. De forma predeterminada, se recopilan todas las métricas disponibles para el recurso.
Seleccione Next Destinations (Destinos siguientes) para ir a la pestaña Destinos .
Seleccione Agregar destino y, a continuación, el tipo de destino que desea agregar. Los campos obligatorios cambian en función del tipo de destino que seleccione.
Nota:
Para enviar métricas a una cuenta de almacenamiento o a Event Hubs, el recurso que genera las métricas, el CONTROLADOR de dominio y la cuenta de almacenamiento o el centro de eventos, deben estar todos en la misma región. Para enviar métricas a un área de trabajo de Log Analytics, la DCR debe estar en la misma región que el área de trabajo de Log Analytics. El recurso que genera las métricas puede estar en cualquier región.
Seleccione Guardar y, a continuación, seleccione Revisar y crear.
Creación de una regla de recopilación de datos mediante la CLI de Azure
Cree un archivo JSON que contenga la especificación de la regla de colección. Para obtener más información, consulte Estructura de reglas de recopilación de datos (DCR) para la exportación de métricas. Para obtener archivos JSON de ejemplo, consulte Sample Metrics Export JSON objects (Exportación de objetos JSON de ejemplo).
Importante
El archivo de reglas tiene el mismo formato que se usa para PowerShell y la API REST, pero el archivo no debe contener identity, la location ni kind. Estos parámetros se especifican en el comando az monitor data-collection rule create.
En el siguiente ejemplo de CLI de Azure se usa el comando az monitor data-collection rule create.
subscriptionId="aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
resourceGroupName="myResourceGroup"
dataCollectionRuleName="myDataCollectionRule"
location="eastus"
ruleFile="./cli-dcr.json"
az account set --subscription "$subscriptionId"
az monitor data-collection rule create \
--name "$dataCollectionRuleName" \
--resource-group "$resourceGroupName" \
--location "$location" \
--kind PlatformTelemetry \
--identity "{type:'SystemAssigned'}" \
--rule-file "$ruleFile"
Nota:
CLI de Azure comandos usan el punto de conexión de Azure Resource Manager desde el contexto actual de la CLI, por lo que no es necesario especificar management.azure.com en la sintaxis del comando.
En el caso de las cuentas de almacenamiento y los destinos de Event Hubs, debe habilitar la identidad administrada para la DCR mediante --identity "{type:'SystemAssigned'}". La identidad no es necesaria para las áreas de trabajo de Log Analytics.
Copie el id y el principalId del DCR del resultado siguiente para usarlo al asignar el rol para crear una asociación entre el DCR y un recurso.
Output:
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionRules/myDataCollectionRule",
"identity": {
"principalId": "eeeeeeee-ffff-aaaa-5555-666666666666",
"tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"type": "systemAssigned"
},
Concesión de permisos de escritura a la identidad administrada
La identidad administrada usada por la DCR debe tener permisos de escritura en el destino cuando el destino es una cuenta de almacenamiento o Event Hubs. Para conceder permisos para la identidad administrada de la regla, asigne el rol adecuado a la entidad.
La tabla siguiente muestra los roles necesarios para cada tipo de destino:
| Tipo de destino |
Rol |
| Área de trabajo de Log Analytics |
no se requiere |
| Cuenta de almacenamiento de Azure |
Storage Blob Data Contributor |
| Event Hubs |
Azure Event Hubs Data Sender |
Para más información sobre cómo asignar roles, consulte Asignación de roles de Azure a una identidad administrada.
Para asignar un rol a una identidad administrada mediante la CLI, use az role assignment create. Para obtener más información, vea Asignaciones de roles: crear.
Asigne el rol adecuado a la identidad administrada de la DCR. En el ejemplo siguiente se asigna el rol Storage Blob Data Contributor a la identidad administrada de la DCR para una cuenta de almacenamiento.
En el ejemplo CLI de Azure siguiente se usa el comando az role assignment create.
subscriptionId="aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
resourceGroupName="myResourceGroup"
storageAccountName="myStorageAccount"
principalId="eeeeeeee-ffff-aaaa-5555-666666666666"
roleDefinitionName="Storage Blob Data Contributor"
scope="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Storage/storageAccounts/$storageAccountName"
az account set --subscription "$subscriptionId"
az role assignment create \
--assignee "$principalId" \
--role "$roleDefinitionName" \
--scope "$scope"
Creación de una asociación de reglas de colección de datos
Después de crear la regla de colección de datos, cree una asociación de reglas de colección de datos (DCRA) para asociar la regla al recurso que se va a supervisar. Para obtener más información, consulte Crear asociaciones de reglas de recopilación de datos.
En el ejemplo siguiente se usa el grupo de comandos az monitor data-collection rule association para createcrear una asociación entre una regla de recopilación de datos y un almacén de claves.
subscriptionId="aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
resourceGroupName="myResourceGroup"
associationName="myAssociation"
dataCollectionRuleName="myDataCollectionRule"
keyVaultName="myKeyVault"
dataCollectionRuleId="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Insights/dataCollectionRules/$dataCollectionRuleName"
resourceUri="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.KeyVault/vaults/$keyVaultName"
az account set --subscription "$subscriptionId"
az monitor data-collection rule association create \
--name "$associationName" \
--rule-id "$dataCollectionRuleId" \
--resource "$resourceUri"
Creación de una regla de recopilación de datos mediante PowerShell
Cree un archivo JSON que contenga la especificación de la regla de colección. Para obtener más información, consulte Estructura de reglas de recopilación de datos (DCR) para la exportación de métricas. Para obtener archivos JSON de ejemplo, consulte Sample Metrics Export JSON objects (Exportación de objetos JSON de ejemplo).
En el ejemplo de PowerShell siguiente se usa el cmdlet New-AzDataCollectionRule .
$subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
$resourceGroupName = "myResourceGroup"
$dataCollectionRuleName = "myDataCollectionRule"
$jsonFilePath = ".\dcr-storage-account.json"
Set-AzContext -Subscription $subscriptionId
$dataCollectionRuleParams = @{
Name = $dataCollectionRuleName
ResourceGroupName = $resourceGroupName
JsonFilePath = $jsonFilePath
}
New-AzDataCollectionRule @dataCollectionRuleParams
Copie el id y el IdentityPrincipalId del DCR del resultado siguiente para usarlo al asignar el rol para crear una asociación entre el DCR y un recurso.
Output:
Id : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionRules/myDataCollectionRule
IdentityPrincipalId : eeeeeeee-ffff-aaaa-5555-666666666666
IdentityTenantId : aaaabbbb-0000-cccc-1111-dddd2222eeee
IdentityType : systemAssigned
IdentityUserAssignedIdentity : {
}
Concesión de permisos de escritura a la identidad administrada
La identidad administrada usada por la DCR debe tener permisos de escritura en el destino cuando el destino es una cuenta de almacenamiento o Event Hubs.
Para conceder permisos para la identidad administrada de la regla, asigne el rol adecuado a la entidad.
La tabla siguiente muestra los roles necesarios para cada tipo de destino:
| Tipo de destino |
Rol |
| Área de trabajo de Log Analytics |
no se requiere |
| Cuenta de almacenamiento de Azure |
Storage Blob Data Contributor |
| Event Hubs |
Azure Event Hubs Data Sender |
Para más información, consulte Asignación de roles de Azure a una identidad administrada.
Asigne el rol adecuado a la identidad administrada de la DCR usando New-AzRoleAssignment. En el ejemplo siguiente se asigna el rol Azure Event Hubs Data Sender a la identidad administrada de la DCR en el nivel de suscripción.
En el siguiente ejemplo de PowerShell se usa el cmdlet New-AzRoleAssignment .
$objectId = "eeeeeeee-ffff-aaaa-5555-666666666666"
$roleDefinitionName = "Azure Event Hubs Data Sender"
$subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
$scope = "/subscriptions/$subscriptionId"
Set-AzContext -Subscription $subscriptionId
$roleAssignmentParams = @{
ObjectId = $objectId
RoleDefinitionName = $roleDefinitionName
Scope = $scope
}
New-AzRoleAssignment @roleAssignmentParams
Creación de una asociación de reglas de colección de datos
Después de crear la regla de colección de datos, cree una asociación de reglas de colección de datos (DCRA) para asociar la regla al recurso que se va a supervisar. Use New-AzDataCollectionRuleAssociation para crear una asociación entre una regla de colección de datos y un recurso. Para obtener más información, vea New-AzDataCollectionRuleAssociation.
En el ejemplo de PowerShell siguiente se usa el cmdlet New-AzDataCollectionRuleAssociation para crear una asociación entre una regla de recopilación de datos y un Key Vault.
$subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
$resourceGroupName = "myResourceGroup"
$associationName = "myDataCollectionRuleAssociation"
$keyVaultName = "myKeyVault"
$dataCollectionRuleName = "myDataCollectionRule"
$resourceUri = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.KeyVault/vaults/$keyVaultName"
$dataCollectionRuleId = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Insights/dataCollectionRules/$dataCollectionRuleName"
Set-AzContext -Subscription $subscriptionId
$dataCollectionRuleAssociationParams = @{
AssociationName = $associationName
ResourceUri = $resourceUri
DataCollectionRuleId = $dataCollectionRuleId
}
New-AzDataCollectionRuleAssociation @dataCollectionRuleAssociationParams
La creación de una regla de colección de datos para métricas requiere los pasos siguientes:
- Creación de la regla de colección de datos.
- Concesión de permisos para que la identidad administrada de la regla escriba en el destino.
- Creación de una asociación de reglas de colección de datos.
Creación de la regla de recopilación de datos
Para crear una DCR mediante la API REST, debe realizar una solicitud autenticada mediante un token de portador. Para más información sobre la autenticación con Azure Monitor, consulte Autenticación de solicitudes de Azure Monitor.
Use el siguiente punto de conexión para crear una regla de colección de datos para métricas mediante la API REST. Para obtener más información, vea Reglas de recopilación de datos: crear.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dataCollectionRuleName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json
La carga es un objeto JSON que define una regla de colección. La carga se envía en el cuerpo de la solicitud. Para más información sobre la estructura JSON, consulte Estructura de reglas de recopilación de datos (DCR) para la exportación de métricas. Para ver objetos JSON de DCR de ejemplo, consulte Ejemplo de métricas de exportación de objetos JSON.
Concesión de permisos de escritura a la identidad administrada
La identidad administrada usada por la DCR debe tener permisos de escritura en el destino cuando el destino es una cuenta de almacenamiento o Event Hubs. Para conceder permisos para la identidad administrada de la regla, asigne el rol adecuado a la entidad.
La tabla siguiente muestra los roles necesarios para cada tipo de destino:
| Tipo de destino |
Rol |
| Área de trabajo de Log Analytics |
no se requiere |
| Cuenta de almacenamiento de Azure |
Storage Blob Data Contributor |
| Event Hubs |
Azure Event Hubs Data Sender |
Para más información, consulte Asignación de roles de Azure a una identidad administrada.
Para asignar un rol a una identidad administrada mediante REST, consulte Asignaciones de roles: crear.
Creación de una asociación de reglas de colección de datos
Después de crear la regla de colección de datos, cree una asociación de reglas de colección de datos (DCRA) para asociar la regla al recurso que se va a supervisar. Para obtener más información, consulte Asociaciones de reglas de recopilación de datos: crear
Para crear un DCRA mediante la API REST, use el siguiente punto de conexión y carga:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{virtualMachineName}/providers/Microsoft.Insights/dataCollectionRuleAssociations/{associationName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json
{
"properties": {
"description": "Association of platform telemetry DCR with VM myVirtualMachine",
"dataCollectionRuleId": "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Insights/dataCollectionRules/<dataCollectionRuleName>"
}
}
Creación de una regla de recopilación de datos mediante plantillas de Bicep
Use la plantilla siguiente para crear un DCR. Para obtener más información, consulte Microsoft.Insights dataCollectionRules.
@description('Specifies the name of the Data Collection Rule to create.')
param dataCollectionRuleName string
@description('Specifies the Log Analytics workspace.')
param workspaceId string
@description('Specifies the location in which to create the Data Collection Rule.')
param location string
resource dataCollectionRule 'Microsoft.Insights/dataCollectionRules@2024-03-11' = {
name: dataCollectionRuleName
kind: 'PlatformTelemetry'
identity: {
type: 'UserAssigned' | 'SystemAssigned'
userAssignedIdentities: {
type: 'string'
}
}
location: location
properties: {
dataSources: {
platformTelemetry: [
{
streams: [
'<resourceType>:<metricName> | Metrics-Group-All'
]
name: 'myPlatformTelemetryDataSource'
}
]
}
destinations: {
logAnalytics: [
{
workspaceResourceId: workspaceId
name: 'myDestination'
}
]
}
dataFlows: [
{
streams: [
'<resourceType>:<metricName> | Metrics-Group-All'
]
destinations: [
'myDestination'
]
}
]
}
}
Archivo de parámetros
using './<template-name>.bicep'
param dataCollectionRuleName = 'myDataCollectionRule'
param workspaceId = '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/microsoft.operationalinsights/workspaces/myWorkspace'
param location = 'eastus'
Plantilla de ejemplo de DCR
@description('Specifies the name of the Data Collection Rule to create.')
param dataCollectionRuleName string
@description('Specifies the Log Analytics workspace.')
param workspaceId string
@description('Specifies the location in which to create the Data Collection Rule.')
param location string
resource dataCollectionRule 'Microsoft.Insights/dataCollectionRules@2024-03-11' = {
name: dataCollectionRuleName
location: location
kind: 'PlatformTelemetry'
identity: {
type: 'SystemAssigned'
}
properties: {
dataSources: {
platformTelemetry: [
{
streams: [
'Microsoft.Compute/virtualMachines:Metrics-Group-All'
'Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All'
'Microsoft.Cache/redis:Metrics-Group-All'
'Microsoft.keyvault/vaults:Metrics-Group-All'
]
name: 'myPlatformTelemetryDataSource'
}
]
}
destinations: {
logAnalytics: [
{
workspaceResourceId: workspaceId
name: 'myDestination'
}
]
}
dataFlows: [
{
streams: [
'Microsoft.Compute/virtualMachines:Metrics-Group-All'
'Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All'
'Microsoft.Cache/redis:Metrics-Group-All'
'Microsoft.keyvault/vaults:Metrics-Group-All'
]
destinations: [
'myDestination'
]
}
]
}
}
Creación de una regla de recopilación de datos mediante plantillas de ARM
Use la plantilla siguiente para crear un DCR. Para obtener más información, consulte Microsoft.Insights dataCollectionRules.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"dataCollectionRuleName": {
"type": "string",
"metadata": {
"description": "Specifies the name of the Data Collection Rule to create."
}
},
"workspaceId": {
"type": "string",
"metadata": {
"description": "Specifies the Log Analytics workspace."
}
},
"location": {
"type": "string",
"metadata": {
"description": "Specifies the location in which to create the Data Collection Rule."
}
}
},
"resources": [
{
"type": "Microsoft.Insights/dataCollectionRules",
"name": "[parameters('dataCollectionRuleName')]",
"kind": "PlatformTelemetry",
"identity": {
"type": "UserAssigned" | "SystemAssigned",
"userAssignedIdentities": {
"type": "string"
}
},
"location": "[parameters('location')]",
"apiVersion": "2024-03-11",
"properties": {
"dataSources": {
"platformTelemetry": [
{
"streams": [
"<resourceType>:<metricName> | Metrics-Group-All"
],
"name": "myPlatformTelemetryDataSource"
}
]
},
"destinations": {
"logAnalytics": [
{
"workspaceResourceId": "[parameters('workspaceId')]",
"name": "myDestination"
}
]
},
"dataFlows": [
{
"streams": [
"<resourceType>:<metricName> | Metrics-Group-All"
],
"destinations": [
"myDestination"
]
}
]
}
}
]
}
Archivo de parámetros
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"dataCollectionRuleName": {
"value": "myDataCollectionRule"
},
"workspaceId": {
"value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/microsoft.operationalinsights/workspaces/myWorkspace"
},
"location": {
"value": "eastus"
}
}
}
Plantilla de ejemplo de DCR
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [
{
"type": "Microsoft.Insights/dataCollectionRules",
"apiVersion": "2024-03-11",
"name": "[parameters('dataCollectionRuleName')]",
"location": "[parameters('location')]",
"kind": "PlatformTelemetry",
"identity": {
"type": "SystemAssigned"
},
"properties": {
"dataSources": {
"platformTelemetry": [
{
"streams": [
"Microsoft.Compute/virtualMachines:Metrics-Group-All",
"Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
"Microsoft.Cache/redis:Metrics-Group-All",
"Microsoft.keyvault/vaults:Metrics-Group-All"
],
"name": "myPlatformTelemetryDataSource"
}
]
},
"destinations": {
"logAnalytics": [
{
"workspaceResourceId": "[parameters('workspaceId')]",
"name": "myDestination"
}
]
},
"dataFlows": [
{
"streams": [
"Microsoft.Compute/virtualMachines:Metrics-Group-All",
"Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
"Microsoft.Cache/redis:Metrics-Group-All",
"Microsoft.keyvault/vaults:Metrics-Group-All"
],
"destinations": [
"myDestination"
]
}
]
}
}
]
}
| Variable |
Valor de ejemplo |
Purpose |
| host |
management.azure.com |
Punto de conexión de ARM implícito |
| subscriptionId |
aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e |
Entrada de usuario |
| resourceGroupName |
myResourceGroup |
Entrada de usuario |
| dataCollectionRuleName |
myDataCollectionRule |
Entrada de usuario |
| associationName |
myAssociation |
Entrada de usuario |
| location |
eastus |
Entrada de usuario |
| workspaceName |
myWorkspace |
Entrada de usuario |
| keyVaultName |
myKeyVault |
Entrada de usuario |
| storageAccountName |
myStorageAccount |
Entrada de usuario |
| monitoredResourceName |
myKeyVault |
Entrada de usuario |
| apiVersion |
2024-03-11 |
Referencia |
Comprobación de la recopilación de datos
Después de crear el DCR, espere hasta 30 minutos para que los primeros datos de métricas de la plataforma aparezcan en el área de trabajo de Log Analytics. Una vez que los datos comienzan a fluir, la latencia de una serie temporal de métricas de plataforma que fluye a un área de trabajo de Log Analytics, una cuenta de almacenamiento o Event Hubs es de aproximadamente tres minutos, en función del tipo de recurso.
Datos exportados
En los ejemplos siguientes se muestran los datos exportados a cada destino.
Área de trabajo de Log Analytics
Los datos exportados a un área de trabajo de Log Analytics se almacenan en la tabla AzureMetricsV2, en el área de trabajo de Log Analytics, con el formato siguiente:
| Columna |
Tipo |
Description |
| Average |
real |
Valor medio recopilado durante el intervalo de tiempo. |
| _BilledSize |
real |
Tamaño del registro en bytes |
| Count |
real |
Número de muestras recopiladas durante el intervalo de tiempo. |
| Dimensión |
dynamic |
Dimensión asociada de la métrica en formato JSON. |
| _IsBillable |
cuerda / cadena |
Especifica si la ingesta de los datos es facturable. Cuando _IsBillable esté establecido como false, la ingesta no se facturará a su cuenta de Azure |
| Máxima |
real |
Valor máximo recopilado durante en el intervalo de tiempo. |
| MetricCategory |
cuerda / cadena |
Nombre de la categoría de la métrica. |
| NombreDeLaMétrica |
cuerda / cadena |
Nombre para mostrar de la métrica. |
| MetricResourceType |
cuerda / cadena |
Tipo de recurso del recurso de Azure que informa de la métrica. |
| Mínimo |
real |
Valor mínimo recopilado durante en el intervalo de tiempo. |
| _IdentificadorDeRecurso |
cuerda / cadena |
Identificador único del recurso al que está asociado el registro. |
| Sistema de origen |
cuerda / cadena |
Tipo de agente mediante el que se recopiló el evento. Por ejemplo, OpsManager para el agente de Windows, ya sea conexión directa u Operations Manager, Linux para todos los agentes de Linux o Azure para Azure Diagnostics |
| _IdentificadorDeSuscripción |
cuerda / cadena |
Identificador único de la suscripción a la que está asociado el registro. |
| Id del inquilino |
cuerda / cadena |
El ID del espacio de trabajo de Log Analytics |
| TimeGenerated |
datetime |
Marca de tiempo (UTC) de cuando se generó el registro. |
| TimeGrain |
cuerda / cadena |
Intervalo de agregación de la métrica. |
| Total |
real |
Suma de todos los valores del intervalo de tiempo. |
| Tipo |
cuerda / cadena |
Nombre de la tabla. |
| NombreDeUnidad |
cuerda / cadena |
Unidad de la métrica. |
Por ejemplo:
Cuentas de almacenamiento
En el ejemplo siguiente se muestran los datos exportados a una cuenta de almacenamiento:
{
"Average": "31.5",
"Count": "2",
"Maximum": "52",
"Minimum": "11",
"Total": "63",
"resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-dcrs/providers/microsoft.keyvault/vaults/dcr-vault",
"time": "2024-08-20T14:13:00.0000000Z",
"unit": "MilliSeconds",
"metricName": "ServiceApiLatency",
"timeGrain": "PT1M",
"dimension": {
"ActivityName": "vaultget",
"ActivityType": "vault",
"StatusCode": "200",
"StatusCodeClass": "2xx"
}
}
Event Hubs
En el ejemplo siguiente se muestra una métrica exportada a Event Hubs.
{
"Average": "1",
"Count": "1",
"Maximum": "1",
"Minimum": "1",
"Total": "1",
"resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-dcrs/providers/microsoft.keyvault/vaults/dcr-vault",
"time": "2024-08-22T13:43:00.0000000Z",
"unit": "Count",
"metricName": "ServiceApiHit",
"timeGrain": "PT1M",
"dimension": {
"ActivityName": "keycreate",
"ActivityType": "key"
},
"EventProcessedUtcTime": "2024-08-22T13:49:17.1233030Z",
"PartitionId": 0,
"EventEnqueuedUtcTime": "2024-08-22T13:46:04.5570000Z"
}
Comprobación y solución de problemas de recopilación de datos
Una vez que instale el DCR, los cambios pueden tardar varios minutos en reflejarse y en que los datos se recopilen con el DCR actualizado. Si no ve los datos que se recopilan, use las características de supervisión de DCR , que incluyen métricas y registros para ayudar a solucionar problemas.
Las métricas de DCR se recopilan automáticamente para todas las DCR y puede analizarlas mediante el explorador de métricas, como las métricas de la plataforma para otros recursos de Azure. Habilite los registros de errores de DCR para obtener información detallada de errores cuando el procesamiento de datos no se realiza correctamente.
- Compruebe las métricas como
Logs Ingestion Bytes per Min y Logs Rows Received per Min para asegurarse de que los datos llegan a Azure Monitor. De lo contrario, compruebe el origen de datos para asegurarse de que envía datos según lo previsto.
- Compruebe
Logs Rows Dropped per Min para ver si se quitan filas. Es posible que esto no indique un error, ya que una transformación podría quitar las filas. Pero si las filas quitadas son las mismas que Logs Rows Dropped per Min, no se ingieren datos en el área de trabajo. Examine Logs Transformation Errors per Min para ver si hay errores de transformación.
- Compruebe
Logs Transformation Errors per Min para determinar si hay errores de las transformaciones aplicadas a los datos entrantes. Esto podría deberse a cambios en la estructura de datos o en la propia transformación.
- Revise la tabla
DCRLogErrors en busca de cualquier error de ingestión que pueda haber sido registrado. Esto puede proporcionar detalles adicionales para identificar la causa principal del problema.
Pasos siguientes
