test-cloud

latest

false

重要 :

新发布内容的本地化可能需要 1-2 周的时间才能完成。

Test Cloud 管理员指南

适用平台：

上次更新日期 2026年4月7日

导出日志

备注：

功能可用性取决于您使用的云平台。有关详细信息，请参阅功能可用性页面。

“企业标签”图片仅当您订阅企业版许可计划时，才可以使用此功能。

在统一日志体验中，您可以使用以下方法之一以 CSV 格式导出日志：

用户界面中的“导出”选项：在组织或租户的“审核日志”部分中，选择“导出” 。
审核日志 API ：使用审核日志 API。
UiPath 自定义脚本：运行 UiPath 开发的脚本以从 UiPath 的长期审核日志存储中导出日志。

出于长期保留或合规性目的，统一日志体验和传统日志体验都允许您配置机器人日志导出，以自动将数据从 Orchestrator 发送到 Azure Blob 存储、AWS S3 或 Google Cloud Storage，这些文件每小时生成一次，并且可以通过使用您自己的 BI 或监控解决方案进行处理。

使用脚本导出日志

如果您使用的是统一日志体验，则可以使用专用脚本来导出无法再通过“审核日志”界面使用的审核日志。该脚本支持检索 2 年前的日志。

在以下情况下，此脚本很有用：

出于合规性或调查目的，您需要访问较旧的审核日志。
您想要自动执行长期日志存档。

先决条件

将以下脚本复制到您自己的.sh文件中：

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"
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"

在 WSL（适用于 Linux 的 Windows 子系统）环境中运行脚本并确保已安装以下工具：
```
sudo apt install dos2unix unzip jq
sudo apt install dos2unix unzip jq
```

使用以下命令准备要执行的脚本：

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

在租户中创建机密外部应用程序并分配以下 API 作用域： PM.Audit.Read （应用程序）。
收集以下应用程序凭据：
- 应用程序 ID ( client_id )
- 应用程序密码 ( client_secret )

步骤

在终端中设置所需的变量：

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'
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'

使用以下命令运行脚本： ./<script-name>.sh $client_id $client_secret $org_name $start_date $end_date 。例如：

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
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

配置机器人日志导出

备注：

功能可用性取决于您使用的云平台。有关详细信息，请参阅功能可用性页面。

要将在 Orchestrator 服务中生成的 Robot 日志导出到 Azure、AWS S3 和 Google Cloud Storage，请遵循进一步描述的特定程序。日志保存在uipathrobotlogs容器中的.csv文件中。导出是按租户进行的，这有助于实现以下目的：

存储必须保留的日志，以用于合规性和审计目的。
在您自己的报告或 BI 工具中分析和可视化日志输出。
备注：
配置日志导出页面时，我们不支持回填 30 天前的日志。

登录到您的 UiPath 帐户。
导航到“管理员”，然后在左侧面板中选择租户。
选择“服务” 。
在 Orchestrator 卡上，选择“更多”图标，然后选择“日志导出配置” 。

“配置”面板将在窗口右侧打开。
启用“将 Robot 日志发送到自定义存储”开关。
根据您的云平台，继续执行以下步骤：
- Test Cloud:
  1. 从“存储类型”下拉列表中，选择要将日志导出到的存储提供程序。可用的选项如下：
    - Azure
    - AWS S3
    - Google Cloud Storage
    备注：
    日志导出功能不支持AWS KMS 。
  2. 执行特定于提供程序的步骤后，系统将生成.csv 。下载 .csv 示例：
  3. 日志将按小时发送。此时间间隔不可配置。
- Test Cloud 公共部门和 Test Cloud 专用：
  - 继续使用Azure部分中描述的过程。

Azure

提示：

您可以将静态 IP 配置到允许列表，并且不对所有外部 IP 开放网络。转到 Azure Blob 存储中的“设置” >“网络” >“公共访问” >“防火墙” >“地址范围”，以添加静态 IP。请查看配置防火墙页面，以获取完整的 IP 列表。

