Logs nach Bedarf hochladen

Themen:

• Erstellen, Abrufen und Auflisten von On-Demand-Uploads durch Benutzer zulassen
• Löschen von On-Demand-Upload durch Benutzer zulassen

allow group <group_name> to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment <log_group_compartment>
allow group <group_name> to {LOG_ANALYTICS_ENTITY_UPLOAD_LOGS} in compartment <entity_compartment>
allow group <group_name> to {LOG_ANALYTICS_SOURCE_READ} in tenancy
allow group <group_name> to use loganalytics-ondemand-upload in tenancy

allow group <group_name> to use loganalytics-ondemand-upload in tenancy
allow group <group_name> to use loganalytics-log-group in compartment <log_group_compartment>
allow group <group_name> to read loganalytics-source in tenancy
allow group <group_name> to {LOG_ANALYTICS_ENTITY_UPLOAD_LOGS} in compartment <entity_compartment>

allow group <group_name> to use loganalytics-features-family in tenancy
allow group <group_name> to use loganalytics-resources-family in tenancy/compartment

allow group <group_name> to use loganalytics-ondemand-upload in tenancy
allow group <group_name> to {LOG_ANALYTICS_LOG_GROUP_DELETE_LOGS} in compartment <log_group_compartment>
allow group <group_name> to {LOG_ANALYTICS_QUERY_VIEW} in tenancy
allow group <group_name> to {COMPARTMENT_QUERY} in tenancy

allow group <group_name> to use loganalytics-ondemand-upload in tenancy
allow group <group_name> to manage loganalytics-log-group in compartment <log_group_compartment>
allow group <group_name> to read loganalytics-query in tenancy
allow group <group_name> to read compartments in tenancy

allow group <group_name> to use loganalytics-features-family in tenancy
allow group <group_name> to manage loganalytics-resources-family in tenancy/compartment
allow group <group_name> to read compartments in tenancy

group_name in allen oben genannten Policy-Anweisungen bezieht sich auf die Benutzergruppe, der die erforderlichen Berechtigungen erteilt werden müssen.

Sie können Logdateien mit dem On-Demand-Upload-(ODU-)Assistenten Hochladen, der in der Servicekonsole von Oracle Log Analytics verfügbar ist.

1. Greifen Sie über Oracle Log Analytics auf die Seite Uploads zu:

   Öffnen Sie das Navigationsmenü, und klicken Sie auf Observability and Management. Klicken Sie unter Log Analytics auf Administration. Die Seite Administration - Überblick wird geöffnet.

   Die Administrationsressourcen werden im linken Navigationsbereich unter Ressourcen aufgeführt. Klicken Sie auf Uploads.

2. Klicken Sie auf der Seite Uploads auf Dateien hochladen.
   Die Seite "Dateien hochladen" wird geöffnet.
3. Dateien auswählen:
   • Geben Sie den Uploadnamen ein. Mit diesem Namen können Sie den Status der hochgeladenen Logdateien verfolgen. Sie können mehrere Uploads zu unterschiedlichen Zeiten mit demselben Uploadnamen ausführen, wenn Sie ein Set von Uploads zusammen verwalten möchten.
   • Wählen Sie das Compartment der Loggruppe aus, um den Geltungsbereich der Loggruppe zu definieren.
   • Wählen Sie die Loggruppe aus, in der die Logs gespeichert werden sollen.

     Um eine neue Loggruppe zu erstellen, wählen Sie das Compartment aus, und klicken Sie auf Loggruppe erstellen. Geben Sie im Dialogfeld den Namen und die Beschreibung ein. Klicken Sie auf Erstellen.

   • Klicken Sie auf die Schaltfläche Dateien auswählen, und wählen Sie die hochzuladenden Logdateien aus. Dateitypen wie ZIP, TAR, TGZ und alle Raw-Textdateien werden zum Hochladen akzeptiert. Sie können mehrere Dateien in einem einzelnen Upload auswählen.

   Eine Übersicht über die zum Hochladen ausgewählten Dateien wird angezeigt. Beachten Sie, dass die maximale Größe einer einzelnen Datei 100 MB beträgt. Sie können maximal 25 einzelne Dateien pro Upload hochladen. Eine Datei ohne Inhalt ist ungültig und wird beim Hochladen nicht berücksichtigt, wenn mehrere Dateien ausgewählt sind.

   Klicken Sie auf Weiter.

