Oracle Cloud Infrastructure-Dokumentation

Abfragenbasiertes Widget mit Traces erstellen

Sie können ein abfragebasiertes Widget mit Application Performance Monitoring-Traces erstellen.

Mit den vielen im abfragebasierten Widget Builder verfügbaren Features können Sie ein Widget erstellen, das einen Trace Query Language-(TQL-)Ausdruck anzeigt. Der abfragebasierte Widget Builder bietet Ihnen Optionen und Funktionen zur Visualisierung und Überwachung von Tracedaten. Beispiel: Sie können Transaktionen anzeigen, die bei Verwendung durch viele Kunden eine niedrige Performance erzielt haben. Dadurch sind diese Transaktionen der Performanceverbesserung würdig.

So erstellen Sie ein abfragebasiertes Widget, das Tracedaten anzeigt:

  1. Gehen Sie zur Seite Dashboards.
  2. Klicken Sie auf Dashboard erstellen, um ein neues Dashboard zu erstellen oder ein vorhandenes Dashboard im Bearbeitungsmodus zu öffnen.
  3. Klicken Sie auf der Registerkarte Widgets auf das Symbol Widgetgruppe und Widgets hinzufügen (Widgetgruppe und Widgets hinzufügen), und klicken Sie auf Abfragebasiertes Widget erstellen....
    Der abfragebasierte Widget Builder wird angezeigt.
  4. Klicken Sie optional auf das Symbol Filterbereich öffnen/schließen (Filterbereich öffnen/schließen), um die Filter anzuzeigen, die dem Dashboard bereits hinzugefügt wurden, und bei Bedarf Änderungen vorzunehmen.

    Beachten Sie, dass beim Erstellen eines abfragebasierten Widgets zum Hinzufügen zu einem neuen Dashboard automatisch ein Filter für das Compartment hinzugefügt wird und die Compartment-Eingabe für das neu erstellte Widget mit diesem neu hinzugefügten Filter verknüpft wird.

  5. Wählen Sie in der oberen rechten Ecke einen Zeitraum aus, für den Sie Daten im Widget anzeigen möchten.
  6. Wählen Sie Traces in der Dropdown-Liste Datenquelle aus.
    Wenn dem Dashboard kein Filter APM-Domain hinzugefügt wird, wird er automatisch hinzugefügt, wenn Traces ausgewählt wird.
  7. Bearbeiten Sie die im Feld Abfrage angezeigte Standardabfrage, oder geben Sie eine neue Abfrage ein, und klicken Sie auf Ausführen.

    Verwenden Sie die TQL-Syntax, um Abfragen zu erstellen und Tracedaten aus Application Performance Monitoring abzurufen. Weitere Informationen zu TQL finden Sie unter Mit Abfragen arbeiten.

    Die Tracedaten werden tabellarisch mit dem Namen des Service und anderen Details angezeigt. Unter dem Diagramm Tabelle wird eine weitere Tabelle mit den von der Traceabfrage zurückgegebenen Rohdaten angezeigt. Sie können auf Rohdaten ausblenden klicken, um sie auszublenden.

  8. Verwenden Sie die folgenden Registerkarten auf der rechten Seite, um Aufgaben wie das Hinzufügen eines Namens für das Widget und das Anpassen der Visualisierung von Daten im Widget auszuführen:
    Hinweis

    Sie können in der oberen rechten Ecke auf JSON klicken, um die JSON-Metadaten des Widgets direkt zu bearbeiten. Der JSON-Editor bietet Ihnen mehr Flexibilität und mehr Optionen zur Visualisierung von Daten im Widget. Es wird jedoch empfohlen, ihn nur zu verwenden, wenn Sie mit der Bearbeitung von Widget-JSON vertraut sind. Weitere Informationen zum JSON-Editor erhalten Sie von Oracle Support.
    • Info: Geben Sie einen Namen für das Widget ein, wählen Sie das Compartment aus, in dem das Widget gespeichert werden soll, und fügen Sie eine Beschreibung für das Widget hinzu.

      Klicken Sie optional auf Erweiterte Optionen anzeigen, um dem Widget Freiformtags oder definierte Tags hinzuzufügen. Wenn Sie über die erforderlichen Berechtigungen zum Erstellen eines Widgets verfügen, sind Sie auch berechtigt, Freiformtags hinzuzufügen. Um ein definiertes Tag hinzuzufügen, benötigen Sie Berechtigungen zum Verwenden des Tag-Namespace. Weitere Informationen:

    • Visualisierung: Wählen Sie einen Diagrammtyp aus, und passen Sie die Visualisierung an, indem Sie zusätzliche Optionen angeben oder ändern.

      Informationen zu Diagrammtypen und Visualisierungsoptionen in einem abfragebasierten Widget-Builder finden Sie unter Informationen zu Diagrammtypen und Visualisierungsoptionen.

    • Einstellungen: Prüfen und bearbeiten Sie Widgeteingaben, falls erforderlich.
  9. Klicken Sie auf Speichern, um das Widget in der Widgetbibliothek zu speichern und dem Dashboard hinzuzufügen.

Im Folgenden finden Sie ein Szenario, in dem die Top 5 Transaktionen im angegebenen Zeitraum mit einem Liniendiagramm angezeigt werden. Im abfragebasierten Widget Builder:

  1. Stellen Sie sicher, dass der Zeitraum in der oberen rechten Ecke ausgewählt ist.
  2. Wählen Sie in der Dropdown-Liste Datenquelle die Option Traces aus.
  3. Geben Sie im Feld Abfrage das folgende Trace ein, und klicken Sie auf Ausführen.
    show traces OperationName as Transaction, avg(traceDuration) as Duration where pageviews > 0 group by OperationName order by count(*) first 5 rows timeseries
  4. Geben Sie auf der Registerkarte Visualisierung Folgendes an:
    1. Wählen Sie als Diagrammtyp das Diagramm Linie aus.
    2. Wählen Sie in der Dropdown-Liste Y-Achse die Option timeseries.Duration aus.
    3. Wählen Sie in der Dropdown-Liste X-Achse die Option timeseries.date aus.
    4. Wählen Sie in der Dropdown-Liste Serie die Option Transaktion aus.
    5. Wählen Sie in der Dropdown-Liste Farbe nach die Option Transaktion aus.

Ein Liniendiagramm mit den Top 5 Transaktionen wird angezeigt.

Abfragebasiertes Trace-Widget