支持以下存储选项：

标准本地冗余存储 (LRS)
标准异地冗余存储 (GRS)
标准读取访问异地冗余存储 (RA-GRS)
标准区域冗余存储 (ZRS)
高级 LRS

有关存储类型的更多信息，请查看 Azure 官方文档中的“存储帐户概述”页面。

从“存储类型”下拉列表中，选择“Azure 存储帐户”。
在“Azure Blob 连接字符串”字段中，输入从 Azure 门户检索到的 Blob 连接字符串。
在“容器名称”字段中，输入 Azure 中用于存储 csv 的容器的名称。默认情况下为 uipathrobotlogs。如果提供了自定义容器名称，但该名称尚不存在，则系统将为您创建容器。
选择“保存” 。系统会显示一条通知，通知您已成功配置机器人日志导出。
在 Azure Portal 的 Blob 存储帐户中：
- 在左侧面板中的“设置”下选择“网络” 。
- 选择“允许的访问起点 > 所有网络”。
- 选择“保存”以保存更改。
在一个小时内，Blob 存储中将生成 .csv 日志文件。此 .csv 在 uipathrobotlogs 容器中生成，位于以下文件夹层次结构 [tenant_key]/[year]/[month]/[day]/[hour]/output。建议一个租户对应一个容器，这是因为如果有多个租户路由到一个容器，则租户密钥是区分租户的唯一方法。

AWS S3

提示：

您可以将静态 IP 配置到允许列表，并且不对所有外部 IP 开放网络。使用 AWS S3 中的访问策略来添加“拒绝所有请求”，除非请求来自aws:SourceIp列表，如 AWS S3 用户指南中的Amazon S3 的存储桶策略页面中所述。有关完整的 IP 列表，请查看 Automation Cloud 管理员指南中的“配置防火墙”页面。

从“存储类型”下拉列表中，选择“AWS S3”。
在“存储桶名称”字段中，输入在 AWS 中配置的存储桶名称。

备注：
多个组织不能共享相同的存储桶名称。
在“区域名称”字段中，输入要导出日志的区域的名称。例如 us-west-1。
确保向通过提示 s3:PutObject 和 s3:DeleteObject提供的 IAM 用户授予存储桶访问权限。

Google Cloud Storage

从“存储类型”下拉列表中，选择“Google Cloud Storage”。
在“存储桶名称”字段中，输入在 Google Cloud Platform 中配置的存储桶名称。

备注：
多个组织不能共享相同的存储桶名称。
根据以下提示中的指定，授予对 UiPath™ 服务帐户的适当访问权限：
1. 在 Google Cloud Platform 中，导航到“存储” > “浏览器”。
2. 找到您要编辑权限的存储桶。
3. 选择垂直省略号，然后选择“编辑存储桶权限” 。
4. 选择“添加成员” ，然后输入用于访问存储桶的服务帐户。
5. 从“选择角色”下拉列表中，选择“存储对象管理员” 。如需了解详情，请参阅 GCP 文档中的“身份和访问管理” 。

删除日志导出设置

展开要为其删除日志导出设置的租户。
对于该租户中的 Orchestrator 服务，请选择“日志导出配置” 。系统将显示“配置”右侧面板。
禁用“将 Robot 日志发送到自定义存储”开关。
在“删除配置”窗口中，选择“删除”以确认。已成功删除配置。

在此页面上

使用脚本导出日志
先决条件
步骤
配置机器人日志导出
Azure
AWS S3
Google Cloud Storage
删除日志导出设置

此页面有帮助吗？

前一个关于日志

下一个在您的组织中进行测试

Test Cloud 管理员指南

使用脚本导出日志​

先决条件​

步骤​

配置机器人日志导出​

Azure​

AWS S3​

Google Cloud Storage​

删除日志导出设置​