Protokolle exportieren

Diese Funktion ist nur verfügbar, wenn Sie sich im Enterprise-Lizenzierungsplan befinden.

Sie können Protokolle aus Automation Cloud^TM im CSV-Format mit einer der folgenden Methoden exportieren:

• Option Exportieren auf der Benutzeroberfläche: Wählen Sie im Abschnitt Prüfungsprotokolle Ihrer Organisation oder Ihres Mandanten die Option Exportieren.
• APIs für Prüfungsprotokolle: Verwenden Sie die APIs für Prüfungsprotokolle.
• Benutzerdefiniertes UiPath-Skript: Führen Sie ein von UiPath entwickeltes Skript aus, um Protokolle aus dem langfristigen Prüfungsprotokollspeicher von UiPath zu exportieren.

Für die langfristige Aufbewahrung oder Compliance können Sie Roboterprotokollexporte so konfigurieren, dass Daten automatisch vom Orchestrator an Azure Blob Storage, AWS S3 oder Google Cloud Storage gesendet werden, wo Protokolldateien stündlich generiert werden und mit Ihren eigenen BI- oder Überwachungslösungen verarbeitet werden können.

Exportieren von Protokollen mit Skript

You can use a dedicated script, to export audit logs that are no longer available through the Audit Logs interface. The script supports retrieving logs up to 2 years in the past.

Dieses Skript ist in folgenden Fällen nützlich:

• Sie benötigen Zugriff auf ältere Prüfungsprotokolle zu Compliance- oder Ermittlungszwecken.

• Sie möchten die langfristige Protokollarchivierung automatisieren.

Voraussetzungen

