Oracle Cloud Infrastructure-Dokumentation

Benutzerdefinierte Logs aus OCI Streaming Service mit Service-Connector aufnehmen

Wenn Sie mit Oracle Logging Analytics Erkenntnisse aus Ihren benutzerdefinierten Streamingdaten mit hohem Volumen im OCI Streaming-Service analysieren und daraus ableiten möchten, führen Sie die folgenden Schritte aus, um die Streaminglogs aufzunehmen.

Schritte zum Erfassen benutzerdefinierter Logs aus OCI Streaming mit Service-Connector:

  1. Ermöglichen Sie den Zugriff auf und die Erfassung von Logs vom OCI Streaming-Service. Siehe Erfassung von Logs aus OCI Streaming Service zulassen.

  2. Identifizieren oder erstellen Sie das Compartment und die Logging Analytics-Loggruppe, in dem die Logs erfasst werden müssen.

  3. Erstellen Sie einen Parser, um Ihre benutzerdefinierten Logs zu parsen. Verwenden Sie den Beispielloginhalt aus Ihren Streamingdaten, um die Felder zu identifizieren. Siehe Parser erstellen.

    Hinweis

    Logging Analytics unterstützt Parser der Formate Regex, XML und JSON. Stellen Sie Folgendes sicher:

    • Die Logdaten in einem Stream müssen ein einzelnes Format aufweisen, Regex, XML oder JSON und dürfen nicht mehrere Formate aufweisen.

    • Der für einen Stream identifizierte Parser muss das gleiche Format aufweisen wie die Logdaten in diesem Stream.

  4. Erstellen Sie eine Logquelle, die am besten zu Ihren benutzerdefinierten Logs passt, und nehmen Sie den Parser auf, den Sie im vorherigen Schritt erstellt haben. Siehe Quelle erstellen.

    Alternativ können Sie aus den verfügbaren von Oracle definierten Logquellen auswählen. Siehe Von Oracle definierte Quellen.

  5. Erstellen Sie einen neuen Service-Connector, um eine Verbindung zwischen OCI Streaming und Oracle Logging Analytics herzustellen und Ihre benutzerdefinierten Logs weiterzuleiten. Geben Sie das Ziel als Logging Analytics an, und fügen Sie eine neue Quelle hinzu, die Ihren benutzerdefinierten Streaminglogs entspricht.

    Ausführliche Schritte zum Erstellen des Service-Connectors mit der Konsole, API oder CLI finden Sie in der Dokumentation zu OCI Service Connector Hub.

Nachdem die Verbindung mit OCI Streaming hergestellt wurde, fließen die benutzerdefinierten Logs in Oracle Logging Analytics.

Erfassung von Logs aus OCI Streaming Service zulassen

Erstellen Sie Policys, damit die Benutzer die Logs aus OCI Streaming erfassen und in Oracle Logging Analytics aufnehmen können.

Die folgenden Berechtigungen dienen zum Hochladen von Logs aus dem Service-Connector in Oracle Logging Analytics. Sie werden aufgefordert, diese Policy-Anweisungen hinzuzufügen, wenn Sie den Service-Connector über die OCI-Konsole erstellen. Alternativ können Sie die Policy, die folgende Policy-Anweisungen enthält, manuell erstellen: 

allow any-user to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment id <Log_Group_Compartment_OCID> where all {request.principal.type = 'serviceconnector', target.loganalytics-log-group.id = '<Log_Group_OCID>', request.principal.compartment.id = '<Service_Connector_Compartment_OCID>'}
allow group <userGroup> to MANAGE serviceconnectors in tenancy

In den obigen Policy-Anweisungen gilt Folgendes:

  • Log_Group_Compartment_OCID: Die Compartment-OCID der Loggruppe in Oracle Logging Analytics, in dem die Logs gespeichert werden müssen.

  • Log_Group_OCID: Die OCID der Loggruppe in Oracle Logging Analytics, in der die Logs gespeichert werden müssen.

  • Service_Connector_Compartment_OCID: Die Compartment-OCID des Service-Connector-Hubs.

Die folgenden Berechtigungen dienen zum Erfassen von Logs aus dem OCI Streaming-Service. Sie werden aufgefordert, diese Policy-Anweisungen hinzuzufügen, wenn Sie den Service-Connector über die OCI-Konsole erstellen. Alternativ können Sie die Policy, die folgende Policy-Anweisungen enthält, manuell erstellen:

allow any-user to {STREAM_READ, STREAM_CONSUME} in compartment id <Source_Stream_Compartment_OCID> where all {request.principal.type='serviceconnector', target.stream.id='<Stream_OCID>', request.principal.compartment.id='<Service_Connector_Compartment_OCID>'}

In den obigen Policy-Anweisungen gilt Folgendes:

  • Source_Stream_Compartment_OCID: Die Compartment-OCID der Streamdaten in OCI Streaming.

  • Stream_OCID: Die OCID des Streams in OCI Streaming.

  • Service_Connector_Compartment_OCID: Die Compartment-OCID des Service-Connectors.