Lernprogramm: Hinzufügen einer Transformation für Azure Cosmos DB Arbeitsbereichsdaten mithilfe des Azure-Portals

Dieses Lernprogramm führt Sie durch die Konfiguration einer Beispieltransformation in einer Regel für die Arbeitsbereichsdatenerfassung (DCR) mithilfe des Azure-Portals.

Arbeitsbereichtransformationen werden in einem einzelnen DCR für den Arbeitsbereich gespeichert, der als Arbeitsbereich-DCR bezeichnet wird. Jede Transformation ist einer bestimmten Tabelle zugeordnet. Die Transformation wird auf alle Daten angewendet, die von keinem Workflow mit einem DCR an diese Tabelle gesendet werden.

In diesem Tutorial erfahren Sie, wie:

Prerequisites

Um die Schritte dieses Tutorials abzuschließen, benötigen Sie Folgendes:

• Einen Log Analytics-Arbeitsbereich, in dem Sie mindestens über Berechtigungen als Mitwirkender verfügen.
• Berechtigungen zum Erstellen von DCR-Objekten im Arbeitsbereich
• Eine Tabelle, die bereits daten enthält.
• Die Tabelle kann nicht mit der Arbeitsbereichstransformation DCR verknüpft werden.

Übersicht über das Lernprogramm

In diesem Lernprogramm verringern Sie die Speicheranforderung für die CDBDataPlaneRequests Tabelle, indem Sie bestimmte Datensätze herausfiltern. Außerdem entfernen Sie den Inhalt einer Spalte, während Sie die Spaltendaten analysieren, um eine Datenmenge in einer benutzerdefinierten Spalte zu speichern. Die CDBDataPlaneRequests-Tabelle wird erstellt, wenn Sie die Protokollanalyse in einem Arbeitsbereich aktivieren.

In diesem Lernprogramm wird das Azure-Portal verwendet, das Ihnen einen Assistent bietet, um Sie durch den Prozess des Erstellens einer Ingestion-time Transformation zu führen. Nachdem Sie die Schritte abgeschlossen haben, werden Sie sehen, dass der Assistent:

• Aktualisiert das Tabellenschema mit allen anderen Spalten aus der Abfrage.
• Erstellt einen WorkspaceTransformation DCR und verknüpft ihn mit dem Arbeitsbereich, wenn ein Standard-DCR noch nicht mit dem Arbeitsbereich verknüpft ist.
• Erstellt eine Aufnahmezeittransformation und fügt sie dem DCR hinzu.

Aktivieren von Abfrageüberwachungsprotokollen

Sie müssen die Protokollanalyse für Ihren Arbeitsbereich aktivieren, um die Tabelle zu erstellen, mit der CDBDataPlaneRequests Sie arbeiten. Dieser Schritt ist für alle Erfassungszeittransformationen nicht erforderlich. Es dient nur dazu, die Beispieldaten zu generieren, mit denen wir arbeiten.

Hinzufügen einer Transformation zur Tabelle

Nachdem die Tabelle erstellt wurde, können Sie die Transformation dafür erstellen.

1. Wählen Sie im Menü Log Analytics Arbeitsbereiche im Azure Portal Tables aus. Suchen Sie die CDBDataPlaneRequests Tabelle, und wählen Sie "Transformation erstellen" aus.

   

2. Da diese Transformation die erste im Arbeitsbereich ist, müssen Sie einen Arbeitsbereichs-Transformation-DCR erstellen. Wenn Sie Transformationen für andere Tabellen im selben Arbeitsbereich erstellen, werden sie in diesem dcR gespeichert. Wählen Sie " Neue Datensammlungsregel erstellen" aus. Die Gruppe "Abonnement " und "Ressource" werden bereits für den Arbeitsbereich ausgefüllt. Geben Sie einen Namen für den DCR ein, und wählen Sie "Fertig" aus.

3. Wählen Sie Weiter aus, um Beispieldaten aus der Tabelle anzuzeigen. Während Sie die Transformation definieren, wird das Ergebnis auf die Beispieldaten angewendet. Aus diesem Grund können Sie die Ergebnisse auswerten, bevor Sie sie auf tatsächliche Daten anwenden. Wählen Sie den Transformations-Editor aus, um die Transformation zu definieren.

   

