Show Menu
SUJETS×

Le fichier Transform.cfg

Le fichier data workbenchTransform.cfg contient les paramètres qui définissent les sources du journal, les transformations de données et les exportateurs.
Les transformations que vous définissez manipulent les données brutes collectées par Sensors ( .vsl fichiers) ou contenues dans des fichiers texte, des fichiers XML ou des bases de données conformes ODBC et les génèrent soit dans des champs existants, en écrasant les données actives, soit dans des champs nouvellement définis.
Pour configurer la fonctionnalité de transformation, vous modifiez le Transform.cfg fichier des outils de données dans le dossier Jeu de données pour le profil pour lequel vous souhaitez exporter les données d’événement. En règle générale, ce profil est dédié à la fonctionnalité de transformation (c’est-à-dire que vous n’effectuez aucun autre traitement de données que celui défini dans le Transform.cfg fichier de l’outil de données). Il est important de noter que toutes les instructions de traitement spécifiées dans les Log Processing Dataset Include fichiers pour les profils hérités sont appliquées en plus de celles spécifiées dans le Transform.cfg fichier de l’outil de données.
Pour plus d’informations sur les fichiers d’inclusion de jeux de données, voir Fichiers inclus dans les jeux de données.
Si les données que vous souhaitez exporter sont traitées par une grappe de serveurs de outils de données, chacun des serveurs de traitement (DPU) de la grappe traite les données, mais seul le premier DPU (serveur de traitement n° 0 dans le profile.cfg fichier) écrit les données de sortie dans son système de fichiers local.
Pour modifier le fichier Transform.cfg de l’outil de données
  1. Lorsque vous travaillez dans le profil pour lequel vous souhaitez exporter des données, ouvrez le fichier Profile Manager et cliquez sur Dataset pour afficher le contenu du répertoire.
  2. Cliquez avec le bouton droit de la souris sur la coche en regard de l’outil de données Transform.cfg, puis cliquez sur Make Local . Une coche pour ce fichier apparaît dans la User colonne.
  3. Cliquez avec le bouton droit de la souris sur la coche nouvellement créée, puis cliquez sur Open > from the workbench . La fenêtre Outils de données Transform.cfg s’affiche.
  4. Modifiez les paramètres du fichier de configuration à l’aide du tableau ci-dessous comme guide :
Paramètre Description
Heure de fin
Facultatif. Filtrez les données afin d’inclure les entrées de journal avec horodatage jusqu’à cette heure, mais pas celle-ci. Adobe recommande d’utiliser l’un des formats suivants pour l’instant :
  • 1er janvier 2013HH:MM:SS EDT
  • 1er janvier 2013 HH:MM:SS GMT
Par exemple, la spécification du 29 juillet 2013 à 00:00:00 EDT comme Heure de fin inclut les données jusqu’au 28 juillet 2013 à 11h59:59 HAE.
Vous devez spécifier un fuseau horaire. Le fuseau horaire n’est pas défini par défaut sur GMT s’il n’est pas spécifié. Pour obtenir la liste des abréviations de fuseau horaire prises en charge par le serveur de l’outil de données, voir Codes de fuseau horaire .
Le paramètre Utiliser les heures de début et de fin pour les sources de fichiers journaux et Sensor est associé à ce paramètre.
Exportateurs
Les sous-champs d’un exportateur indiquent comment les données de sortie sont traitées et/ou formatées. Vous pouvez définir plusieurs exportateurs pour un ensemble de sources de journal. Chaque type d’exportateur crée une sortie indépendante.
Il existe trois types d'exportateurs :
  • ExportTextFile
  • ExportDelimitedTextFile
  • ExportVSLFile
Pour plus d’informations sur les types d’exportateurs, voir Définition des exportateurs .
Seuil de hachage Facultatif. Facteur d’échantillonnage pour le sous-échantillonnage aléatoire des lignes. S’il est défini sur le nombre n, seul un ID de suivi sur n est sélectionné pour l’exportation, ce qui réduit le nombre total de lignes exportées par un facteur n. Pour exporter toutes les lignes, définissez le seuil de hachage sur 1.
Condition d’entrée de journal Facultatif. Définit les règles selon lesquelles les entrées de journal sont prises en compte pour l’exportation. Pour plus d’informations sur la condition d’entrée du journal , voir Fichier de configuration de traitement du journal .
Sources de journal
Sources de données. Les sources du journal peuvent être des fichiers .vsl , des fichiers journaux ou des fichiers XML ou des données provenant de bases de données compatibles ODBC. Pour plus d’informations sur les sources de journaux , voir Fichier de configuration de traitement des journaux .
Transform s’attend à ce que toutes les données source soient dans l’ordre chronologique au sein des fichiers d’entrée lexicographiques. Si cette exigence n’est pas satisfaite, les calculs sont incorrects et des données d’entrée supplémentaires peuvent être traitées après la fermeture des fichiers de sortie.
Mode hors ligne
Facultatif. True ou false. Si la valeur est true, Transform suppose que tous les fichiers d’entrée sont présents au démarrage du traitement des données. Lorsque toutes les données d’entrée ont été lues, Transform ferme tous les fichiers de sortie sans attendre la réception de données supplémentaires. La valeur par défaut est false.
Remarque : Si le mode hors ligne est défini sur true, Transform s’attend à ce que toutes les données source soient présentes avant le début du traitement. Un message d’avertissement est généré dans le fichier VisualServer.log si des données supplémentaires sont reçues après la fermeture des fichiers de sortie.
Retraiter
Facultatif. Tout caractère ou combinaison de caractères peut être saisi ici. La modification de ce paramètre et l’enregistrement du fichier sur l’ordinateur Transform initialise le retraitement des données.
Pour plus d’informations sur le retraitement de vos données, voir Retraitement et retransformation .
Etapes
Facultatif. Les noms des étapes de traitement qui peuvent être utilisées dans le jeu de données de traitement des journaux incluent les fichiers exécutés en plus du fichier Transform.cfg de l’outil de données. Les étapes de traitement permettent d’organiser les transformations définies dans les fichiers Inclure les jeux de données de traitement du journal. Ce paramètre est très utile si vous avez défini une ou plusieurs transformations dans plusieurs fichiers de données de traitement du journal Inclure des fichiers et si vous souhaitez que des transformations spécifiques soient effectuées à des moments spécifiques pendant le processus d'exportation.
L’ordre dans lequel vous dressez les étapes ici détermine l’ordre dans lequel les transformations dans le jeu de données de traitement du journal Inclure les fichiers sont exécutées lors de l’exportation des données. Le prétraitement et le posttraitement sont des étapes intégrées; Le prétraitement est toujours la première étape et le posttraitement est toujours la dernière étape. Par défaut, il existe une scène nommée Par défaut .
Pour ajouter une nouvelle étape de traitement
  • Dans la fenêtre Transform.cfg de l’outil de données , cliquez avec le bouton droit de la souris sur Etapes , puis cliquez sur Ajouter nouveau > d’étape.
  • Entrez le nom de la nouvelle étape.
