Oracle Cloud Infrastructure-Dokumentation

Oracle Log Analytics für große Aktivitätsstream-Payloads verwenden

Sie können Ihre Aktivitätsstreamlogs in Oracle Log Analytics veröffentlichen. Dies ist nützlich, wenn Ihre Aktivitätsstream-Payload groß ist, da das öffentliche Logging in Oracle Cloud Infrastructure (OCI) die Größe von Logdateien begrenzt.

Hinweis

Sie müssen Oracle Log Analytics abonniert haben, um Ihre Aktivitätsstreamlogs dort zu veröffentlichen.
Um die Oracle Integration-Aktivitätsstreamlogs in Oracle Log Analytics zu veröffentlichen, führen Sie die folgenden Aufgaben aus:
  1. Loggruppe zum Speichern Ihrer Logs in Oracle Log Analytics erstellen
  2. Policy zum Zulassen von Loguploads aus Oracle Integration erstellen
  3. Policy erstellen, mit der Benutzer Logs in Oracle Log Analytics anzeigen können
  4. Option zum Veröffentlichen von Logs in Oracle Log Analytics aktivieren

Wenn Sie später das Speichern von Aktivitätsstreamlogs in Oracle Log Analytics stoppen möchten, können Sie sie für Ihre Oracle Integration-Instanz deaktivieren. Siehe Speichern von Logs in Oracle Log Analytics deaktivieren

Loggruppe zum Speichern Ihrer Logs in Oracle Log Analytics erstellen

Um eine Loggruppe in Oracle Log Analytics zum Speichern der Oracle Integration-Aktivitätsstreamlogs zu erstellen, führen Sie die folgenden Schritte aus:

  1. Klicken Sie in der Oracle Cloud-Konsole auf das Navigationsmenü, und klicken Sie auf Observability & Management. Klicken Sie dann unter Log Analytics auf Administration.
  2. Klicken Sie auf der Seite Loggruppen im Menü auf der linken Seite auf Loggruppen.
  3. Stellen Sie neben Angewendete Filter sicher, dass Sie das Compartment anzeigen, in dem Sie die Loggruppe erstellen möchten.
  4. Klicken Sie auf Loggruppe erstellen.
  5. Geben Sie einen Namen (zum Beispiel OracleIntegration_ActivityStream_LogGroup) und eine Beschreibung ein.
  6. Klicken Sie auf Erstellen.

Policy zum Zulassen von Loguploads aus Oracle Integration erstellen

Um eine Policy zu erstellen, mit der Loguploads aus Oracle Integration zulässig sind, führen Sie die folgenden Schritte aus:

  1. Melden Sie sich bei der Oracle Cloud-Konsole an, falls dies noch nicht geschehen ist.
  2. Rufen Sie die Client-ID für Ihre Oracle Integration-Instanz ab:
    1. Klicken Sie im Navigationsmenü der Oracle Cloud-Konsole auf Identität & Sicherheit, und klicken Sie unter Identität auf Domains.
    2. Öffnen Sie die Domain, in der Sie die Oracle Integration-Instanz erstellt haben.

      Wenn die Domain nicht angezeigt wird, stellen Sie sicher, dass Sie sich in der richtigen Region (im Banner) befinden und das richtige Compartment (in den Filtern) anzeigen.

    3. Klicken Sie auf den Registerkarten oben auf Oracle-Cloud-Services.
    4. Öffnen Sie die Oracle Integration-Instanz.

      Wenn Sie Probleme haben, Ihre Instanz zu finden, kann die Suche nach "Integration" Ihre Auswahl einschränken.

    5. Klicken Sie in den Registerkarten oben auf OAuth-Konfiguration.
    6. Scrollen Sie nach unten zum Abschnitt Allgemeine Informationen, und kopieren Sie die Client-ID.
  3. Erstellen Sie eine dynamische Gruppe zur Verwendung in der Policy:
    1. Gehen Sie zurück zu Ihrer Domain, indem Sie oben auf der Seite auf Oracle-Cloud-Services klicken.
    2. Klicken Sie in den Registerkarten oben auf Dynamische Gruppen.
    3. Klicken Sie auf Dynamische Gruppen erstellen.
    4. Geben Sie einen Namen (z.B. OracleIntegration_LogAnalytics_DynamicGroup) und eine Beschreibung für die Gruppe an.
    5. Geben Sie im Feld Regel 1 die folgende Regel ein.
      Syntax:
      • resource.id='OracleIntegration_ClientID'
      Wobei :
      • OracleIntegration_ClientID ist die Client-ID, die Sie in Schritt 2 kopiert haben
      Beispiel:
      • resource.id='A01BC23DE4567FGH89I0123456J78901_APPID'
  4. Erstellen Sie die Policy:
    1. Klicken Sie im linken Navigationsbereich auf Policys.
    2. Klicken Sie auf Policy erstellen.
    3. Geben Sie einen Namen (z.B. OracleIntegration_LogUploadPolicy) und die Beschreibung für die Policy an.
    4. Klicken Sie auf Manuellen Editor anzeigen.
    5. Geben Sie die folgenden Berechtigungen ein.
      Syntax:
      • allow dynamic-group DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment LogGroup_Compartment
      • allow dynamic-group DynamicGroup to {LOG_ANALYTICS_SOURCE_READ} in tenancy
      • allow dynamic-group DynamicGroup to use loganalytics-ondemand-upload in tenancy
      • allow dynamic-group DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in tenancy
      Wobei :
      Beispiel:
      • allow dynamic-group OracleIntegration_LogAnalytics_DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment OracleIntegration_LogGroup_Compartment
      • allow dynamic-group OracleIntegration_LogAnalytics_DynamicGroup to {LOG_ANALYTICS_SOURCE_READ} in tenancy
      • allow dynamic-group OracleIntegration_LogAnalytics_DynamicGroup to use loganalytics-ondemand-upload in tenancy
      • allow dynamic-group OracleIntegration_LogAnalytics_DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in tenancy

