Logs von anderen OCI-Services mit Service-Connector aufnehmen

Basierend auf dem Typ der Servicelogs, die Sie aufnehmen möchten, müssen Sie Policys erstellen, damit Oracle Log Analytics die Informationen zu den Ressourcen abrufen und für jede Ressource eine Entity erstellen kann.

Nachdem Sie die Policy erstellt haben, wird die erstellte Entity automatisch mit allen Logs verknüpft, die aus dieser Ressource erfasst werden. Wenn die Policy nicht erstellt wird, werden die Logs weiterhin aufgenommen, die Entity wird jedoch nicht erstellt.

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
allow group <userGroup> to READ logging-family 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.

Oracle Log Analytics erstellt eine Entity, die die zugrunde liegende OCI-Ressource darstellt, wenn neue Logs über den Service-Connector empfangen werden. Um die erforderlichen Informationen von der OCI-Ressource zu erhalten, müssen Sie Oracle Log Analytics mindestens read Zugriff auf die OCI-Ressource erteilen. Beispiel: Um Informationen zu einem Bucket in Object Storage zu lesen, können Sie eine der folgenden Policys schreiben:

Policy-Anweisung mit der READ PRIVILEGE der OCI-Ressource:

allow resource loganalyticsvrp LogAnalyticsVirtualResource to {BUCKET_READ} in compartment <specify_compartment>

Oder

Policy-Anweisung mit dem Leseverb für OCI RESOURCE:

allow resource loganalyticsvrp LogAnalyticsVirtualResource to read buckets in compartment <specify_compartment>

Die oben genannten Policy-Anweisungen schränken den read-Zugriff auf ein Compartment ein. Um den Zugriff auf den gesamten Mandanten zu erweitern, können Sie die Policy-Anweisung entsprechend ändern.

Die folgenden OCI-Ressourcen werden in Oracle Log Analytics für die Logerfassung über den Service-Connector unterstützt. Sie können die Policy entweder mit dem Leseverb für die OCI-Ressource erstellen oder die Leseberechtigung für die Ressource wie oben dargestellt verwenden.

Bevor Sie den Service-Connector so einrichten, dass er Logs aufnimmt, stellen Sie sicher, dass das Compartment und die Loggruppe für die Logs identifiziert werden, die Sie aufnehmen möchten.

Im folgenden Beispiel zeigen die Schritte, wie Sie VCN-Servicelogs aus dem Oracle Cloud Infrastructure Logging-Service erfassen:

1. In diesem Schritt wird beschrieben, wie Sie Logs im Oracle Cloud Infrastructure Logging-Service aktivieren.

   Gehen Sie zu Oracle Cloud Infrastructure Logging-Service, und gehen Sie zu Logs.

   Klicken Sie auf Ressourcenlog aktivieren, um VCN-Servicelogs zu aktivieren. Das Dialogfeld wird geöffnet.

   1. Wählen Sie das Ressourcen-Compartment aus.
   2. Wählen Sie den Service aus. Beispiel: Virtuelles Cloud-Netzwerk (Subnetze).
   3. Wählen Sie die Ressource aus, z.B. die VCN-Ressource.
   4. Wählen Sie unter Log konfigurieren die Logkategorie, z.B. Flowlogs, und den Lognamen aus.
   5. Wählen Sie unter Logspeicherort das Compartment und eine Loggruppe aus, von denen Oracle Log Analytics die Logs referenziert.

   Klicken Sie auf Log aktivieren.

2. Legen Sie den Service-Connector fest, indem Sie den Quellservice der Logs und das Ziel als Oracle Log Analytics angeben. Sie können ihn entweder über den Quellservice einrichten, der in Oracle Cloud Infrastructure Service Connector Hub integriert ist, z.B. Oracle Cloud Infrastructure Logging-Service, oder direkt über Oracle Cloud Infrastructure Service Connector Hub.

   Gehen Sie zu Oracle Cloud Infrastructure Logging-Service, gehen Sie zu Service-Connectors, und klicken Sie auf Connector erstellen.

   Alternativ können Sie zum Oracle Cloud Infrastructure Service Connector Hub-Service gehen und auf Service Connector erstellen klicken.

   Die Seite "Service-Connector erstellen" wird geöffnet.

   1. Geben Sie einen Namen für den Connector und eine Beschreibung ein.
   2. Wählen Sie das Ressourcen-Compartment aus, in dem die Connector-Ressource erstellt werden soll.
   3. Geben Sie unter Service-Connector konfigurieren Logging als Quellservice und Logging Analytics als Zielservice an.
   4. Geben Sie unter Quellverbindung konfigurieren die Details der Logs an, die aus dem Service erfasst werden sollen, z.B. die VCN-Servicelogs.

      Wählen Sie den Compartment-Namen, die Loggruppe, zu der die Logs gehören, und den Namen der Logs aus, die Sie in Schritt 1 konfiguriert haben.

   Sie können denselben Service-Connector für die Erfassung mehrerer Logs konfigurieren. Klicken Sie auf Weiteres Log, und wiederholen Sie Schritt 2-d.

   Optional können Sie Filter unter Aufgabe konfigurieren erstellen.

   Klicken Sie auf Connector erstellen.

