Datei „Transform.cfg“

Die Datei "data workbenchTransform.cfg"enthält die Parameter, die die Protokollquellen, Datenumwandlungen und Exporteure definieren.

Die von Ihnen definierten Umwandlungen manipulieren Rohdaten, die von Sensoren ( .vsl-Dateien) erfasst oder in Textdateien, XML-Dateien oder ODBC-kompatiblen Datenbanken enthalten sind, und geben sie entweder in vorhandene Felder aus, überschreiben die aktuellen Daten oder in neu definierte Felder.

Um die Umwandlungsfunktion zu konfigurieren, bearbeiten Sie die Data Workbench-Datei Transform.cfg im Ordner Datensatz für das Profil, für das Sie Ereignisdaten exportieren möchten. In der Regel bezieht sich dieses Profil auf die Umwandlungsfunktion (d. h. Sie führen keine andere Datenverarbeitung durch als die in der Datei Transform.cfg der Data Workbench definierte Datenverarbeitung). Beachten Sie, dass alle in den Log Processing Dataset Include-Dateien für geerbte Profile angegebenen Verarbeitungsanweisungen zusätzlich zu den in der Datei Transform.cfg von Data Workbench angegebenen angewendet werden.

Informationen zu Datensatzaufnahme-Dateien finden Sie unter Datensatzaufnahme-Dateien.

Wenn die Daten, die Sie exportieren möchten, von einem Data Workbench-Servercluster verarbeitet werden, verarbeitet jeder der Verarbeitungsserver (DPUs) im Cluster die Daten, aber nur die erste DPU (Verarbeitungsserver Nr. 0 in der Datei profile.cfg) schreibt die Ausgabedaten in sein lokales Dateisystem.

Bearbeiten der Datei "Transform.cfg"in Data Workbench

  1. Öffnen Sie bei der Arbeit mit dem Profil, für das Sie Daten exportieren möchten, Profile Manager und klicken Sie auf Dataset , um den Inhalt des Ordners anzuzeigen.
  2. Klicken Sie mit der rechten Maustaste auf das Häkchen neben Data Workbench Transform.cfg und klicken Sie dann auf Make Local. Ein Häkchen für diese Datei wird in der Spalte User angezeigt.
  3. Klicken Sie mit der rechten Maustaste auf das neu erstellte Häkchen und klicken Sie auf Open > from the workbench. Das Fenster Transform.cfg von Data Workbench wird angezeigt.
  4. Bearbeiten Sie die Parameter in der Konfigurationsdatei mithilfe der unten stehenden Tabelle als Anleitung:
Parameter Beschreibung
Endzeit

Optional. Filtern Sie Daten, um Protokolleinträge mit Zeitstempeln bis zu diesem Zeitpunkt einzuschließen, jedoch nicht eingeschlossen. Adobe empfiehlt die Verwendung eines der folgenden Zeitformate:

  • 1. Januar 2013 HH:MM:SS EDT
  • 1. Januar 2013 HH:MM:SS GMT

Wenn Sie beispielsweise den 29. Juli 2013 um 00:00:00 EDT als Endzeit angeben, werden Daten bis zum 28. Juli 2013, 23:59:59 PM EDT eingeschlossen.

Sie müssen eine Zeitzone angeben. Wenn nicht anders angegeben, wird in der Zeitzone nicht standardmäßig GMT verwendet. Eine Liste der vom Data Workbench-Server unterstützten Zeitzonen-Abkürzungen finden Sie unter Zeitzonencodes .

Der Parameter Start-/Endzeiten für Sensor- und Protokolldateiquellen bezieht sich auf diesen Parameter.

Ausführer

Die Unterfelder eines Exporteurs geben an, wie die Ausgabedaten verarbeitet und/oder formatiert werden. Sie können mehrere Exporteure für eine Reihe von Protokollquellen definieren. Jeder Exporteryp erstellt die Ausgabe unabhängig voneinander.

Es gibt drei Arten von Ausführern:

  • ExportTextFile
  • ExportDelimitedTextFile
  • ExportVSLFile

Weitere Informationen zu Exporttypen finden Sie unter Definieren von Exportern .

