Structure d’une règle de collecte de données dans Azure Monitor

  • Article

Les règles de collecte de données (DCR) sont des ensembles d’instructions qui déterminent comment collecter et traiter les données de télémétrie envoyées à Azure Monitor. Certaines règles DCR sont créées et gérées par Azure Monitor. Cet article décrit les propriétés JSON des règles DCR pour les créer et les modifier dans les cas où vous devez les utiliser directement.

dataCollectionEndpointId

Spécifie le point de terminaison de collecte de données (DCE) utilisé par la règle DCR.

Scénarios

  • Agent Azure Monitor
  • API d’ingestion de journaux
  • Hubs d’événements

streamDeclarations

Déclaration des différents types de données envoyés dans l’espace de travail Log Analytics. Chaque flux est un objet dont la clé représente le nom du flux, qui doit commencer par Custom-. Le flux contient une liste complète des propriétés de niveau supérieur contenues dans les données JSON qui seront envoyées. La forme des données que vous envoyez au point de terminaison ne doit pas nécessairement être identique à celle de la table de destination. La sortie de la transformation appliquée sur les données d’entrée doit plutôt correspondre à la forme de destination.

Cette section n’est pas utilisée pour les sources de données qui envoient des types de données connus tels que les données d’événements et de performances envoyées à partir de l’agent Azure Monitor.

Les types de données possibles qui peuvent être affectés aux propriétés sont :

  • string
  • int
  • long
  • real
  • boolean
  • dynamic
  • datetime.

Scénarios

  • Agent Azure Monitor (journaux texte uniquement)
  • API d’ingestion de journaux
  • Event Hubs

destinations

Déclaration de toutes les destinations où les données seront envoyées. Seul logAnalytics est actuellement pris en charge en tant que destination, sauf pour l’agent Azure Monitor qui peut également utiliser azureMonitorMetrics. Chaque destination Log Analytics nécessite l’ID de ressource complet de l’espace de travail et un nom convivial qui sera utilisé ailleurs dans la règle DCR pour faire référence à cet espace de travail.

Scénarios

  • Agent Azure Monitor (journaux texte uniquement)
  • API d’ingestion de journaux
  • Event Hubs
  • DCR de transformation de l’espace de travail

dataSources

Une source unique de données de surveillance qui a son propre format et sa propre méthode pour exposer les données. Chaque source de données a un type de source de données et chaque type définit un ensemble unique de propriétés qui doivent être spécifiées pour chaque source de données. Les types de sources de données actuellement disponibles sont indiqués dans le tableau suivant.

Type de source de données Description
eventHub Données à partir d’Azure Event Hubs
extension Source de données basée sur une extension VM, utilisée exclusivement par les solutions Log Analytics et les services Azure (Voir les services et solutions pris en charge par l’agent)
logFiles Journal texte sur une machine virtuelle
performanceCounters Compteurs de performances pour les machines virtuelles Windows et Linux
syslog Événements Syslog sur une machine virtuelle Linux
windowsEventLogs Journal des événements Windows sur les machines virtuelles

Scénarios

  • Agent Azure Monitor
  • Event Hubs

dataFlows

Correspond aux flux avec des destinations et spécifie éventuellement une transformation.

dataFlows/Streams

Un ou plusieurs flux définis dans la section précédente. Vous pouvez inclure plusieurs flux dans un seul flux de données si vous souhaitez envoyer plusieurs sources de données vers la même destination. Utilisez un seul flux si le flux de données comprend une transformation. Un flux peut également être utilisé par plusieurs flux de données lorsque vous souhaitez envoyer une source de données particulière vers plusieurs tables dans le même espace de travail Log Analytics.

dataFlows/destinations

Une ou plusieurs destinations de la section destinations ci-dessus. Plusieurs destinations sont autorisées pour les scénarios multi-hébergements.

dataFlows/transformKql

Transformation facultative appliquée au flux entrant. La transformation doit comprendre le schéma des données entrantes et des données sortantes dans le schéma de la table cible. Si vous utilisez une transformation, le flux de données ne doit utiliser qu’un seul flux.

dataFlows/outputStream

Décrit la table de l’espace de travail spécifiée sous la propriété destination vers laquelle les données sont envoyées. La valeur de outputStream a le format Microsoft-[tableName] lorsque les données sont ingérées dans une table Log Analytics standard, ou Custom-[tableName] lorsqu’elles sont ingérées dans une table personnalisée. Une seule destination est autorisée par flux.

Cette propriété n’est pas utilisée pour les sources de données connues d’Azure Monitor, telles que les données d’événements et de performances, car elles sont envoyées vers des tables prédéfinies. |

Scénarios

  • Agent Azure Monitor
  • API d’ingestion de journaux
  • Event Hubs
  • DCR de transformation de l’espace de travail

Étapes suivantes

Vue d’ensemble des règles de collecte des données et des méthodes pour les créer