Widget mit vertikalem Balken für IBM Cloud Logs erstellen

Sie können ein vertikales Balkendiagramm erstellen, das in benutzerdefinierte IBM® Cloud Logs Dashboards aufgenommen werden kann.

Verwenden Sie vertikale Balkendiagramme, um Ihre Daten alphabetisch zu sortieren, und zwar standardmäßig nach Spaltennamen. In horizontalen Balkendiagrammen werden die Daten normalerweise nach Wert sortiert.

Schritt 1: Name und Beschreibung eingeben

Führen Sie die folgenden Schritte aus:

  1. Klicken Sie in einem angepassten Dashboard auf Widget hinzufügen Symbol 'Widget hinzufügen' und ziehen Sie das Widget Vertikales Balkendiagramm aus der Seitenleiste und legen Sie es dort ab.

  2. Ersetzen Sie Neues vertikales Balkendiagramm durch den Namen für das Widget.

  3. Geben Sie eine Beschreibung ein.

    Klicken Sie auf das Aktionssymbol Aktionssymbol. Wählen Sie dann Beschreibung hinzufügen.

  4. Legen Sie fest, wo die Legendenwerte angezeigt werden. Gültige Werte sind: Side, Bottom, Auto, und Hide.

    Klicken Sie auf das Aktionssymbol Aktionssymbol. Wählen Sie dann Legendeneinstellungen.

Schritt 2: Konfigurieren Sie die Abfrage, um den Datensatz zu definieren

Führen Sie die folgenden Schritte aus:

  1. Klicken Sie auf das Aktionssymbol Aktionssymbol. Wählen Sie dann den Bearbeitungsmodus.

  2. Für Query 1 führen Sie die folgenden Schritte aus:

    Wählen Sie den Datentyp. Gültige Werte sind: Logs, Metrics, und DataPrime.

    Wählen Sie die Quelle. Gültige Optionen sind: Priority Insights und Analyze and Alert.

    Sie können die Abfrage umbenennen. Wählen Sie das Aktionssymbol und klicken Sie dann auf Abfrage umbenennen.

  3. Geben Sie die Abfrage ein.

    Wenn der Datentyp DataPrime ist, geben Sie eine Dataprime-Abfrage in das Feld Abfrage ein.

    Wenn der Datentyp Logs ist, geben Sie eine Lucene-Abfrage in das Feld Abfrage ein. Sie können Filter und Aggregationen anwenden.

    Wenn der Datentyp Metrics ist, geben Sie im Feld Abfrage die Metrik oder die gewünschte PromQL an. Sie können Filter und Aggregationen anwenden.

    Wenn Sie ein Balkendiagramm mit Metriken als Datentyp erstellen, werden die in der Abfrage PromQL angegebenen Kategorien automatisch im Feld Gruppieren nach angezeigt. Sie können die Kategorien im Feld Gruppieren nach durch Ziehen und Ablegen neu anordnen. Ziehen Sie Kategorien aus dem Feld Kategorie in das Feld Stapeln, um sie nach einer bestimmten Kategorie zu stapeln.

  4. [Optional] Fügen Sie einen oder mehrere für das Widget spezifische Filter hinzu, um die angezeigten Daten einzugrenzen.

    Wählen Sie ein Etikett und den entsprechenden Wert aus.

    Filter werden auf der Ebene des Widgets angewendet und funktionieren parallel zu den Dashboard-Filtern. Wenn es einen Konflikt gibt, haben die Dashboard-Filter Vorrang vor den Widget-Filtern.

  5. Fügen Sie eine Funktion hinzu.

    Bei einer Abfrage, deren Datentyp Logs ist, können Sie einen aggregierten Wert mit einer der folgenden Funktionen anzeigen:

    Aggregationsoption beim Erstellen einer Abfrage, wenn der Datentyp Logs ist
    Aggregation Beschreibung
    Anzahl Die Gesamtzahl der Protokolle innerhalb des ausgewählten Zeitraums.
    Anzahl eindeutiger Elemente Die Anzahl der eindeutigen Protokolle innerhalb des ausgewählten Zeitraums.
    Summe Die Summe aller Protokolle innerhalb des ausgewählten Zeitraums.
    Min Der kleinste Wert unter den Protokollen innerhalb des ausgewählten Zeitraums.
    Max. Der größte Wert unter den Protokollen innerhalb des ausgewählten Zeitraums.
    Durchschnitt Der Durchschnittswert aller Protokolle innerhalb des ausgewählten Zeitraums.
    Perzentil XX Stellt den Wert dar, unter den XX% der Stämme fallen. Perzentil 95 ist zum Beispiel der Wert, unter den 95 % der Stämme fallen.

    Für eine Abfrage, deren Datentyp Metrics ist, können Sie einen berechneten Wert mit einer der folgenden Funktionen anzeigen:

    Berechnungsoption beim Erstellen einer Abfrage, wenn der Datentyp Metrics ist
    Berechnung Beschreibung
    Sofort Der Wert zum aktuellen Zeitpunkt.
    Letzte Der jüngste Wert innerhalb des ausgewählten Zeitraums.
    Min Der kleinste Wert innerhalb des gewählten Zeitraums.
    Max. Der größte Wert innerhalb des ausgewählten Zeitraums.
    Durchschnitt Der Durchschnittswert aller Datenpunkte innerhalb des ausgewählten Zeitraums.
    Summe Die Gesamtsumme aller Datenpunkte innerhalb des ausgewählten Zeitraums.
    Keine Es wird keine Berechnung durchgeführt. Es werden Rohdaten verwendet.