Nachdem der Service-Connector erstellt wurde, können Sie prüfen, ob die ausgewählten Logs in Oracle Log Analytics verfügbar sind.

Source_Tenant ist der Mandant des Quellservice, wie Oracle Cloud Infrastructure Logging, aus dem Logs erfasst werden. Target_Tenant ist der Mandant, in dem der Service-Connector erstellt wird. Der Service-Connector ist mit Oracle Log Analytics als Ziel für die Logs konfiguriert, die aus dem Quellservice erfasst werden. Es wird davon ausgegangen, dass der Service-Connector-Hub und Oracle Log Analytics in demselben Zielmandanten verfügbar sind.

Richten Sie die folgenden Policys ein, um die Logerfassung aus einem Mandanten zu konfigurieren, der sich von dem Mandanten unterscheidet, in dem der Service-Connector erstellt wird.

define tenancy <Target_Tenant> as <Target_Tenant_OCID>
define group <Common_User_Group> as <Common_User_Group_OCID>
admit any-user of tenancy <Target_Tenant> to read logging-family IN TENANCY WHERE ALL {request.principal.type = 'serviceconnector'}
admit group <Common_User_Group> of tenancy <Target_Tenant> to read logging-family IN TENANCY

admit group <Common_User_Group> of tenancy <Target_Tenant> to read audit-events in TENANCY
admit any-user of tenancy <Target_Tenant> to read audit-events IN tenancy WHERE ALL {request.principal.type = 'serviceconnector'}

define tenancy <Source_Tenant> as <Source_Tenant_OCID>
endorse any-user to read logging-family IN tenancy <Source_Tenant> WHERE ALL {request.principal.type = 'serviceconnector'}
endorse group <Common_User_Group> to read logging-family IN tenancy <Source_Tenant>

endorse group <Common_User_Group> to read audit-events in tenancy <Source_Tenant>
endorse any-user to read audit-events in tenancy <Source_Tenant> WHERE ALL {request.principal.type = 'serviceconnector'}

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 <Common_User_Group> to MANAGE serviceconnectors in tenancy

oci --profile <Target_Profile> sch service-connector create 
    --display-name XTenancyConnector 
    --compartment-id <Connector_Compartment_OCID> 
    --source '{ "kind": "logging", "logSources": 
        [ { "compartmentId": "<Logging_LogGroup_Compartment_OCID>", 
            "logGroupId": "<Logging_LogGroup_OCID>" } ] }' 
    --target '{ "kind": "loggingAnalytics", "logGroupId": "<LogAnalytics_LogGroup_OCID>" }'

Wenn Sie einen Service-Connector für die kontinuierliche Erfassung von Logs aus OCI Logging in Oracle Log Analytics eingerichtet haben, können Sie die Logerfassung stoppen, indem Sie den Connector deaktivieren oder löschen.

Wenn Sie die Logerfassung vorübergehend stoppen, aber die Connector-Konfiguration beibehalten möchten, sodass Sie die Logerfassung zu einem späteren Zeitpunkt neu starten können, deaktivieren Sie den Connector.

Wenn Sie die Logerfassung aus dem Service-Connector dauerhaft stoppen möchten, löschen Sie den Connector.

1. Service-Connector identifizieren, der für die Logerfassung eingerichtet ist: Navigieren Sie zum Connector Hub-Service, und listen Sie die Connectors in Ihrem Compartment auf. Siehe Connectors auflisten.

   Klicken Sie auf den Namen des Connectors, um die Connector-Details und -Konfiguration anzuzeigen. Identifizieren Sie den richtigen Service-Connector, der für Ihre Logerfassung eingerichtet ist.

2. Logerfassung stoppen: Klicken Sie je nach Anforderung auf Deaktivieren oder Löschen. Siehe Connector deaktivieren und Connector löschen.

   Dadurch wird der Datenfluss vom spezifischen OCI-Service zu Oracle Log Analytics gestoppt.

Wenn Sie den Connector deaktiviert haben und die Logerfassung neu starten möchten, aktivieren Sie diesen Connector erneut. Siehe Connector aktivieren.