Oracle Cloud Infrastructure-Dokumentation

Agent-Konfiguration erstellen

Erstellen Sie eine Agent-Konfiguration in Logging, um Ereignisse aus Ihren Anwendungen in einem benutzerdefinierten Log aufzunehmen.

Um eine Agent-Konfiguration zu erstellen, müssen Sie zuerst den Oracle Fluentd-basierten Agent installieren. Weitere Informationen finden Sie unter Agent installieren.

    1. Öffnen Sie das Navigationsmenü , und wählen Sie Observability and Management aus. Wählen Sie unter Logging die Option Agent-Konfigurationen aus.
    2. Wählen Sie unter Listengeltungsbereich ein Compartment aus, für das Sie berechtigt sind.
    3. Wählen Sie Agent-Konfiguration erstellen aus.
    4. Geben Sie im Fensterbereich Agent-Konfiguration erstellen einen Namen und eine Beschreibung für die Konfiguration ein. Geben Sie dabei keine vertraulichen Informationen ein.
    5. Wählen Sie das Compartment aus, in dem Sie die Konfiguration erstellen möchten.
    6. Wählen Sie unter Hostgruppen, in denen Sie definieren, welche VMs für diese Konfiguration gelten, eine der folgenden Optionen aus der Liste Gruppentyp aus:
      • Dynamische Gruppe: Dynamische Gruppe bezieht sich auf eine Gruppe von Instanzen, die Sie im IAM-Feature der Konsole erstellen können. Weitere Informationen finden Sie unter Informationen zu dynamischen Gruppen. Wählen Sie eine dynamische Gruppe aus der Liste Gruppe.
      • Benutzergruppe: Die Benutzergruppe verweist auf das IAM-Feature Gruppen der Konsole. Weitere Informationen finden Sie unter Gruppen verwalten. Wählen Sie eine Benutzergruppe aus der Liste Gruppe.
    7. Um weitere Gruppen hinzuzufügen, wählen Sie + Weitere Hostgruppe.

      Sie können eine Kombination von Gruppentypen für die Agent-Konfiguration hinzufügen.

      Hinweis

      Es sind maximal fünf Gruppen pro Konfiguration zulässig, und ein Host kann maximal fünf verschiedenen Gruppen angehören.
    8. Definieren Sie unter Agent-Konfiguration unter Log-Eingaben konfigurieren das Format der Logs (auf welche Logs Sie achten möchten). Wählen Sie eine der Optionen aus der Liste Eingabetyp:
      • Geben Sie für Windows-Ereignislog einen Namen ein, und wählen Sie mindestens einen Ereigniskanal aus.
      • Geben Sie unter Logpfad einen Eingabenamen und einen oder mehrere Dateipfade ein. Beispiel: /<log_path>/<log_name>.

      Sie können mehrere Protokolldateipfade angeben, die durch ein Komma (,) getrennt sind. Weitere Informationen finden Sie unter https://docs.fluentd.org/input/tail#path.

      <source>
@type tail
tag 757261.oc_oslogs_linux
path /var/log/.log,/var/log/.out,/var/log/dmesg,var/log/grubby,/var/log/messages*,
 var/log/secure,/var/log/auth,/var/log/acpid,/root/.bash_history