Hash-Schwellenwert Optional. Ein Stichprobenfaktor für eine Stichprobe von Zeilen. Wenn der Wert auf eine Zahl n festgelegt ist, wird nur eine von n Tracking-IDs für den Export ausgewählt, wodurch die Gesamtzahl der exportierten Zeilen um den Faktor n verringert wird. Um alle Zeilen zu exportieren, setzen Sie den Hash-Schwellenwert auf 1.
Protokolleintragsbedingung Optional. Definiert die Regeln, nach denen Protokolleinträge für den Export berücksichtigt werden. Weitere Informationen zur Protokolleintragsbedingung finden Sie unter Konfigurationsdatei für die Protokollverarbeitung .
Quellen für die Protokollierung

Die Datenquellen. Protokollquellen können .vsl- Dateien, Protokolldateien, XML-Dateien oder Daten aus ODBC-kompatiblen Datenbanken sein. Weitere Informationen zu Protokollquellen finden Sie unter Konfigurationsdatei für die Protokollverarbeitung .

Transform erwartet, dass alle Quelldaten in chronologischer Reihenfolge innerhalb von lexikografisch geordneten Eingabedateien vorliegen. Wenn diese Anforderung nicht erfüllt ist, sind die As Of-Berechnungen falsch und zusätzliche Eingabedaten können verarbeitet werden, nachdem die Ausgabedateien geschlossen wurden.

Offline-Modus

Optional. Wahr oder falsch. Wenn "true", geht Transformieren Sie davon aus, dass alle Eingabedateien vorhanden sind, wenn die Datenverarbeitung beginnt. Wenn alle Eingabedaten gelesen wurden, schließt Transform alle Ausgabedateien, ohne auf den Empfang zusätzlicher Daten zu warten. Der Standardwert ist „false“.

Hinweis: Wenn Offline-Modus auf "true"gesetzt ist, erwartet Transform , dass alle Quelldaten vorhanden sind, bevor die Verarbeitung beginnt. In der Datei VisualServer.log wird eine Warnmeldung erzeugt, wenn nach dem Schließen der Ausgabedateien zusätzliche Daten empfangen werden.

Neuverarbeitung

Optional. Hier können beliebige Zeichen oder Kombinationen von Zeichen eingegeben werden. Wenn Sie diesen Parameter ändern und die Datei auf dem Computer Transformieren speichern, wird die erneute Verarbeitung der Daten initiiert.

Weitere Informationen zur erneuten Verarbeitung Ihrer Daten finden Sie unter Wiederaufbereitung und erneute Umwandlung .

Phasen

Optional. Die Namen der Verarbeitungsphasen, die in Protokollverarbeitungsdatensatz verwendet werden können, umfassen -Dateien, die zusätzlich zur Data Workbench-Datei Transform.cfg ausgeführt werden. Verarbeitungsphasen bieten eine Möglichkeit, die in Protokollverarbeitungsdatensatz -Dateien definierten Umwandlungen zu sortieren. Dieser Parameter ist sehr hilfreich, wenn Sie eine oder mehrere Umwandlungen in mehreren Protokollverarbeitungs-Datensatzaufnahme -Dateien definiert haben und Sie möchten, dass bestimmte Umwandlungen an bestimmten Punkten während des Exportvorgangs durchgeführt werden.

Die Reihenfolge, in der Sie die Phasen hier auflisten, bestimmt die Reihenfolge, in der die Umwandlungen in den Protokollverarbeitungsdatensatz einschließlich -Dateien während des Datenexports ausgeführt werden. Die Vorverarbeitung und Nachbearbeitung sind integrierte Phasen. Die Vorverarbeitung ist immer der erste Schritt und die Nachbearbeitung ist immer der letzte Schritt. Standardmäßig gibt es eine benannte Phase namens Default .

So fügen Sie eine neue Verarbeitungsphase hinzu

  • Klicken Sie im Data Workbench-Fenster Transform.cfg mit der rechten Maustaste auf Stages und klicken Sie dann auf Neue hinzufügen > Staging .
  • Geben Sie einen Namen für die neue Phase ein.

So löschen Sie eine vorhandene Verarbeitungsphase

  • Klicken Sie mit der rechten Maustaste auf die Nummer der zu löschenden Phase und klicken Sie auf < #stage_number .

