LangSmith 审计日志提供组织内管理和配置操作的防篡改记录。它们帮助您回答以下问题：

• 谁 删除了 API 密钥、数据集或部署？
• 何时 邀请了新成员、修改了角色或更新了示例？
• 什么 账单、SSO 或数据保留配置发生了变更？
• 哪些 数据集、追踪项目或提示 Webhook 发生了变更？

审计日志对安全审查、合规要求和运营可见性非常有用。

前提条件

• - 您的组织必须在 **Enterprise** 计划.
• - 您必须拥有 **组织管理员** or **组织操作员** 角色 (organization:manage 权限) 才能查看审计日志。

记录内容

审计日志记录对组织设置、成员资格、凭据、工作区和其他资源的变更。每个事件包括时间戳、操作者、操作名称、受影响的资源以及是否成功。完整的操作名称列表，请参阅 跟踪操作参考.

保留

审计日志最多保留 **400 天**。超过 400 天的事件可能会被自动删除。

为自托管部署启用审计日志

审计日志适用于 self-hosted 运行 Helm chart 的 LangSmith 实例 **0.12.33** 或更高版本。各个操作的覆盖范围随时间扩展——请参阅 自托管版本可用性 以了解每个操作的引入版本。

升级后，请使用以下选项之一启用审计日志：

• 为特定组织启用： 针对您的 LangSmith PostgreSQL 数据库运行以下命令，将 <organization_id> 替换为从 UI 中组织设置页面复制的 ID：

    UPDATE organizations SET config = config || '{"can_use_audit_logs": true}' WHERE id = '<organization_id>' AND NOT is_personal;
    

• 为所有组织启用： 在您的 commonEnv 中添加以下环境变量 values.yaml:

    DEFAULT_ORG_FEATURE_CAN_USE_AUDIT_LOGS: "true"
    

有关自托管版本的更多详细信息，请参阅 自托管变更日志.

通过 API 查询审计日志

使用 GET /api/v1/audit-logs 端点 (API 参考) 检索审计日志事件。结果遵循 OCSF API 活动 schema.

示例请求

curl -G \
  'https://api.smith.langchain.com/api/v1/audit-logs' \
  -H 'accept: application/json' \
  -H 'X-API-Key: lsv2_sk_...' \
  -H 'X-Organization-Id: abc123...' \
  -d 'limit=2' \
  --data-urlencode 'start_time=2026-01-01T18:35:16.232Z' \
  --data-urlencode 'end_time=2026-01-13T18:35:16.232Z' \
  --data-urlencode 'operations=create_api_key' \
  --data-urlencode 'operations=delete_api_key'

响应格式

审计日志事件以 OCSF v1.7.0 API 活动（类 UID 6003） 格式返回。关键字段：

转发到外部系统

若要将审计日志事件转发到外部 SIEM 或日志记录平台，您可以运行计划函数每小时提取前一小时的事件。例如，使用 AWS Lambda + EventBridge 调度器，失败事件会进入死信队列，方便您识别需要重试的时间窗口。

追踪操作参考

自托管版本可用性

以下列表提供了 self-hosted 引入每个操作的 Helm chart 版本。该操作在所有后续版本中可用。本节适用于 self-hosted 部署；在 LangSmith 云上，所有列出的操作均可用。

FAQ