pos_file /etc/unifiedmonitoringagent/pos/757261-oc_oslogs_linux.pos
path_key tailed_path
</source>
      Konfiguration wie folgt:
      {{path C:\Program Files (x86)\<application>\<directory>*, 
 C:\Program Files (x86)\<application>\<application_logs_directory>\<directory>* }}
    9. Wählen Sie Erweiterte Parseroptionen aus, und wählen Sie im Bereich Erweiterte Parseroptionen einen Parser aus, um anzugeben, wie das Log geparst werden soll. Einige Parser benötigen weitere Eingaben und verfügen je nach ausgewähltem Typ über weitere Optionen.
      Beispiel: Für JSON müssen Sie einen Wert für Zeittyp in der Liste auswählen, während Sie optional Ereigniszeit- und Nullfeldeinstellungen angeben können. Für REGEXP können Sie den regulären Ausdruck für übereinstimmende Logs zusammen mit dem Zeitformat angeben. Weitere Informationen finden Sie unter Log-Eingaben und -Parser.
      Wichtig

      Der NONE-Parsertyp ist erforderlich, auch wenn Sie keinen bestimmten Parsertyp angeben möchten.
    10. Unter Logziel auswählen muss die Benutzergruppe oder dynamische Gruppe in der Konfiguration, die Sie unter Compartment auswählen, berechtigt sein, im Compartment zu arbeiten.

      Wählen Sie die Loggruppe und den Lognamen in den entsprechenden Listen aus.

      Der Logname kann nur auf ein benutzerdefiniertes Log verweisen, und das benutzerdefinierte Log muss in der ausgewählten Loggruppe vorhanden sein, damit die Konfiguration funktioniert.

    11. (Optional) Wählen Sie Weitere Optionen anzeigen. Wählen Sie unter Betriebsmetriken für Logging Agent die Option Aktivieren aus, um potenzielle Probleme mit dem Agent zu überwachen und zu identifizieren.
      Wählen Sie unter Ziel ausgeben das Compartment aus, und geben Sie einen Namespace an. Geben Sie optional die Ressourcengruppe aus den entsprechenden Feldern an.
      Hinweis

      Obwohl die Ressourcengruppe optional ist, wird sie standardmäßig auf "defaultGroup" gesetzt, wenn keine Auswahl erfolgt.
      Wählen Sie unter Betriebsmetriken die Betriebsmetriken aus, die Sie für die Agent-Konfiguration aktivieren möchten.
      • Taktüberwachung: Unified Monitoring Agent-Status. Der Wert 1 gibt an, dass der Agent verfügbar ist, und 0 bedeutet, dass der Agent nicht antwortet. Diese Metrik ist immer aktiviert und kann nicht deaktiviert werden.

        Dimensionen: Die Unified Monitoring Agent-Version, das Betriebssystem, die Architektur, die Region, die AD und die Instanz-ID der Instanz.

      • RestartMetric: Im Gegensatz zur Metrik Heartbeat, die regelmäßig ist, wird RestartMetric während der Gültigkeitsdauer des Agent nur einmal gesendet, d.h. wenn der Agent neu gestartet wird. Überwachungsneustarts sind für das Verständnis der Agent-Stabilität unerlässlich. Häufige Neustarts können auf Systemfehler hinweisen. Wenn Sie unerwartete Neustarts bemerken, können Operatoren Konfigurationsprobleme oder Ressourceneinschränkungen beheben.

        Dimensionen: Instanz-ID.

      • EmitRecords: Die Gesamtanzahl der ausgegebenen Logdatensätze. Ein Datensatz entspricht den Logzeilen, die an das Backend gesendet werden. Diese Metrik bietet einen Einblick in die Zunahme und Verringerung der Anzahl der aufgenommenen Logzeilen und des Volumens der verarbeiteten Logs. Ein plötzlicher Rückgang oder eine Erhöhung dieser Anzahl kann Probleme in der Protokollierungspipeline signalisieren. Beispiel: Einige Logzeilen können abgelehnt und bei der Logaufnahme nicht berücksichtigt werden.

        Dimensionen: Instanz-ID und Tag.

      • BufferSpaceAvailable: Der verfügbare Pufferspeicher in Prozent. Der Wert beginnt bei 100 und nimmt ab, wenn der Pufferbetrag verwendet wird. Der Agent verwendet Puffer, um Bursts eingehender Daten und potenziellen Backdruck aus Ausgaben zu verarbeiten. Durch die Überwachung dieser Metrik wird sichergestellt, dass Ihnen nicht der Pufferspeicherplatz ausgeht. Dies kann zu Datenverlust oder -rückdruck führen. Wenn der Pufferspeicher konstant niedrig ist, müssen Sie möglicherweise die Agent-Konfiguration optimieren und weitere Ressourcen zuweisen.

        Dimensionen: Instanz-ID und Tag.

      • ShowFlushCount: Die Gesamtanzahl langsamer Löschvorgänge. Flushing bezieht sich auf den Vorgang, bei dem gepufferte Daten an das gewünschte Ziel gesendet werden. Ein langsamer Flush bedeutet, dass das Spülen von Daten aus dem Puffer zu seinem Ziel länger dauert als der festgelegte Schwellenwert. Diese Zahl wird inkrementiert, wenn die Pufferleerung länger als 20 Sekunden dauert. Durch die Überwachung langsamer Flush-Vorgänge können Performanceprobleme identifiziert werden. Wenn Flushes konstant langsam sind, kann sich der Puffer schneller füllen, als Daten gelöscht werden können, was zu Datenverlusten oder Gegendruckproblemen führt.

        Dimensionen: Instanz-ID und Tag.

      • RollbackCount: Gibt an, wie oft der Agent eine Transaktion insgesamt zurückrollt, weil er den Puffer nicht erfolgreich in das Ausgabeziel wegschreiben konnte. Rollbacks treten in der Regel auf, wenn ein Schreibvorgang oder try_write nicht erfolgreich verläuft oder Probleme mit dem OCI Logging-Service, Netzwerkproblemen oder Konfigurationsproblemen vorhanden sind. Hohe Rollback-Anzahl ist ein eindeutiger Indikator für Zuverlässigkeitsprobleme in der Logging-Pipeline, die untersucht werden müssen.

        Dimensionen: Instanz-ID und Tag.

      • RetryCount: Verfolgt, wie oft der Agent versucht, einen Datensendevorgang nach einem Fehler erneut auszuführen. Wiederholungen weisen auf vorübergehende Probleme bei der Bereitstellung von Daten hin. Hohe Wiederholungszahlen können auf Netzwerkinstabilität hinweisen. Während Rollbacks größere Transaktionsprobleme bewältigen können, weisen Wiederholungen oft auf kleinere, möglicherweise häufigere Unterbrechungen hin.

        Dimensionen: Instanz-ID und Tag.

      Nachdem die Agent-Konfiguration erstellt wurde, können Sie anzeigen, welche Betriebsmetriken beim Abrufen der Details einer Agent-Konfiguration aktiviert sind.

    12. (Optional) Fügen Sie der Agent-Konfiguration mindestens ein Tag hinzu: Wählen Sie Zusätzliche Optionen anzeigen aus, um den Abschnitt Tags hinzufügen anzuzeigen.
      Wenn Sie über Berechtigungen zum Erstellen einer Ressource verfügen, sind Sie auch berechtigt, Freiform-Tags auf diese Ressource anzuwenden. Um ein definiertes Tag anzuwenden, benötigen Sie die Berechtigungen zur Verwendung des Tag-Namespace. Weitere Informationen zum Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Sie Tags anwenden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
    13. (Optional) Wählen Sie Als Stack speichern aus, um die Ressourcenkonfiguration als Stack zu speichern.
      Weitere Informationen finden Sie unter Stack aus der Seite "Ressourcen erstellen" erstellen.
    14. Klicken Sie auf Erstellen.
    Die Agent-Konfiguration wird erstellt und auf der Seite Agent-Konfigurationen angezeigt.

  • Verwenden Sie den Befehl oci logging agent-configuration create und die erforderlichen Parameter, um eine Agent-Konfiguration für das Logging zu erstellen:

    oci logging agent-configuration create compartment-id compartment_ocid --is-enabled [true|false] --service-configuration service_configuration [OPTIONS]

    Eine vollständige Liste der Parameter und Werte für CLI-Befehle ist in der CLI-Befehlsreferenz enthalten.

  • Führen Sie den Vorgang CreateUnifiedAgentConfiguration aus, um eine Agent-Konfiguration für das Logging zu erstellen.