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

​
先决条件

​
记录内容

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

​
保留期限

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

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

审计日志适用于运行 Helm chart 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_service_account, delete_service_account, list_org_personal_access_tokens, list_org_service_keys
角色create_role, update_role, delete_role
组织create_organization, create_provisioned_saas_org, create_tenant, invite_provisioned_org_member, claim_pending_organization_invite, delete_pending_organization_invite
组织成员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, get_sso_settings, get_sso_settings_current, get_login_methods, send_sso_email_confirmation, confirm_sso_user_email, login
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, 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, claim_pending_workspace_invite, delete_pending_workspace_invite, 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
运行和跟踪query_run, query_runs, query_trace, query_trace_messages, batch_query_trace_messages, query_threads, query_thread_traces, read_run, read_runs, delete_runs, get_run_cluster, generate_runs_query
数据集create_dataset, create_csv_dataset, update_dataset, delete_dataset, delete_datasets, update_dataset_version, update_dataset_splits, share_dataset, unshare_dataset, clone_dataset, download_dataset, generate_dataset, generate_shared_dataset_query, get_dataset_comparison_view, stream_dataset_comparison_view, read_dataset_delta, read_shared_delta, read_shared_delta_stream, 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, read_example, read_examples, get_example, list_examples, sync_examples, validate_example, validate_examples
实验create_experiment_view_override, update_experiment_view_override, delete_experiment_view_override, get_experiment_view_override, get_experiment_view_overrides, evaluate_experiment
评估器create_evaluator, update_evaluator, delete_evaluator, bulk_delete_evaluators, execute_custom_code
反馈create_feedback_config, update_feedback_config, delete_feedback_config, create_feedback_formula, update_feedback_formula, delete_feedback_formula, read_feedback, read_feedbacks, stream_feedback_delta
标注队列create_annotation_queue, update_annotation_queue, delete_annotation_queue, delete_annotation_queues, populate_annotation_queue, export_annotation_queue, add_annotation_queue_reviewer, remove_annotation_queue_reviewer, add_runs_to_annotation_queue, create_annotation_queue_run_status, update_annotation_queue_run, get_annotation_queue_run, get_annotation_queue_runs, delete_annotation_queue_run, delete_annotation_queue_runs, resolve_annotation_queue_run, get_pairwise_queue, list_pairwise_queues, list_pairwise_entries
警报create_alert_rule, update_alert_rule, delete_alert_rule, test_alert_rule
筛选视图create_filter_view, update_filter_view, delete_filter_view, rename_filter_view
提示提交和中心create_commit, create_directory_commit, delete_directory, create_hub_environment, update_hub_environment, delete_hub_environment
提示画布快速操作create_prompt_canvas_quick_action, update_prompt_canvas_quick_action, delete_prompt_canvas_quick_action
提示 webhookcreate_prompt_webhook, update_prompt_webhook, delete_prompt_webhook, test_prompt_webhook
部署create_deployment, update_deployment, delete_deployment
批量导出create_bulk_export, cancel_bulk_export, get_bulk_export, get_bulk_export_run, get_bulk_export_runs, get_bulk_export_runs_filtered, list_bulk_exports, create_bulk_export_destination, update_bulk_export_destination, read_bulk_export_destination, list_bulk_export_destinations
资源标签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, read_chart, read_charts, read_chart_preview, create_chart_section, update_chart_section, delete_chart_section, clone_chart_section, read_chart_section, create_org_chart, update_org_chart, delete_org_chart, create_org_chart_section, update_org_chart_section, delete_org_chart_section, read_tracing_dashboard
模型定价create_model_price_map, update_model_price_map, delete_model_price_map
MCP 服务器和工具create_mcp_server, update_mcp_server, delete_mcp_server, register_mcp_server_oauth, mcp_proxy, create_mcp_vendor_settings, update_mcp_vendor_settings, delete_mcp_vendor_settings, invalidate_mcp_tools_cache, create_tool, update_tool, delete_tool
网关策略create_gateway_policy, update_gateway_policy, delete_gateway_policy
Forge 配置create_forge_configuration, update_forge_configuration, delete_forge_configuration, trigger_forge_configuration
Insights 作业create_insights_job, update_insights_job, delete_insights_job, create_insights_job_config, update_insights_job_config, delete_insights_job_config, generate_insights_job_config, get_insights_job_runs
Fleet 使用限制和 webhookcreate_fleet_usage_limit, update_fleet_usage_limit, delete_fleet_usage_limit, create_fleet_webhook, update_fleet_webhook, delete_fleet_webhook, test_fleet_webhook
沙箱代理配置文件create_sandbox_proxy_profile, update_sandbox_proxy_profile, delete_sandbox_proxy_profile
Playground 设置create_playground_settings, update_playground_settings, delete_playground_settings
自托管许可create_self_hosted_customer, update_self_hosted_customer, mint_self_hosted_license, update_self_hosted_license
功能模型默认值upsert_feature_default_model, delete_feature_default_model, upsert_feature_disabled_model, delete_feature_disabled_model
入门引导create_onboarding_state, update_onboarding_state
NPSsubmit_nps_response

​
常见问题

拥有 组织管理员 或 组织操作员 角色（授予 organization:manage 权限）的用户可以访问审计日志。工作区级别的角色不提供审计日志访问权限。
不提供。审计日志是企业版功能。有关计划详情，请参阅定价。
目前没有。审计日志可通过 API 获取。
审计日志目前主要关注写入操作。未来可能会添加对更多读取操作的支持。
是的。我们打算随着时间的推移扩展跟踪的操作集。跟踪的操作参考始终反映当前支持的操作集。
API 仅以 OCSF 格式返回事件。如果您需要不同形状的数据，每个事件中的 unmapped.original_audit_log 字段包含原始的 LangSmith 审计日志记录。
开放网络安全模式框架 (OCSF) 是一个用于安全事件数据的开放标准。LangSmith 将审计日志事件作为 OCSF v1.7.0 API Activity (Class 6003) 对象返回。
将这些文档通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
在 GitHub 上编辑此页面 或 提交问题。