4. Eigenschaften festlegen: Auf dieser Seite wird die Liste der im ersten Schritt ausgewählten Dateien angezeigt. Sie müssen die Quelle für die Verarbeitung jeder Datei angeben. Optional können Sie weitere zusätzliche Eigenschaften angeben. Um die Eigenschaften aller Dateien festzulegen, aktivieren Sie das Kontrollkästchen im Header, und klicken Sie auf Eigenschaften festlegen. Um die Eigenschaften einer bestimmten Datei festzulegen, klicken Sie neben der Datei auf das Menüsymbol "Aktionen" und anschließend auf Eigenschaften festlegen. Das Dialogfeld "Eigenschaften festlegen" wird geöffnet.
   1. Wählen Sie im Dropdown-Menü Quelle die Quelle aus, die zur Verarbeitung der Logdateien verwendet werden soll.

      Um On-Demand-Uploads auszuführen, muss die Quelle den Typ Systemereignismeldungen (Syslog), Datei oder Oracle Diagnostic Logs (ODL) aufweisen.

   2. Wenn Sie diese hochgeladenen Dateien einer Entity zuordnen möchten, wählen Sie optional das Compartment der Entity im Dropdown-Menü Entity-Compartment aus.
   3. Sie können auch die Entity angeben. Das Dropdown-Menü Entity wird je nach ausgewähltem Entity-Compartment und dem in der ausgewählten Quelle definierten Entitytyp aufgefüllt. Wählen Sie die Entity aus.
   4. Möglicherweise müssen Sie die erweiterten Eigenschaften angeben, wenn die erforderlichen Informationen für die ordnungsgemäße Verarbeitung im Logeintrag nicht verfügbar sind. Blenden Sie den Abschnitt Erweiterte Optionen anzeigen ein. Wählen Sie im Dropdown-Menü die Werte der Parameter Logzeitzone, Zeichencodierung, Datumsformat und Loginhaltsjahr aus. Klicken Sie auf Änderungen speichern.
      • Logzeitzone: Die Zeitzoneninformationen für die Verarbeitung der Logeinträge. Standardmäßig werden die Zeitzoneninformationen im Logeintrag für die Verarbeitung verwendet. Wenn die Informationen im Logeintrag nicht verfügbar sind, wird der im Menü ausgewählte Wert verwendet. Falls der Wert weder aus diesem Menü noch direkt aus dem Logeintrag abgerufen werden kann, wird die Zeitzone der Entity verwendet. Wenn keine Informationen zur Zeitzone verfügbar sind, wird der Standardwert UTC verwendet.
      • Zeichencodierung: Die Zeichencodierung der hochgeladenen Logdateien. Oracle Log Analytics versucht, die Zeichencodierung automatisch zu ermitteln. In bestimmten Anwendungsfällen müssen Sie diesen Wert jedoch möglicherweise außer Kraft setzen.
      • Datumsformat: Das Format für die Datumsinformationen, die in den Logdateien verfügbar sind. Wenn Sie das Makro {TIMEDATE} verwenden, entfernen Sie mit diesem Parameter alle Mehrdeutigkeiten bei der Identifizierung des Datumsformats im angegebenen Logeintrag. Beispiel: Wenn das Datum 12/10 lautet und als 12th October oder 10th December interpretiert werden kann, können Sie DAY_MONTH oder MONTH_DAY verwenden, um Mehrdeutigkeit zu entfernen. Wenn das Datum 12/10/08 lautet, können Sie DAY_MONTH_YEAR, MONTH_DAY_YEAR oder YEAR_MONTH_DAY verwenden.

        Wenn der Parser die Extraktion der Zeitkomponente verwendet, gibt es keine Mehrdeutigkeit. Daher können Sie die Angabe des Datumsformats überspringen.

      • Loginhaltsjahr: Die Jahresinformationen, die für die Verarbeitung der Logeinträge verwendet werden, wenn die Logeinträge keine Jahresinformationen im Zeitstempel enthalten.

      Blenden Sie die Zeile in der Tabelle ein, um die angegebenen Eigenschaften anzuzeigen. Sie können ausgewählte Dateien bei Bedarf aus der Uploadliste entfernen.

      Wählen Sie für jede Uploaddatei eine Quelle aus, bevor Sie mit dem Upload fortfahren.

   5. Klicken Sie auf Weiter.
5. Prüfen: Prüfen Sie die Eigenschaften der Dateien, die Sie zum Hochladen ausgewählt haben. Um die Eigenschaften zu bestätigen und den Hochladen zu initiieren, klicken Sie auf Hochladen.

   Oracle Log Analytics indiziert und verarbeitet die Dateien. Wenn der Upload abgeschlossen ist, klicken Sie auf Schließen, um zur Listenseite der Uploads zu navigieren.

   Wenn der Upload einer Datei nicht erfolgreich verläuft, klicken Sie auf das Symbol Wiederholen neben dem Dateinamen, um die Datei erneut hochzuladen. Wenn der Upload erfolgreich abgeschlossen wurde, klicken Sie auf Schließen, um zur Listenseite der Uploads zu navigieren.

