IBM Cloud Logs-Messanzeigewidget erstellen

Sie können ein Messgeräte-Widget erstellen, das in benutzerdefinierte IBM® Cloud Logs Dashboards aufgenommen werden kann.

Verwenden Sie ein Messgeräte-Widget, um einen einzelnen Wert innerhalb eines bestimmten Bereichs anzuzeigen, der oft einem Tachometer oder einer Skala ähnelt. Sie wird in der Regel verwendet, um Schlüsselkennzahlen und Leistungsindikatoren auf einen Blick darzustellen.

Messgeräte verfügen über Schwellenwerte, mit denen Sie das Erscheinungsbild der Visualisierung ändern können, wenn bestimmte Werte erreicht oder überschritten werden. Wenn Sie einen Datensatz nach einem bestimmten Parameter gruppieren, erstellen Sie ein Mehrfachmessgerät, wobei jedes Messgerät eine Teilmenge der Daten darstellt. Dies ermöglicht einen gleichzeitigen Vergleich über verschiedene Kategorien oder Gruppen hinweg und bietet so einen breiteren Überblick über die Leistung.

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 Messanzeige aus der Seitenleiste und legen Sie es ab.

  2. Ersetzen Sie Neues Messgerät durch den Namen des Widgets.

  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 Leggend-Einstellungen.

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.

  4. [Optional] Fügen Sie einen oder mehrere für das Widget spezifische Filter hinzu, um die Daten einzugrenzen, die in Ihrem Messgerät angezeigt werden.

    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.

  6. Fügen Sie 1 oder mehrere Felder in Gruppieren nach hinzu, um mehrere Messgeräte zu erstellen.

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 Threshold.

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

    Schwellenwerte kategorisieren Werte auf der Grundlage vordefinierter Grenzwerte wie normal, Warnung, kritisch und helfen zu erkennen, ob eine Kennzahl innerhalb eines akzeptablen Bereichs liegt oder einen Warnzustand erreicht hat.

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

    Der innere Bogen zeigt den tatsächlichen Wert für Ihre Abfrage an.

    Der äußere Bogen zeigt die von Ihnen definierten Schwellenwerte an.

    Aktivieren Sie den inneren Bogen, den äußeren Bogen oder beide, um einen einzelnen Wert innerhalb eines bestimmten Bereichs anzuzeigen, der oft an einen Tachometer oder eine Skala erinnert.

    Wenn der innere Bogen und der äußere Bogen deaktiviert sind, wird das numerische Ergebnis Ihrer Abfrage als STAT-Widget ohne zusätzliche Visualisierungen angezeigt. In diesem Fall können Sie festlegen, ob die Schwellenwertfarbe auf den Wert oder den Hintergrund angewendet werden soll. In diesem Teil der Konfiguration legen Sie die gewünschte Schwellenwert-Farboption fest. Sie können Wert wählen, um die Schwellenwertfarbe für den Wert festzulegen, oder Sie können Hintergrund wählen, um den Hintergrund mit der Schwellenwertfarbe festzulegen.

  4. Konfigurieren Sie den Abschnitt Schwellenwerte.

    Ein Schwellenwert ist ein von Ihnen festgelegter Wert, bei dessen Erreichen oder Überschreiten sich die Darstellung der Visualisierung auf der Grundlage der Abfrageergebnisse ändert. Als Werte können Sie zwischen prozentualen und absoluten Zahlen wählen.

    Wählen Sie den Schwellenwerttyp. Gültige Optionen sind: absolute, um bestimmte Zahlen als Wert zu definieren, und percentage, um Werte zu definieren, die sich auf den Mindest- oder Höchstwert beziehen.

    Sie können die Farbe eines Schwellenwerts ändern.

    Sie können die Werte für einen Schwellenwert festlegen und Beschriftungen hinzufügen, die ihn beschreiben.

    Sie können zusätzliche Schwellenwerte hinzufügen.

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.