Amazon S3 Konfigurationsfelder für die Dateneingabe

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer

    • Beschreibung der Felder im Formular Amazon S3 zur Konfiguration der Dateneingabe.

    Basiskonfiguration

    Feld Beschreibung
    Name Name der neuen Dateneingabe. Dies ist ein Pflichtfeld.
    Beschreibung Beschreibung der Dateneingabe
    Ausführen auf Option, um zu bestimmen, ob ein bestimmtes MID-Server - oder ein MID-Server -Cluster verwendet werden soll.

    Diese Funktion wird in der Anwendung Health Log Analytics, Version 26.0.17 – Februar 2023 und höher, die im ServiceNow Storeverfügbar ist, unterstützt.
    MID

    (Nur, wenn das Feld Ausführen auf auf Spezifischer MID-Server gesetzt ist)

    MID-Server, in den Protokolldaten aus Amazon S3 abgerufen werden.
    Hinweis:
    • Sie können nur MID Servers auswählen, die die Standardauthentifizierung unterstützen. MID Servers, die mTLS unterstützen, sind nicht aufgeführt.
    • Die standardmäßige maximale Anzahl von Dateneingaben, die Protokolle an einen einzelnen MID-Server streamen, beträgt 10. Sie können diese Anzahl in den MID Server-Eigenschaften ändern.
    • Wenn die Protokollerfassung für den ausgewählten MID-Servernicht aktiviert ist, wird sie von Health Log Analytics automatisch aktiviert.
    Dies ist ein Pflichtfeld.
    MID-Server-Cluster

    (Nur, wenn das Feld Ausführen auf auf MID-Server Cluster festgelegt ist.)

    Der Cluster MID-Server, in den die Protokolldaten abgerufen werden.

    Die Dateneingabe wird für einen einzelnen MID-Server im Cluster ausgeführt, bis dieser MID-Server ausfällt. Das System verschiebt dann alle Dateneingabeaufgaben entsprechend der konfigurierten Reihenfolge zu den nächsten verfügbaren MID-Server im Cluster.

    Diese Funktion wird in der Anwendung Health Log Analytics, Version 26.0.17 – Februar 2023 und höher, die im ServiceNow Storeverfügbar ist, unterstützt.

    Hinweis:
    • Health Log Analytics unterstützt nur Failover-Cluster MID-Server. In diesen Clustern sind mehrere MID Servers zum Failover-Schutz in einer Gruppe zusammengefasst. Wenn Sie ein Cluster aus dem Dateneingabeformular auswählen, werden in der Liste der Cluster MID-Server nur Failover-Cluster angezeigt.
    • Der Cluster MID-Server darf nur MID Servers enthalten, die die Standardauthentifizierung unterstützen. mTLS wird für die Protokollerfassung nicht unterstützt.
    • Die Protokollerfassung muss für jeden MID-Server im Cluster aktiviert werden. Wenn die Protokollerfassung für den aktiven MID-Servernicht aktiviert ist, wird sie von Health Log Analytics automatisch aktiviert.
    • Die standardmäßige maximale Anzahl von Dateneingaben, die Protokolle an einen einzelnen MID-Server streamen, beträgt 10. Ein Cluster besteht die Kapazitätsvalidierung, wenn es mindestens einen MID-Server enthält und weniger als 10 Dateneingaben darauf ausgeführt werden, selbst wenn dieser MID-Server ausgefallen ist.
    Weitere Informationen zu MID-Server -Clustern finden Sie unter MID-Server-Cluster konfigurieren.

    Dies ist ein Pflichtfeld.
    Serviceinstanz Die Serviceinstanz, an die die Protokolldaten gebunden werden sollen.
    Hinweis:
    Wenn keine relevante Serviceinstanz vorhanden ist, Erstellen Sie eine für Service und fügen Sie CIs hinzu. Legen Sie den Status der neuen Serviceinstanz auf „Funktionsfähig“ fest.
    Dies ist ein Pflichtfeld.

    Die folgenden Felder zeigen schreibgeschützte Informationen:

    Feld Beschreibung
    Status Status der Dateneingabe
    Übertragung Protokoll zum Streamen der Protokolldaten.

    Die Dateneingabe verwendet Amazon S3 zum Streamen von Protokolldaten an Ihre Instanz.
    Quellenanzahl Die Anzahl der Protokollquellen, die diese Dateneingabe erstellt haben.
    Deaktiviert seit Zeitpunkt, zu dem die Dateneingabe gestoppt wurde oder fehlgeschlagen ist.
    Zeit des letzten Protokolls Zeitpunkt, zu dem das letzte Protokoll in die Dateneingabe gestreamt wurde.
    Fehlermeldung Der Streaming-Fehler.

    Dieses Feld wird automatisch ausgefüllt. Wird nur angezeigt, wenn ein Streaming-Fehler aufgetreten ist.
    Tabelle : 1. Registerkarte „Abfrageeinstellungen“.
    Feld Beschreibung Beispiel
    Von/Bis Von/Bis-Datum und -Uhrzeit zum Lesen der Daten.
    • Von: Daten, die älter als dieses Datum und diese Uhrzeit sind, werden nicht gelesen.
      Hinweis:
      Wenn Sie diesen Wert auf ein vergangenes Datum festlegen, muss das System möglicherweise große Datenmengen lesen, was zu einer Überlastung führt.
    • Bis: Daten, die neuer als dieses Datum und diese Uhrzeit sind, werden nicht gelesen. Legen Sie für Live-Daten dieses Datum weit in die Zukunft.
    Dies ist ein Pflichtfeld.
    		 Von: Jetzt -1 Woche

    Bis: 2300-01-01 15:59:59
    Bucket-Name Das zu streamende Amazon S3-Bucket

    Dies ist ein Pflichtfeld.

    		 my-s3-bucket
    Präfix Präfix für die abzurufenden Objekte. Die Dateneingabe ruft nur Objekte ab, die mit diesem Präfix beginnen. Dieses Feld wird normalerweise verwendet, um nur bestimmte Ordner in einem Bucket abzurufen. /nur/dieses/verzeichnis/
    Einbeziehen Datei oder Objekt, die/das einbezogen werden soll, wenn das System einen Musterabgleich durchführt. .*bezieh-mich-ein.*
    Ausschließen Datei oder Objekt, die/das ausgeschlossen werden soll, wenn das System einen Musterabgleich durchführt. .*überspring-mich.*
    Tabelle : 2. Registerkarte „Transport“
    Feld Beschreibung
    AWS-Anmeldeinformationen Feld, das auf die Liste „AWS-Anmeldeinformationen“ (aws_credentials.list) verweist. Die Liste enthält den AWS-Zugriffsschlüssel und den geheimen Zugriffsschlüssel.
    AWS-Region AWS-Region, in der sich das Amazon S3-Bucket befindet, z. B. us-west-1.

    Eine Liste der AWS-Regionen finden Sie unter https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-regions.

    Dies ist ein Pflichtfeld.

    Erweiterte Konfiguration

    Tabelle : 3. Formular „Erweiterte Konfiguration“
    Feld Beschreibung Standardwert
    Anonym Option zum Erzwingen des Zugriffs auf den Amazon S3-Bucket ohne Anmeldeinformationen, wobei Standardanmeldeinformationen, falls vorhanden, ignoriert werden. Falsch
    Durchlaufen Option für den Zugriff auf jedes Verzeichnis im Bucket. Falsch
    Objekte sortiert nach dem Zeitpunkt der letzten Änderung Option zum Abrufen von Objekten, wenn die Objekte im Bucket nach Zeit sortiert sind. Falsch
    Verbindungstimeout Anzahl der Millisekunden, die gewartet werden soll, bevor der AWS-Verbindungsversuch abgebrochen wird. 100
    Threadpool-Größe Anzahl der gleichzeitigen Threads, die Dateien aus dem Bucket herunterladen. 1
    Puffergröße Größe des Download-Puffers in Byte. 100 MB
    Socket-Zeitüberschreitung Anzahl der Millisekunden, die gewartet werden soll, bevor bei einer Datenübertragung über eine hergestellte Verbindung eine Zeitüberschreitung auftritt. 10000
    Max retry for file (Max. Wiederholungsversuche für Datei) Maximale Anzahl der Wiederholungen der Dateiverarbeitung im Fehlerfall. 10
    Standardzeitzone Standardzeitzone, wenn das Protokoll keine Zeitzoneninformationen enthält. UTC
    Anteil der zu verwerfenden Unterstichproben Anzahl der Events, die als Stapel ausgeführt werden sollen und von denen eines verworfen wird. Diese Einstellung wird verwendet, um die Anzahl der abgerufenen Events zu reduzieren. -1
    Anteil der zu empfangenden Unterstichproben Anzahl der Events, die als Stapel ausgeführt werden sollen und von denen alle bis auf eines verworfen werden. Diese Einstellung wird verwendet, um die Anzahl der empfangenen Events zu reduzieren. -1
    Quotengrenze Maximale Anzahl von Events pro Sekunde, die diese Dateneingabe verarbeitet. -1
    Maximale Länge in Bytes Maximale Länge von Events in Byte. 32766
    Zeichencodierung Zeichencodierung für diese Dateneingabe UTF-8
    Ruhezustandsintervall Intervall der Wartezeit in Sekunden, bevor eine weitere Abfrage ausgeführt wird, nachdem eine Abfrage keine Events zurückgegeben hat. 60
    Abfrageintervall Intervall in Sekunden, das gewartet werden soll, bevor neue Events abgerufen werden. 0
    Verwerfen, wenn Warteschlange voll ist Hiermit legen Sie fest, dass Protokolle verworfen werden, wenn der MID-Server ausgelastet ist. falsch