Sie können Logdateien mit der OCI-CLI über eine Befehlszeilenschnittstelle in Oracle Log Analytics hochladen. Mit dieser einfachen Schnittstelle können Sie Uploads automatisieren, indem Sie die CLI in Ihre Anwendung integrieren.

Informationen zur Verwendung der CLI finden Sie unter Befehlszeilenschnittstelle (CLI).

Eine vollständige Liste der Flags und Optionen für CLI-Befehle verfügbar sind, finden Sie unter Befehlszeilenreferenz: Log Analytics - Upload.

Führen Sie die folgenden CLI-Befehle aus, um loganalytics-ondemand-upload zu verwalten:

• Logdatei hochladen:

  oci log-analytics upload upload-log-file --namespace-name <namespace_name> --log-source-name <log-source-name> --upload-name <upload-name> --filename <file_name> --opc-meta-loggrpid <opc-meta-loggrpid> --file <path_to_log_file>

  Beispielantwort des obigen Befehls:

  {
    "data": {
    "name": null,   
    “reference” : “32817130200562135",
    “timeCreated” : “2020-06-01T12:00:00.000Z”,
    "time-earliest-log-entry": null,
    "time-latest-log-entry": null,
    "time-updated": null,
    "warnings-count": null
    }
  }

• Upload löschen:

  oci log-analytics upload delete --namespace-name <namespace_name> --upload-reference <upload-reference>

• Uploads auflisten:

  oci log-analytics upload list --namespace-name <namespace_name>

• Upload abrufen:

  oci log-analytics upload get --namespace-name <namespace_name> --upload-reference <upload-reference>

• Uploaddateien auflisten:

  oci log-analytics upload list-upload-files --namespace-name <namespace_name> --upload-reference <upload-reference>

• Uploaddatei löschen:

  oci log-analytics upload delete-upload-file --namespace-name <namespace_name> --upload-reference <upload-reference> --file-reference <file-reference>

Nach Abschluss eines On-Demand-Uploads der Logdaten können Sie die Übersicht über Uploads anzeigen und den Dateistatus prüfen.

1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Observability and Management. Klicken Sie unter Log Analytics auf Administration. Die Seite Administration - Überblick wird geöffnet.
2. Klicken Sie im linken Bereich unter Ressourcen auf Uploads. Dadurch werden die neuesten On-Demand-Uploads angezeigt.
3. Um die verarbeiteten Daten des Uploads anzuzeigen, klicken Sie auf das Menüsymbol für den Upload und wählen Sie In Log Explorer anzeigen aus.
4. Um die Liste der Dateien im Upload zusammen mit dem jeweiligen Verarbeitungsstatus anzuzeigen, klicken Sie auf den Uploadnamen.

Nach Abschluss eines On-Demand-Uploads der Logdaten können Sie die Übersicht über Uploads anzeigen und den Dateistatus prüfen. Wenn der Dateiupload nicht erfolgreich war oder Sie die Dateien für diesen Upload nicht mehr beibehalten möchten, können Sie sie löschen.

1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Observability and Management. Klicken Sie unter Log Analytics auf Administration. Die Seite Administration - Überblick wird geöffnet.
2. Klicken Sie im linken Bereich unter Ressourcen auf Uploads. Dadurch werden die neuesten On-Demand-Uploads angezeigt.
3. Um einen On-Demand-Upload zu löschen, klicken Sie auf das Menüsymbol für den Upload und wählen Löschen aus.
4. Um eine Datei in einem On-Demand-Upload zu löschen, klicken Sie auf den Uploadnamen, um zur Seite "Uploaddetails" zu gelangen.

   Dadurch wird die Liste der Dateien angezeigt, die im angegebenen Upload enthalten sind. Sie können den Status jeder Datei neben dem Dateinamen anzeigen.

   Klicken Sie zum Löschen einer Datei auf das Menüsymbol neben dem Dateinamen, und wählen Sie Löschen aus.

Erstellen Sie eine Metadaten-JSON-Datei, und geben Sie ihr den Namen uploads_metadata.json. Beispiel für eine Metadatendatei:

{
    "field1":"value1",
    "field2":"value2"
}

In der obigen Datei sind field1 und field2 von Oracle definierte oder benutzerdefinierte Felder. Siehe Feld erstellen. Alle diese Felder sowie die angegebenen Werte werden jedem geparsten Logdatensatz hinzugefügt.

Erstellen Sie eine ZIP-Archivdatei, die die eigentlichen Logdaten in einem der unterstützten Dateiformate und die Datei uploads_metadata.json enthält. Die Datei uploads_metadata.json muss sich in der obersten Hierarchie der ZIP-Datei befinden.