4. Im Transformations-Editor können Sie die Transformation sehen, die vor der Aufnahme in die Tabelle auf die Daten angewendet wird. Eine virtuelle Tabelle mit dem Namen source stellt die eingehenden Daten dar, die denselben Satz von Spalten wie die Zieltabelle selbst aufweisen. Die Transformation enthält zunächst eine einfache Abfrage, die die source Tabelle ohne Änderungen zurückgibt.

5. Ändern Sie die Abfrage in das folgende Beispiel:

   source
   | where StatusCode != 200 // searching for requests that are not successful
   | project-away Type, TenantId
   

   Die Änderung nimmt die folgenden Änderungen vor:

   • Zeilen im Zusammenhang mit der Abfrage der CDBDataPlaneRequests Tabelle selbst wurden gelöscht, um Speicherplatz zu sparen, da diese Protokolleinträge nicht hilfreich sind.
   • Daten aus den TenantId Und Type Spalten wurden entfernt, um Platz zu sparen.
   • Transformationen unterstützen auch das Hinzufügen von Spalten mithilfe des extend Operators in Ihrer Abfrage.

   Note

   Bei Verwendung des Azure Portals initiiert die Ausgabe der Transformation ggf. Änderungen am Tabellenschema. Falls sie noch nicht existieren, werden Spalten hinzugefügt, damit sie mit der Transformationsausgabe übereinstimmen. Stellen Sie sicher, dass ihre Ausgabe keine Spalten enthält, die Sie der Tabelle nicht hinzufügen möchten. Wenn die Ausgabe keine Spalten enthält, die sich bereits in der Tabelle befinden, werden diese Spalten nicht entfernt, aber keine Daten hinzugefügt.

   Alle benutzerdefinierten Spalten, die einer integrierten Tabelle hinzugefügt werden, müssen in enden _CF. Spalten, die einer benutzerdefinierten Tabelle hinzugefügt wurden, müssen dieses Suffix nicht aufweisen. Eine benutzerdefinierte Tabelle hat einen Namen, der mit _CL endet.

6. Kopieren Sie die Abfrage in den Transformations-Editor, und wählen Sie "Ausführen" aus, um Ergebnisse aus den Beispieldaten anzuzeigen. Sie können überprüfen, ob sich die neue Workspace_CF Spalte in der Abfrage befindet.

   

7. Wählen Sie Anwenden aus, um die Transformation zu speichern, und dann Weiter, um die Konfiguration zu überprüfen. Wählen Sie Erstellen aus, um die DCR mit der neuen Transformation zu aktualisieren.

   

Testen der Transformation

Lassen Sie etwa 30 Minuten zu, bis die Transformation wirksam wird, und testen Sie sie dann, indem Sie eine Abfrage für die Tabelle ausführen. Diese Transformation betrifft nur Daten, die nach der Anwendung der Transformation an die Tabelle gesendet wurden.

Führen Sie in diesem Lernprogramm einige Beispielabfragen aus, um Daten an die CDBDataPlaneRequests Tabelle zu senden. Erstellen Sie einige Abfragen gegen CDBDataPlaneRequests, damit Sie überprüfen können, ob die Transformation diese Datensätze filtert.

Troubleshooting

In diesem Abschnitt werden verschiedene Fehlerbedingungen, die auftreten können, und deren Behebung beschrieben.

IntelliSense in Log Analytics erkennt die neuen Spalten in der Tabelle nicht.

Die Aktualisierung des Caches, auf dem IntelliSense basiert, kann bis zu 24 Stunden dauern.

Die Transformation einer dynamischen Spalte funktioniert nicht

Ein bekanntes Problem betrifft derzeit dynamische Spalten. Eine temporäre Problemumgehung besteht darin, dynamische Spaltendaten explizit zu parsen, indem Sie parse_json() verwenden, bevor Sie Vorgänge darauf ausführen.

Nächste Schritte