Amazon S3 Dateneingabe-Konfigurationsfelder

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer
  • Beschreibung der Felder im Konfigurationsformular der Dateneingabe Amazon S3.

    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 bestimmter MID Server oder ein MID Server-Cluster verwendet werden soll.

    Diese Funktion wird unterstützt in Anwendung Health Log Analytics, Version 26.0.17 - Februar 2023 und höher, verfügbar im ServiceNow Store.

    MID

    (Nur wenn das Feld Ausführen auf auf Spezifischer MID Server festgelegt 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 Spezifischer MID-Server-Cluster festgelegt ist)

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

    Die Dateneingabe wird auf einem einzelnen MID Server im Cluster ausgeführt, bis dieser MID Server ausfällt. Das System verschiebt dann alle Dateneingabeaufgaben gemäß der konfigurierten Reihenfolge auf den nächsten verfügbaren MID Server im Cluster.

    Diese Funktion wird unterstützt in Anwendung Health Log Analytics, Version 26.0.17 - Februar 2023 und höher, verfügbar im ServiceNow Store.

    Hinweis:
    • Health Log Analytics unterstützt nur Failover-MID Server-Cluster. In diesen Clustern werden mehrere MID Server zum Failover-Schutz zusammengefasst. Wenn Sie ein Cluster aus dem Dateneingabeformular auswählen, werden in der Liste der MID Server-Cluster nur Failover-Cluster angezeigt.
    • Der MID Server-Cluster darf nur MID Server enthalten, die die Basic Authentication unterstützen. mTLS wird für die Protokollerfassung nicht unterstützt.
    • Die Protokollerfassung muss für jeden MID Server im Cluster aktiviert sein. Wenn die Protokollerfassung für den aktiven MID Server nicht 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 er mindestens einen MID Server mit weniger als 10 Dateneingaben enthält, auch wenn dieser MID Server ausgefallen ist.
    Weitere Informationen zu MID Server-Clustern finden Sie unter MID Server-Cluster konfigurieren.

    Dies ist ein Pflichtfeld.

    Anwendungsservice Der Anwendungsservice, an den die Protokolldaten gebunden werden sollen.
    Hinweis:
    Wenn kein relevanter Anwendungsservice vorhanden ist, Erstellen Sie einen Anwendungsservice und CIs hinzufügen. Legen Sie den Status des neuen Anwendungsservice 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. Er 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