Benutzerdefinierte Logs aus OCI Streaming Service mit Service-Connector aufnehmen
Wenn Sie mit Oracle Log 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:
-
Geben Sie die Berechtigung zum Zugriff auf Logs und zum Erfassen von Logs aus dem OCI Streaming-Service an. Siehe Erfassung von Logs aus OCI Streaming Service zulassen.
-
Identifizieren oder erstellen Sie das Compartment und die Log Analytics-Loggruppe, in der die Logs erfasst werden müssen.
-
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
Log Analytics unterstützt Parser der Formate Regex, XML und JSON. Stellen Sie Folgendes sicher:
-
Die Logdaten in einem Stream müssen ein einzelnes Format, Regex, XML oder JSON aufweisen und nicht mehrere Formate haben.
-
Der für einen Stream identifizierte Parser muss dasselbe Format aufweisen wie die Logdaten in diesem Stream.
-
-
Erstellen Sie eine Logquelle, die Ihren benutzerdefinierten Logs am besten entspricht, 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 wählen. Siehe Von Oracle definierte Quellen.
-
Erstellen Sie einen neuen Service-Connector, um eine Verbindung zwischen OCI Streaming und Oracle Log Analytics herzustellen und Ihre benutzerdefinierten Logs weiterzuleiten. Geben Sie
Logging Analytics
als Ziel 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 Log Analytics.
Um das Erfassen Ihrer benutzerdefinierten Logs aus OCI Streaming zu stoppen, führen Sie die Schritte wie unter Sammeln von Logs aus Service-Connector stoppen beschrieben aus. Der in den Schritten referenzierte Service-Connector muss jedoch derjenige sein, den Sie mit OCI Streaming als Quelle und Oracle Log Analytics als Ziel für die Logs erstellt haben.
Erfassung von Logs aus OCI Streaming Service zulassen
Erstellen Sie Policys, damit die Benutzer die Logs aus OCI Streaming erfassen und in Oracle Log Analytics aufnehmen können.
Die folgenden Berechtigungen dienen zum Hochladen von Logs aus dem Service-Connector in Oracle Log 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 oben genannten Policy-Anweisungen
-
Log_Group_Compartment_OCID
: Die Compartment-OCID der Loggruppe in Oracle Log Analytics, in der die Logs gespeichert werden müssen. -
Log_Group_OCID
: Die OCID der Loggruppe in Oracle Log 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 oben genannten Policy-Anweisungen
-
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-Connector.