Pour supprimer une étape de traitement existante
  • Cliquez avec le bouton droit de la souris sur le numéro correspondant à l’étape à supprimer, puis cliquez sur Supprimer < #stage_number > .
Remarque : Lorsque vous spécifiez une étape dans un fichier Jeu de données de traitement du journal Inclure , le nom de l’étape doit correspondre exactement au nom que vous saisissez ici. Pour plus d’informations sur les fichiers d’inclusion d’un jeu de données, voir Jeu de données - Inclure des fichiers .
Heure de début
Facultatif. Filtrez les données pour inclure les entrées de journal avec horodatage à cette heure ou après. Adobe recommande d’utiliser l’un des formats suivants pour l’instant :
  • 1er janvier 2013 HH:MM:SS EDT
  • 1er janvier 2013 HH:MM:SS GMT
Par exemple, la spécification du 29 juillet 2013 à 00:00:00 EDT comme Heure de début inclut les données à partir du 29 juillet 2013 à 12:00:00 EDT.
Vous devez spécifier un fuseau horaire. Le fuseau horaire n’est pas défini par défaut sur GMT s’il n’est pas spécifié. Pour obtenir la liste des abréviations de fuseau horaire prises en charge par le serveur de l’outil de données, voir Codes de fuseau horaire .
Remarque : Le paramètre Utiliser les heures de début et de fin pour les sources de fichiers journaux et Sensor est associé à ce paramètre.
Transformations
Facultatif. Définit les transformations à appliquer aux données. Pour plus d’informations sur les types de transformation disponibles, voir Data Transformations .
Remarque : Les types de transformation suivants ne fonctionnent pas lorsqu’ils sont définis dans le fichier Transform.cfg de l’outil de données :
  • AppendURI
  • CrossRows
  • ODBCLookup
  • Sessioniser
Si des données supplémentaires sont reçues après la fermeture des fichiers de sortie (voir Log Sources et Offline Mode dans le tableau précédent), Transform crée de nouveaux fichiers de sortie avec les données supplémentaires. Les noms des nouveaux fichiers de sortie sont générés à partir du nom du fichier de sortie d’origine avec l’ajout d’un numéro de version entre parenthèses juste avant l’extension. Par exemple, si le fichier de sortie original est 20070701-ABC.vsl, les versions suivantes de ce fichier seront nommées 20070701-ABC(1).vsl, 20070701-ABC(2).vsl, etc. Notez que l’utilisation des fichiers avec version comme entrée au serveur de l’outil de données peut entraîner des erreurs de traitement.
Adobe recommande d’éviter la création de fichiers de sortie avec version en s’assurant que toutes les données source sont dans l’ordre chronologique dans les fichiers d’entrée lexicographiques et, si la valeur Offline Mode est true, que toutes les données source sont présentes avant le début du traitement. Pour plus d’informations, voir les Log Sources entrées et les Offline Mode entrées du tableau précédent.
  1. Ajoutez des transformations en cliquant avec le bouton droit Transformations et en cliquant sur Add new > Transformation type . Renseignez les champs de transformation.
    Voir Transformations de données pour obtenir des descriptions et des exemples des transformations que vous pouvez utiliser avec la fonctionnalité de transformation.
  2. Cliquez avec le bouton droit (modified) en haut de la fenêtre, puis cliquez sur Save .
  3. Pour que les modifications apportées localement prennent effet, dans la Profile Managercolonne, cliquez avec le bouton droit de la souris sur la coche de l’outil de données Transform.cfg dans la User colonne, puis cliquez sur Save to > profile name , où nom du profil est le nom du profil pour lequel vous exportez des données. Le retraitement des données commence après la synchronisation du profil.
    Pour plus d’informations sur le retraitement de vos données pour l’exportation, voir Retraitement et retransformation .