Skip to main content
审计日志功能适用于 企业版 计划。如果您有兴趣升级到企业版，请联系我们的销售团队。
LangSmith 审计日志提供了组织内执行的管理和配置操作的防篡改记录。它们帮助您回答以下问题：
  • 谁删除了 API 密钥、数据集或部署？
  • 何时邀请了新成员、修改了角色或更新了示例？
  • 什么计费、SSO 或数据保留配置被更改？
  • 哪些数据集、追踪项目或提示 Webhook 被修改？
审计日志对于安全审查、合规要求和一般运营可见性非常有用。

​
前提条件

​
记录内容

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

​
保留期

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

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

审计日志适用于运行 Helm 图表 0.12.33 或更高版本（应用程序版本 0.12.33）的自托管 LangSmith 实例。升级后，使用以下选项之一启用审计日志：
  • 为特定组织启用： 针对您的 LangSmith PostgreSQL 数据库运行以下命令，将 <organization_id> 替换为从 UI 中组织设置页面复制的 ID： 
    UPDATE organizations SET config = config || '{"can_use_audit_logs": true}' WHERE id = '<organization_id>' AND NOT is_personal;
  • 为所有组织启用： 在您的 values.yaml 文件的 commonEnv 中添加以下环境变量： 
    DEFAULT_ORG_FEATURE_CAN_USE_AUDIT_LOGS: "true"
    此环境变量对个人组织无效。
有关自托管版本的更多详细信息，请参阅自托管更新日志。

​
通过 API 查询审计日志

使用 GET /api/v1/audit-logs 端点（API 参考）来检索审计日志事件。结果遵循 OCSF API Activity 模式。

​
请求示例

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 Activity (Class UID 6003) 格式返回。关键字段：
字段描述
actor.user.uid执行操作的用户 UUID。
actor.user.credential_uid用于验证请求的 API 密钥、PAT 或服务密钥的 UUID。如果用户通过会话（例如 UI）进行身份验证，则为 null。
api.operationLangSmith 操作名称（例如 create_api_key、delete_workspace）。所有值请参阅跟踪操作参考。
statusSuccess、Failure 或 Unknown。
resources受操作影响的资源 UUID 列表（例如，被更新的角色、被创建的工作空间）。
metadata.uid此审计日志事件的唯一标识符。
unmapped.original_audit_log完整的 LangSmith 原生审计日志记录，包括 organization_id 和 workspace_id。

​
转发到外部系统

要将审计日志事件转发到外部 SIEM 或日志平台，您可以运行一个计划函数，每小时拉取前一小时的事件。例如，使用 AWS Lambda + EventBridge Scheduler，失败的事件会进入死信队列，以便您知道需要重试哪些时间窗口。

​
跟踪操作参考

类别操作 (api.operation)
API 密钥和凭证create_api_key, delete_api_key, create_personal_access_token, delete_personal_access_token, create_service_key, delete_service_key
角色create_role, update_role, delete_role
组织成员invite_user_to_org, invite_users_to_org_batch, update_org_member, delete_org_member, delete_org_pending_member, add_basic_auth_users_to_org, update_basic_auth_user
SSO 和身份验证create_sso_settings, update_sso_settings, delete_sso_settings, update_login_methods, update_default_sso_provision_organization
SCIM 配置create_scim_token, update_scim_token, delete_scim_token, create_scim_user, update_scim_user, delete_scim_user, create_scim_group, update_scim_group, delete_scim_group
计费和业务信息update_organization_info, update_business_info, update_payment_plan, update_payment_method, create_payment_setup_intent, create_payment_checkout_session, confirm_payment_checkout_session, create_payment_account_link
工作空间create_workspace, update_workspace, delete_workspace, add_member_to_workspace, add_members_to_workspace_batch, delete_workspace_member, update_workspace_member, delete_workspace_pending_member, update_workspace_secrets, unshare_entities, set_tenant_handle
数据保留update_ttl_settings, update_usage_limit, delete_usage_limit
追踪项目update_tracer_session, delete_tracer_session, delete_tracer_sessions
数据集create_dataset, create_csv_dataset, update_dataset, delete_dataset, delete_datasets, update_dataset_version, update_dataset_splits, share_dataset, unshare_dataset, clone_dataset, create_experiment_via_upload, create_playground_experiment, create_comparative_experiment, delete_comparative_experiment
示例create_example, create_examples, update_example, update_examples, delete_example, delete_examples
部署create_deployment, update_deployment, delete_deployment
提示 Webhookcreate_prompt_webhook, update_prompt_webhook, delete_prompt_webhook, test_prompt_webhook
批量导出create_bulk_export, cancel_bulk_export, read_bulk_export_destination, create_bulk_export_destination, update_bulk_export_destination
资源标签create_tag_key, update_tag_key, delete_tag_key, create_tag_value, update_tag_value, delete_tag_value, create_tagging, delete_tagging
访问策略create_access_policy, delete_access_policy, list_access_policies, read_access_policy, attach_access_policies, read_role_access_policies
自定义图表create_chart, update_chart, delete_chart, create_chart_section, update_chart_section, delete_chart_section, clone_chart_section, create_org_chart, update_org_chart, delete_org_chart, create_org_chart_section, update_org_chart_section, delete_org_chart_section
模型定价create_model_price_map, update_model_price_map, delete_model_price_map

​
常见问题

拥有 组织管理员 或 组织操作员 角色（授予 organization:manage 权限）的用户可以访问审计日志。工作空间级别的角色不提供审计日志访问权限。
不提供。审计日志是企业版功能。有关计划详情，请参阅定价。
目前没有。审计日志可通过 API 获取。
审计日志目前主要关注写入操作。未来可能会添加对更多读取操作的支持。
是的。我们计划随着时间的推移扩展跟踪的操作集。跟踪操作参考始终反映当前支持的操作集。
API 仅以 OCSF 格式返回事件。每个事件中的 unmapped.original_audit_log 字段包含原始的 LangSmith 审计日志记录，如果您需要不同格式的数据。
开放网络安全架构框架 (OCSF) 是一个用于安全事件数据的开放标准。LangSmith 将审计日志事件作为 OCSF v1.7.0 API Activity (Class 6003) 对象返回。
Edit this page on GitHub or file an issue.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.