Variablentypen

Sie können zwischen verschiedenen Variablentypen wählen.

Variablen mit statischem Wert

Sie können manuell eine feste Liste von Variablenwerten definieren, z. B. eine Zahl oder eine durch ein Komma getrennte Zahlenfolge. Wenn Sie z. B. Ländernamen haben, die sich nie ändern, sollten Sie diese als Variable mit statischem Wert und nicht als Abfragevariable für die Datenquelle erstellen.

Abfrage der Variablen

Die Variablenwerte werden aus einer Abfrage von Protokollen oder Metrikdatenquellen abgerufen. Eine Abfragevariable kann beispielsweise eine Liste von Servernamen, Sensor-IDs oder Datenzentren generieren und die Werte dynamisch aktualisieren, indem sie Optionen mit Hilfe einer Datenquellenabfrage abruft. Abfragevariablen sind von Vorteil, wenn mehrere Datenquelleninstanzen verwaltet werden, insbesondere in unterschiedlichen Umgebungen.

Definieren von Variablen für benutzerdefinierte Dashboards

1. Melden Sie sich bei Ihrem IBM Cloud Konto an.

2. Zugriff auf Ihre IBM Cloud Logs Instanz

3. Klicken Sie auf das Dashboard-Symbol > Benutzerdefinierte Dashboards.

4. Klicken Sie in einem neuen oder bestehenden Dashboard auf das Symbol Verwaltete Variable { }.

5. Klicken Sie auf + Variable.

6. Für alle Variablentypen konfigurieren Sie die folgenden Felder:

   • Variable Art.

   • Der Variablenname. Der Text, der in dieses Feld eingegeben wird, bestimmt, wie der Variablenname in Ihrer Abfrage erscheint, zum Beispiel {{ podvalues }}. Großbuchstaben und Leerzeichen sind im Variablennamen nicht erlaubt.

   • Anzeigename (optional). Der Text, der in dieses Feld eingegeben wird, erscheint in der Auswahl als Teil der Dropdown-Liste, z. B. "Meine Pods".

   • Auswahlmöglichkeit.

     Mehrwertig

     Mehrwertig gibt an, dass der Benutzer mehrere Werte innerhalb einer bestimmten Variablen auswählen kann. Einige Abfragen unterstützen keine Mehrfachwerte, wie z. B. {{ variablename }}. Wählen Sie diese Option nur, wenn Ihre Abfrage mehrere Werte unterstützt.

     Alle einschließen

     Alle einbeziehen kann ausgewählt werden, wenn die Option Mehrwerte aktiviert ist. Die Abfrage wählt alle verfügbaren und zukünftigen Werte für einen bestimmten Zeitrahmen aus, unabhängig von Ihrer spezifischen Auswahl. Wenn beide Optionen ausgewählt sind, sind alle variablen Optionen standardmäßig ausgewählt, und eine oder mehrere können abgewählt werden. Wenn keine der beiden Optionen angegeben ist, können Sie jeweils nur einen Variablenwert auswählen.

7. Für Variablen des Typs query :

   • Geben Sie die Abfragequelle an (logs oder metrics).

   • Für variable type geben Sie values für logs an. Für metrics geben Sie metric names, metric labels oder label values an. Wenn Sie metric labels wählen, wählen Sie die Bezeichnung, die für die angezeigten Werte verwendet werden soll.

   • Für logs definieren Sie das Feld, indem Sie einen Protokollschlüssel auswählen, den Sie abfragen möchten. Eine Liste der aktuellen Variablenwerte wird in der Wertevorschau in alphanumerischer Reihenfolge angezeigt.

   • Für metrics geben Sie unter Metrics regex einen Regex-Ausdruck ein, um die Liste der Metriken zu erhalten, die Sie angezeigt haben möchten. Zum Beispiel gibt ^kube(.*) alle Metriknamen zurück, die mit kube beginnen.

     • Wählen Sie unter label values unter Metrische Bezeichnung die Bezeichnung für die angezeigten Werte. Machen Sie die Beschriftung dynamisch, indem Sie eine Variable einfügen, zum Beispiel Pod Name = {{ pod }}.

     • Unter label values können Sie für Etikettenfilter eine oder mehrere verschachtelte Variablen und eine zusätzliche Filterebene für Ihre Abfrage erstellen. Sie können zum Beispiel die Beschriftungen nach Clustern filtern, indem Sie einen Wert auswählen, der {{ podvalue }} oder der hartcodierte Name Ihres Clusters ist.

     • Legen Sie unter metrics für Variablenwert-Anzeigename fest, wie die Werte in der Dropdown-Auswahlliste angezeigt werden.

       Eine Liste der aktuellen Variablenwerte für das Feld wird in der Wertevorschau angezeigt.

   • Wählen Sie unter Werte sortieren, wie die Daten in der Wertevorschau sortiert werden sollen.

8. Klicken Sie auf Speichern.

In der Liste der definierten Variablen können auch Variablen bearbeitet oder gelöscht werden.

Variablen in Abfragen verwenden

Neben der Verwendung von Variablen in benutzerdefinierten Dashboards können Sie auch definierte Variablen in Lucene-, DataPrime,- und PromQL-Abfragen verwenden.

sum_over_time(kube_pod_owner[${__range}])