Felder reservieren

IBM® Cloud Logs indiziert Ihre Daten in der Reihenfolge der Aufnahme. Wenn die maximale Anzahl der gespeicherten Felder erreicht ist, stehen möglicherweise keine weiteren Felder mehr für Abfragen zur Verfügung. Mit reservierten Feldern können Sie explizit wichtige Felder definieren, die Sie immer abfragen wollen, und gleichzeitig IBM Cloud Logs die Möglichkeit geben, andere Felder dynamisch hinzuzufügen, sobald sie gefunden werden.

Mit reservierten Feldern können Sie:

  • Stellen Sie sicher, dass wichtige Felder immer für Abfragen verfügbar sind.

  • Geben Sie den Datentyp für jedes Feld an, um die Speicherung und Abfrage effizienter zu gestalten.

  • Definieren Sie die Felder, die Sie benötigen, damit diese Felder für eine bessere Abfrageleistung verfügbar sind.

Beim Einlesen der Daten werden die Felder in einem Index abgebildet. Die automatische Zuordnung fügt dynamisch Felder hinzu, aber diese Felder können mit einem unerwünschten Datentyp verknüpft sein, wenn ein Feld mit demselben Namen zuerst aufgenommen wird. Mit reservierten Feldern definieren Sie Felder und den zugehörigen Datentyp vor.

Reservierte Felder werden jeden Tag um 00:00 Uhr UTC bei der Erstellung des Tagesindexes angewendet. Reservierte Felder sind in der täglichen Indexgrenze enthalten.

Datentypen

Jedes reservierte Feld ist mit einem Datentyp verbunden.

Felddatentypen
Datentyp Beschreibung Beispiel für die Verwendung von JSON
boolean Stellt einen true oder false Wert dar. Der Datentyp boolean wird üblicherweise für logische Prüfungen und Bedingungen verwendet. true oder false
string Eine Folge von Zeichen. Der Datentyp string wird häufig für Textbezeichner oder alphanumerische Daten verwendet. Gespeichert im Format UTF-8. "example text"
number Ein numerischer Wert. Der Datentyp number kann entweder eine Ganzzahl oder eine Gleitkommazahl sein. Der Wert kann für Berechnungen oder Messungen verwendet werden. 123 oder 45.67

Erforderliche Berechtigungen

Um reservierte Felder zu konfigurieren, müssen Sie über eine IAM-Rolle mit den erforderlichen Aktionen verfügen:

Für reservierte Felder erforderliche IAM-Aktionen
Aktion Beschreibung
logs.reserved-field.read Reservierte Felder anzeigen.
logs.reserved-field.manage Reservierte Felder aktualisieren, löschen oder erstellen.

Definition von reservierten Feldern

Sie können reservierte Felder auf zwei Arten definieren:

  • Durch die Auswahl von Feldern, die zuvor von IBM Cloud Logs aufgenommen, zugeordnet und indiziert wurden.

  • Durch die manuelle Definition von Feldern und ihrem zugehörigen Datentyp.

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

  2. Zugriff auf Ihre IBM Cloud Logs Instanz

  3. Klicken Sie auf das Symbol Datenpipeline Datenpipeline > Reservierte Felder.

  4. Klicken Sie auf + Feld hinzufügen.

  5. Geben Sie unter Feldname einen Feldnamen ein.

    • Wenn das Feld über IBM Cloud Logs zugeordnet ist, können Sie das Feld und die Zuordnung aus der Liste auswählen.

    Sie können auch auf Vollständige Liste anzeigen klicken, um alle derzeit zugeordneten Felder zu sehen. Sie können die Liste auf einen bestimmten Zeitraum beschränken. Es stehen bis zu 7 Tage lang Felder zur Verfügung, die von IBM Cloud Logs verarbeitet werden.

    • Wenn das Feld nicht zugeordnet ist, können Sie einen Feldnamen eingeben und den Typ auswählen, der mit dem Feld verknüpft werden soll.

  6. Klicken Sie auf Speichern.

Gleichzeitiges Hinzufügen mehrerer reservierter Felder

Wenn Sie mehrere reservierte Felder, die durch IBM Cloud Logs zugeordnet sind, gleichzeitig hinzufügen möchten, können Sie die Option "In großen Mengen hinzufügen" verwenden.

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

  2. Zugriff auf Ihre IBM Cloud Logs Instanz

  3. Klicken Sie auf das Symbol Datenpipeline Datenpipeline > Reservierte Felder.

  4. Klicken Sie auf Hinzufügen in der Masse.

  5. Wählen Sie die vorhandenen Felder aus, die Sie als reservierte Felder hinzufügen möchten.

    Sie können sowohl nach Feldern suchen als auch die Suche auf einen bestimmten Zeitraum beschränken.

  6. Klicken Sie auf Zur Liste hinzufügen, um die ausgewählten Felder als reservierte Felder hinzuzufügen.

Pflege der reservierten Felder

Sie können ein reserviertes Feld bearbeiten und reservierte Felder, die Sie nicht mehr benötigen, entfernen.

Sie müssen zum Beispiel ein reserviertes Feld bearbeiten, wenn Sie feststellen, dass der mit dem Feld verknüpfte Datentyp nicht korrekt ist.