Hinweis: Wenn Sie eine Phase in einer Protokollverarbeitungs-Datensatz-Include -Datei angeben, muss der Name der Phase genau mit dem Namen übereinstimmen, den Sie hier eingeben. Weitere Informationen zu Datensatzaufnahme-Dateien finden Sie unter Datensatzaufnahme-Dateien .

Startzeit

Optional. Filtern Sie Daten, um Protokolleinträge mit Zeitstempeln zu dieser Zeit oder danach einzuschließen. Adobe empfiehlt die Verwendung eines der folgenden Zeitformate:

  • 1. Januar 2013 HH:MM:SS EDT
  • 1. Januar 2013 HH:MM:SS GMT

Wenn Sie beispielsweise den 29. Juli 2013 um 00:00:00 EDT als Startzeit angeben, werden Daten ab dem 29. Juli 2013 um 12:00:00 Uhr EDT einbezogen.

Sie müssen eine Zeitzone angeben. Wenn nicht anders angegeben, wird in der Zeitzone nicht standardmäßig GMT verwendet. Eine Liste der vom Data Workbench-Server unterstützten Zeitzonen-Abkürzungen finden Sie unter Zeitzonencodes .

Hinweis: Der Parameter Start-/Endzeiten für Sensor- und Protokolldateiquellen bezieht sich auf diesen Parameter.

Umwandlungen

Optional. Definiert die Transformationen, die auf die Daten angewendet werden sollen. Informationen zu den verfügbaren Transformationstypen finden Sie unter Datenumwandlungen .

Hinweis: Die folgenden Transformationstypen funktionieren nicht, wenn sie in der Data Workbench-Datei Transform.cfg definiert sind:

  • AppendURI
  • CrossRows
  • ODBCLookup
  • Sessionize
HINWEIS

Wenn zusätzliche Daten empfangen werden, nachdem die Ausgabedateien geschlossen wurden (siehe Log Sources und Offline Mode in der obigen Tabelle), erstellt Transform neue Ausgabedateien mit den zusätzlichen Daten. Die Namen der neuen Ausgabedateien werden aus dem Namen der ursprünglichen Ausgabedatei generiert, wobei eine in Klammern eingeschlossene Versionsnummer direkt vor der Erweiterung hinzugefügt wird. Wenn die ursprüngliche Ausgabedatei beispielsweise 20070701-ABC.vsl lautet, werden nachfolgende Versionen dieser Datei 20070701-ABC(1).vsl, 20070701-ABC(2).vsl usw. benannt. Beachten Sie, dass die Verwendung der versionierten Dateien als Eingabe für den Data Workbench-Server zu Verarbeitungsfehlern führen kann.

Adobe empfiehlt, die Erstellung versionierter Ausgabedateien zu vermeiden, indem sichergestellt wird, dass alle Quelldaten in chronologischer Reihenfolge innerhalb der lexikografisch sortierten Eingabedateien vorliegen und, falls Offline Mode auf "true"gesetzt ist, alle Quelldaten vor Beginn der Verarbeitung vorhanden sind. Weitere Informationen finden Sie in den Einträgen Log Sources und Offline Mode in der obigen Tabelle.

  1. Fügen Sie Umwandlungen hinzu, indem Sie mit der rechten Maustaste auf Transformations klicken und Add new > Transformation type klicken. Füllen Sie die Umwandlungsfelder aus.

    Beschreibungen und Beispiele für die Umwandlungsfunktionen finden Sie unter Datenumwandlungen .

  2. Klicken Sie oben im Fenster mit der rechten Maustaste auf (modified) und klicken Sie dann auf Save.

  3. Damit die lokal vorgenommenen Änderungen wirksam werden, klicken Sie in der Spalte Profile Manager mit der rechten Maustaste auf das Häkchen für Data Workbench Transform.cfg in der Spalte User und klicken Sie dann auf Save to > profile name, wobei der Profilname der Name des Profils ist, für das Sie Daten exportieren. Die erneute Verarbeitung der Daten beginnt nach der Synchronisierung des Profils.

    HINWEIS

    Informationen zur erneuten Verarbeitung Ihrer Daten für den Export finden Sie unter Wiederaufbereitung und erneute Umwandlung.

Auf dieser Seite