1. Copy the following script into a .sh file of your own:

   appId=$1
   appSecret=$2
   organizatioNameOrId=$3
   fromDate=$4
   toDate=$5
   mode=${6:-s}
   cloud=${7:-cloud}
   
   if [[ $# -lt 5 ]]; then
     echo "Error: Not all required input parameters provided."
     echo "Usage: $0 <appId> <appSecret> <organizatioNameOrId> <fromDate> <toDate> <mode>(optional: v for verbose, s for silent)"
     exit 1
   fi
   
   # Validate "fromDate" date format (MM/DD/YYYY)
   if ! date -d "$fromDate" &>/dev/null; then
     echo "Error: Invalid date format for 'fromDate'. Please use MM/DD/YYYY format."
     exit 1 
   fi
   
   # Validate "to" date format (MM/DD/YYYY)
   if ! date -d "$toDate" &>/dev/null; then
     echo "Error: Invalid date format for 'toDate'. Please use MM/DD/YYYY format."
     exit 1
   fi
   
   echo $(date +"%Y-%m-%d %H:%M:%S.%3N") "Start Getting UiPath Token."
   response=$(curl --data-urlencode -X POST "https://${cloud}.uipath.com/${organizationNameOrId}/identity_/connect/token" -$mode \
               -d "grant_type=client_credentials" \
               -d "scope=PM.Audit.Read" \
               -d "client_id=$appId" \
               -d "client_secret=$appSecret" \
               -H "Content-Type: application/x-www-form-urlencoded")
   
   access_token=$(echo "$response" | jq -r '.access_token')
   
   if [[ "$access_token" == null ]]; then
     echo "Error: Access token is null or empty in the response. Please verify the appId and appSecret."
     exit 1
   fi
   
   base_dir=$(date +"%Y-%m-%d%H:%M:%S.%3N")
   echo $base_dir "Start Downloading UiPath Platform Audit logs."
   # Define the base URL
   base_url="https://${cloud}.uipath.com/${organizatioNameOrId}/orgaudit_/api/query/downloadeventsfromlongtermstore"
   
   mkdir -p $base_dir
   # Iterate through time intervals
   current_date=$(date -u -d "$fromDate" +"%Y-%m-%dT%H:%M:%SZ")
   seconds_in_a_day=$((24*60*60))
   while [ "$(date -d "$current_date" +%s)" -le "$(date -d "$toDate" +%s)" ]; do
     next_date=$(date -u -d "$current_date + $(($seconds_in_a_day-1)) seconds" +"%Y-%m-%dT%H:%M:%SZ")
     
     # Construct the full URL with the current time interval
     formatted_current_date=$(date -u -d "$current_date" +"%Y-%m-%dT%H:%M:%SZ" | sed 's/\//%2F/g')
     formatted_current_date="${current_date}"
     formatted_next_date=$next_date | sed 's/\//%2F/g'
     formatted_next_date="${next_date}"
     full_url="$base_url?from=$formatted_current_date&to=$formatted_next_date"
   
     echo $full_url
   
     echo "Downloading UiPath Audit Log from $current_date to $next_date"
     curl -X GET "$full_url" -$mode \
          -H "Authorization: Bearer $access_token" \
          -o "${base_dir}/${current_date////-}_to_${next_date////-}.zip"  # Save the response to a file
     
     # Move to the next time interval
     current_date=$next_date
     one=1
     current_date=$(date -u -d "$current_date + $one seconds" +"%Y-%m-%dT%H:%M:%SZ")
   done
   
   for zip_file in "$base_dir"/*.zip; do
     zip_file_name="$(basename "$zip_file")"
     unzip -q "$zip_file" -d "$base_dir/auditlogs/"
     echo "Extracted ${zip_file_name%.*}"
     rm "$zip_file"
   done
   
   shopt -s nullglob
   for zip_file in "$base_dir/auditlogs"/*.zip; do
     zip_file_name="$(basename "$zip_file")"
     unzip -q "$zip_file" -d "$base_dir/auditlogs/${zip_file_name%.*}"
     for data_file in "$base_dir/auditlogs"/${zip_file_name%.*}/*.txt; do
       data_file_name="$(basename "$data_file")"
       mv "$data_file" "$base_dir/auditlogs/${data_file_name%.*}_${zip_file_name%.*}.txt"
       rm -r "$base_dir/auditlogs/${zip_file_name%.*}"
     done
     rm "$zip_file"
   done
   shopt -u nullglob
   
   echo $(date +"%Y-%m-%d %H:%M:%S.%3N") "Downloaded UiPath Platform Audit logs and saved them according to UTC date"

2. Führen Sie das Skript in einer WSL-Umgebung (Windows Subsystem für Linux) aus und stellen Sie sicher, dass die folgenden Tools installiert sind:

   sudo apt install dos2unix unzip jq

3. Bereiten Sie das Skript mit den folgenden Befehlen auf die Ausführung vor:

   dos2unix <script-name>.sh
   chmod +x <script-name>.sh

4. Erstellen Sie eine vertrauliche externe Anwendung in Ihrem Mandanten und weisen Sie den folgenden API-Scope zu: PM.Audit.Read (Anwendung).

5. Erfassen Sie die folgenden Anwendungsanmeldeinformationen:

   • Anwendungs-ID (client_id)
   • Anwendungsgeheimnis (client_secret)

Schritte

1. Legen Sie die erforderlichen Variablen in Ihrem Terminal fest:

   client_id='<your-client-id>'
   client_secret='<your-client-secret>'
   org_name='<your-org-name>'
   start_date='MM/DD/YYYY'
   end_date='MM/DD/YYYY'

2. Führen Sie das Skript mit dem folgenden Befehl aus: ./<script-name>.sh $client_id $client_secret $org_name $start_date $end_date.

   Zum Beispiel:

   client_id='<clientId>'
   client_secret='<clientsecret>'
   org_name='test_org'
   start_date='09/01/2025'
   end_date='10/01/2025'
   ./<script-name>.sh $client_id $client_secret $org_name $start_date $end_date v

Konfigurieren des Exports von Roboterprotokollen

Um in Ihren Orchestrator-Diensten generierte Roboterprotokolle nach Azure, AWS S3 und Google Cloud Storage zu exportieren, befolgen Sie die weiter unten beschriebenen spezifischen Verfahren. Protokolle werden in einer .csv -Datei im Container uipathrobotlogs gespeichert. Der Export erfolgt pro Mandant, was Folgendes erleichtert:

• Speichern von Protokollen, die zu Compliance- und Prüfungszwecken aufbewahrt werden müssen.

• Analysieren und Visualisieren der Protokollausgabe in Ihren eigenen Bericht- oder BI-Tools.

  Hinweis: Beim Konfigurieren der Protokollexportseite unterstützen wir kein Abgleichen von Protokollen im Wert von 30 Tagen.

1. Melden Sie sich bei Ihrem Automation Cloud™-Konto an.
2. Wechseln Sie zu Administrator und wählen Sie den Mandanten im Bereich auf der linken Seite aus.
3. Dienste wählen.
4. Wählen Sie auf der Karte für Orchestrator das Symbol Mehr und dann Protokollexportkonfiguration aus.

   Der Bereich Konfiguration wird rechts neben dem Fenster geöffnet.

5. Aktivieren Sie den Umschalter Roboterprotokolle an benutzerdefinierten Speicher senden.
6. Wählen Sie in der Dropdown-Liste Speichertyp den Speicheranbieter aus, an den Sie Protokolle exportieren möchten. Die folgenden Optionen sind verfügbar:
   • Azure
   • AWS S3
   • Google Cloud Storage
   Hinweis:

   Die Protokollexportfunktion unterstützt AWS KMS nicht.

7. Nach Durchführung der anbieterspezifischen Schritte wird die .csv-Datei generiert.
   Beispieldatei (.csv) herunterladen
8. Protokolle werden stündlich zugestellt. Dieses Zeitintervall ist nicht konfigurierbar.

Azure

Tipp: Sie können statische IPs für die Zulassungsliste konfigurieren und Ihr Netzwerk nicht für alle externen IPs öffnen. Wechseln Sie in Azure Blob Storage zu Einstellungen > Netzwerke > Öffentlicher Zugriff > Firewall > Adressbereich, um die statischen IPs hinzuzufügen. Die vollständige Liste der IP-Adressen finden Sie auf der Seite Konfigurieren der Firewall .

Die folgenden Speicheroptionen werden unterstützt:

• Lokaler Redundanter Standardspeicher (LRS)
• Standardmäßiger georedundanter Speicher (GRS)
• Standardmäßiger georedundanter Speicher mit Lesezugriff (RA-GRS)
• Standardmäßiger zonenredundanter Speicher (ZRS)
• Premium-LRS

Weitere Informationen zu Speichertypen finden Sie auf der Seite Übersicht über Speicherkonten in der offiziellen Azure-Dokumentation.

1. Wählen Sie in der Dropdown-Liste Speichertyp die Option Azure Storage-Konto aus.
   
   

   

   
   
2. Geben Sie im Feld Azure Blob-Verbindungsstring den Blob-Verbindungsstring ein, wie er vom Azure Portal abgerufen wurde.
   
   

   

   
   
3. Geben Sie im Feld Containername den Namen des Containers ein, der zum Speichern der csv-Datei in Azure genutzt werden soll. Der Standardwert ist uipathrobotlogs. Wenn ein benutzerdefinierter Containername angegeben wird und noch nicht vorhanden ist, wird der Container für Sie erstellt.
4. Wählen Sie Speichern aus. Es wird eine Benachrichtigung angezeigt, dass Sie den Export von Roboterprotokollen erfolgreich konfiguriert haben.
5. In Ihrem Blob-Speicherkonto im Azure Portal:
   • Wählen Sie Netzwerk unter Einstellungen im linken Bereich aus.
   • Wählen Sie Zugriff zulassen über > Alle Netzwerke.

   • Wählen Sie Speichern aus, um die Änderungen zu speichern.

   
   

   

   
   
6. Innerhalb einer Stunde wird eine .csv Protokolldatei im Blob-Speicher generiert. Die .csv-Datei wird im Container uipathrobotlogs unter der folgenden Ordnerhierarchie generiert: [tenant_key]/[year]/[month]/[day]/[hour]/output. Es wird empfohlen, einen Mandanten einem Container zuzuordnen, da der Mandantenschlüssel die einzige Möglichkeit ist, zwischen Mandanten zu unterscheiden, wenn mehrere an einen Container weitergeleitet werden.
   
   

   

   
   

AWS S3

Tipp: Sie können statische IPs für die Zulassungsliste konfigurieren und Ihr Netzwerk nicht für alle externen IPs öffnen. Verwenden Sie Zugriffsrichtlinien in AWS S3, um „Verweigern Alle“-Anforderungen hinzuzufügen, es sei denn, sie stammen aus der aws:SourceIp -Liste, wie auf der Seite Bucket-Richtlinien für Amazon S3 im AWS S3-Benutzerhandbuch beschrieben. Die vollständige Liste der IP-Adressen finden Sie auf der Seite Konfigurieren der Firewall im Automation Cloud-Administratorhandbuch.

1. Wählen Sie in der Dropdown-Liste Speichertyp die Option AWS S3 aus.
   
   

   

   
   
2. Geben Sie im Feld Bucket-Name den Namen des Buckets ein, wie in AWS konfiguriert.
   Hinweis: Derselbe Bucket-Name kann nicht von mehreren Organisationen gemeinsam verwendet werden.
3. Geben Sie im Feld Regionsname den Namen der Regionen ein, in die Protokolle exportiert werden sollen. Beispiel: us-west-1.
4. Stellen Sie sicher, dass Sie dem IAM-Benutzer, der über die Eingabeaufforderung s3:PutObject und s3:DeleteObject bereitgestellt wird, Zugriff auf Ihr Bucket gewähren.

Google Cloud Storage

1. Wählen Sie in der Dropdown-Liste Speichertyp die Option Google Cloud Storage aus.
   
   

   

   
   
2. Geben Sie im Feld Bucket-Name den Namen des Buckets ein, wie in der Google Cloud-Plattform konfiguriert.
   Hinweis: Derselbe Bucket-Name kann nicht von mehreren Organisationen gemeinsam verwendet werden.
3. Gewähren Sie den entsprechenden Zugriff auf das UiPath®-Dienstkonto, wie in der folgenden Eingabeaufforderung angegeben:
   1. Navigieren Sie in Google Cloud-Plattform zu Speicher > Browser.
   2. Suchen Sie das Bucket, für das Sie Berechtigungen bearbeiten möchten.
   3. Wählen Sie die drei vertikalen Punkte und Bucket-Berechtigungen bearbeiten aus.
   4. Wählen Sie Mitglieder hinzufügen aus und geben Sie das Dienstkonto ein, das Sie für den Zugriff auf das Bucket verwenden.
   5. Wählen Sie in der Dropdown-Liste Rolle auswählen die Option Storage-Objektadministrator aus. Weitere Informationen finden Sie unter Identitäts- und Zugriffsverwaltung in der GCP-Dokumentation.
      
      

      

      
      

Löschen von Protokollexporteinstellungen

1. Klappen Sie den Mandanten aus, für den Sie die Protokollexporteinstellungen löschen möchten.
2. Wählen Sie für den Orchestrator-Dienst in diesem Mandanten die Option Konfiguration des Protokollexports aus. Das Konfiguration -Panel rechts wird angezeigt.
3. Deaktivieren Sie den Umschalter Roboterprotokolle an benutzerdefinierten Speicher senden.
4. Wählen Sie im Fenster Konfiguration löschen die Option Löschen aus, um zu bestätigen. Die Konfiguration wurde erfolgreich gelöscht.