Schritt 3: Konfigurieren Sie das Widget

Führen Sie die folgenden Schritte aus:

  1. Klicken Sie auf das Aktionssymbol Aktionssymbol. Wählen Sie dann den Bearbeitungsmodus.

  2. Wählen Sie eine Option für die Legendenverwaltung. Gültige Werte sind: Group und Stack.

    Gruppieren organisiert die Legende auf der Grundlage verschiedener Dateneinheiten, wie z. B. Server oder Anwendungen, wobei jede als separater Eintrag angezeigt wird.

    Stapel zeigt an, wie mehrere Dateneinträge auf derselben horizontalen Leiste gruppiert und übereinandergelegt werden. Die Datensätze desselben Stapels werden in einem einzigen horizontalen Balkendiagramm gruppiert und in Segmente unterteilt. Dadurch wird eine zweite Datenebene im Diagramm angezeigt.

    Legenden-Farbschema: Wählen Sie aus, ob Sie die Legendenfarben nach Gruppe, Stapel oder Aggregation sortieren möchten. Standardmäßig wird das horizontale Balkendiagramm durch Aggregation erstellt, d. h. es wird für alle Balken eine einzige Farbe angezeigt.

  3. Wählen Sie im Abschnitt Visuelle Verwaltung, wie Sie die Daten visualisieren möchten.

    Das Diagramm max bar by zeigt die maximale Anzahl der einzelnen Balken in einer einzelnen Diagrammansicht entsprechend Ihrer Abfrage an.

    Die maximale Anzahl von Slices pro Balken zeigt die maximale Anzahl von Segmenten innerhalb eines einzelnen Balkens an.

    Aktivieren Sie den maximalen Balken pro Diagramm, die maximalen Slices pro Balken oder beides, um einen einzelnen Wert innerhalb eines bestimmten Bereichs anzuzeigen.

  4. Konfigurieren Sie den Bereich Skala.

    Eine Skala bezieht sich darauf, wie die Werte entlang der x- und y-Achse angezeigt werden. Als Werte können Sie zwischen linear und logarithmisch wählen.

    Wählen Sie den Typ der Skala. Gültige Optionen sind: Linear, die definiert, wie Werte proportional ansteigen, und Logarithmic, wobei der Wert durch Logarithmen anstelle von gleichen linearen Intervallen definiert wird.

    Sie können die Farbe eines Schwellenwerts ändern.

    Die Standardeinstellung ist linear. Wenn jedoch große Unterschiede zwischen den verschiedenen Werten bestehen, kann es hilfreich sein, stattdessen die logarithmische Skala anzuzeigen. Wenn z. B. die meisten Werte unter 1k liegen und ein Wert 10k ist, können Sie mit der logarithmischen Skala ein besser lesbares Balkendiagramm erstellen als mit der linearen Skala.

Schritt 4: Speichern Sie das Widget

Führen Sie die folgenden Schritte aus:

  1. [Optional] Legen Sie die Dashboard-Zeit des Widgets fest, wenn Sie einen anderen Zeitbereich als den im Dashboard ausgewählten verwenden möchten.

  2. Klicken Sie auf Speichern, um Ihr Widget zu speichern.

  3. [Optional] Teilen Sie einen direkten Link zum Widget. Klicken Sie auf das Aktionssymbol Aktionssymbol. Wählen Sie dann Share Widget URL, und kopieren Sie die URL.

    Jeder, der Zugriff auf das Dashboard hat, kann den freigegebenen Link öffnen, um das Widget im Kontext zu sehen.

    Freigegebene Widget-URLs geben immer die zuletzt gespeicherte Version des Dashboards wieder. Wenn Sie Änderungen am Widget oder Layout vorgenommen haben, speichern Sie Ihr Dashboard vor der Freigabe.

  4. [Optional] Fügen Sie eine benutzerdefinierte Aktion hinzu. Weitere Informationen finden Sie unter Verwendung von Aktionen zur Integration mit Diensten von Drittanbietern.