Policy erstellen, mit der Benutzer Logs in Oracle Log Analytics anzeigen können

Um eine Policy zu erstellen, mit der Benutzer Logs in Oracle Log Analytics anzeigen können, führen Sie die folgenden Schritte aus:

  1. Erstellen Sie eine Gruppe für die Benutzer, für die Sie die Aktivitätsstreamlogs in Oracle Log Analytics anzeigen möchten:
    1. Klicken Sie im linken Navigationsbereich auf Domains.
    2. Öffnen Sie die Domain, in der Sie die Oracle Integration-Instanz erstellt haben.

      Wenn die Domain nicht angezeigt wird, stellen Sie sicher, dass Sie sich in der richtigen Region (im Banner) befinden und das richtige Compartment (in den Filtern) anzeigen.

    3. Klicken Sie in den Registerkarten oben auf Benutzerverwaltung.
    4. Scrollen Sie nach unten zum Abschnitt Gruppen, und klicken Sie auf Gruppe erstellen.
    5. Geben Sie einen Namen (z.B. OracleIntegration_LogAnalytics_Group) und eine Beschreibung für die Gruppe an.
    6. Benutzer zu der Gruppe hinzufügen.
    7. Klicken Sie auf Erstellen.
  2. Erstellen Sie die folgende Policy:
    1. Klicken Sie im linken Navigationsbereich auf Policys.
    2. Klicken Sie auf Policy erstellen.
    3. Geben Sie einen Namen (z.B. OracleIntegration_LogAnalyticsAccessPolicy) und eine Beschreibung für die Policy an.
    4. Klicken Sie auf Manuellen Editor anzeigen.
    5. Geben Sie im Editor die folgenden Berechtigungen ein.
      Syntax:
      • allow group UserGroup to use loganalytics-features-family in tenancy
      • allow group UserGroup to use loganalytics-resources-family in tenancy
      Wobei :
      • UserGroup ist die in Schritt 1 erstellte Gruppe.
      Beispiel:
      • allow group OracleIntegration_LogAnalytics_Group to use loganalytics-features-family in tenancy
      • allow group OracleIntegration_LogAnalytics_Group to use loganalytics-resources-family in tenancy

Option zum Veröffentlichen von Logs in Oracle Log Analytics aktivieren

Um das Speichern von Oracle Integration-Aktivitätsstreamlogs in Oracle Log Analytics zu aktivieren, führen Sie die folgenden Schritte aus:

  1. Rufen Sie die OCID für die von Ihnen erstellte Loggruppe ab:
    1. Klicken Sie im Navigationsmenü der Oracle Cloud-Konsole auf Observability and management, und klicken Sie unter Loganalysen auf Administration.
    2. Klicken Sie im linken Navigationsbereich auf Loggruppen.
    3. Klicken Sie neben der Loggruppe, die Sie für Oracle Integration erstellt haben, auf Symbol "Aktionen" und dann auf OCID kopieren.

      Wenn das Log nicht angezeigt wird, stellen Sie sicher, dass Sie das richtige Compartment (im linken Menü) anzeigen.

  2. Aktivieren Sie die Option:
    1. Klicken Sie im Navigationsmenü der Oracle Cloud-Konsole auf Entwicklerservices, und klicken Sie unter Anwendungsintegration auf Integration.
    2. Öffnen Sie die Oracle Integration-Instanz.

      Wenn die gesuchte Instanz nicht angezeigt wird, stellen Sie sicher, dass Sie die richtige Region (im Banner) und das richtige Compartment (oben in der Instanzliste neben Angewendete Filter) anzeigen.

    3. Klicken Sie unter Einstellungen neben Aktivitätsstreamlogs in OCI Log Analytics speichern auf Aktivieren.
    4. Fügen Sie die kopierte OCID in das Feld OCI Log Analytics-Loggruppe ein, und klicken Sie auf Speichern.

      Der Serviceinstanzstatus wird in Wird aktualisiert geändert. Wenn der Status abgeschlossen ist, ändert sich der Status in Aktiv. Unter Links wird ein neuer Eintrag für die OCI Log Analytics-Loggruppe angezeigt, in dem die Loggruppen-OCID angezeigt wird.

Speichern von Logs in Oracle Log Analytics deaktivieren

Wenn Sie das Speichern von Aktivitätsstreamlogs in Oracle Log Analytics stoppen möchten, können Sie sie für Ihre Oracle Integration-Instanz deaktivieren.

  1. Klicken Sie im Navigationsmenü der Oracle Cloud-Konsole auf Entwicklerservices, und klicken Sie unter Anwendungsintegration auf Integration.
  2. Öffnen Sie die Oracle Integration-Instanz.

    Wenn die Instanz nicht angezeigt wird, stellen Sie sicher, dass Sie das richtige Compartment (im linken Menü) anzeigen.

  3. Klicken Sie unter Einstellungen neben Aktivitätsstreamlogs in OCI Log Analytics speichern auf Deaktivieren.

    Sie werden aufgefordert, Ihre Aktion zu bestätigen.

    Der Serviceinstanzstatus wird in Wird aktualisiert geändert. Wenn der Status abgeschlossen ist, ändert sich der Status in Aktiv, und unter Aktivitätsstreamlogs in OCI Log Analytics speichern wird Nicht aktiviert angezeigt.