云沙箱已接入云监控的事件中心。沙箱实例在创建、暂停、恢复、删除或退出时，会向事件中心上报生命周期事件。您可以订阅这些事件，并通过 Webhook、飞书、短信、电话或邮件接收通知，用于异常感知、自动化处理和资源审计。

适用场景

实时异常感知与自动化响应：将轮询查状态升级为事件驱动推送。收到实例异常或运行失败事件后自动触发告警，帮助缩短故障发现到处理的时延（MTTR），适用于 Agent 常驻、长任务、评测长跑等稳定性敏感场景。

全生命周期可观测：创建、暂停、恢复、删除等事件天然对应资源占用的起止，可作为客户侧用量审计、成本对账、多团队分账的辅助依据，同时支撑容量分析与行为审计。

前提条件

已开通云监控产品，操作详情参见开通云监控。

操作步骤

步骤一：创建通知策略

登录云监控控制台。

在左侧导航栏，单击通知 > 通知策略。

单击通知策略页签中的创建通知策略，配置通知策略相关参数。具体操作参见云监控文档创建通知策略。

步骤二：创建事件规则

登录云监控控制台。

在左侧导航栏，单击事件中心 > 事件规则。

在事件规则页面，单击创建事件规则，配置事件规则相关参数。资源类型选择函数服务，具体操作参见云监控文档创建事件规则。

步骤三：查看事件详情

事件触发后，即可查看事件通知的详情。

登录云监控控制台。

在左侧导航栏，单击事件中心 > 云产品事件，事件源选择函数服务。

单击操作列下的详情，查看事件详情。

事件通知格式

订阅成功后，系统会在沙箱实例发生相应事件时发送事件通知。事件通知的消息示例和字段说明如下。

通知示例

公共字段

字段	说明
specversion	CloudEvents 协议版本，固定为 1.0。
id	事件 ID，由云监控事件中心分配。
source	事件来源产品，固定为 vefaas。
type	事件类型。云沙箱事件命名遵循云监控事件中心的三段式规范：vefaas:Sandbox:<Action>.<Result>。其中 Action 为生命周期动作，Result 为执行结果。
time	事件发生时间，采用年-月-日T时:分:秒Z的格式，例如 2026-09-23T10:04:05Z，其中 Z 表示 UTC 时间。
subject	事件所属资源的 TRN。
resourceid	事件所属的沙箱实例 ID。
volcaccountid	火山引擎账号 ID。
volceventbusname	接收事件的事件总线名称，固定为 default。
volcregion	事件发生的地域，例如 cn-beijing。
volcresourcename	沙箱实例名称（若已配置），便于订阅侧展示。
volcprojectname	沙箱实例所属的 IAM 项目名称，可用于按项目过滤订阅。
datacontenttype	事件数据的内容类型，沙箱实例产生的系统事件统一为 application/json; charset=utf-8，表示 JSON 格式，并使用 UTF-8 字符编码。
data	事件详情。参照下表 Data 字段。

Data 字段

字段	说明
sandboxId	触发事件的沙箱实例 ID，与事件公共字段 resourceid 表示同一个沙箱实例。
status	事件对应操作的执行状态。例如，success 表示操作执行成功。
eventId	veFaaS 生成的业务事件 ID。
functionId	沙箱实例所属函数的 ID。
occurredAt	事件在 veFaaS 侧实际发生的时间，采用 RFC 3339 格式。
reason	事件发生的原因或错误码，取值参见事件类型。
requestId	触发本次操作的请求 ID，可用于关联 API 请求日志和排查问题。

事件类型

云沙箱事件类型命名遵循云监控事件中心的三段式规范：vefaas:Sandbox:<Action>.<Result>。其中 Action 为生命周期动作，Result 为执行结果。每条事件通过 data.reason 字段进一步区分具体触发场景或错误码。

事件名称	事件类型（type）	事件触发的可能原因（reason）
创建实例：执行成功	vefaas:Sandbox:CreateSandbox.Succeeded	无
创建实例：执行失败	vefaas:Sandbox:CreateSandbox.Failed	function_cold_start_timeout：沙箱实例未在等待时间内完成冷启动。 reached_max_replica_limit：沙箱实例到达数量上限。 InvalidParameter：创建沙箱实例的参数不合法或参数之间不匹配。 InvalidOperation：当前资源状态或配置不支持创建沙箱实例。 ResourceNotFound：创建沙箱实例所需资源不存在或已不可用。
暂停实例：执行成功	vefaas:Sandbox:PauseSandbox.Succeeded	manual：通过控制台、SDK、API 或自有自动化程序发起沙箱实例暂停。 lifecycle_expired：沙箱实例达到配置的到期时间后，触发自动暂停。
暂停实例：执行失败	vefaas:Sandbox:PauseSandbox.Failed	manual：通过控制台、SDK、API 或自有自动化程序发起沙箱实例暂停，但操作失败。 lifecycle_expired：沙箱实例达到到期时间后，触发的自动暂停，但是操作失败。
恢复实例：执行成功	vefaas:Sandbox:ResumeSandbox.Succeeded	无
恢复实例：执行失败	vefaas:Sandbox:ResumeSandbox.Failed	InvalidParameter：恢复沙箱实例的参数不合法或参数之间不匹配。 InvalidOperation：当前资源状态或配置不支持恢复沙箱实例操作。 ResourceNotFound：待恢复的沙箱实例不存在或已被删除，或其所属函数不可访问。
删除实例：执行成功	vefaas:Sandbox:KillSandbox.Succeeded	无
删除实例：执行失败	vefaas:Sandbox:KillSandbox.Failed	InvalidParameter：删除沙箱实例的参数不合法或参数之间不匹配。 InvalidOperation：当前配置不支持删除沙箱实例操作。 ResourceNotFound：待删除的沙箱实例不存在或已被删除，或其所属函数不可访问。
实例退出：正常退出	vefaas:Sandbox:Exited.Normal	exited：沙箱实例内主进程正常结束（退出码为 0），实例已按预期完成运行。
实例退出：异常退出	vefaas:Sandbox:Exited.Abnormal	无
实例运行：运行失败	vefaas:Sandbox:Run.Failed	HealthCheckFailed：健康检查失败。
实例运行：恢复运行	vefaas:Sandbox:Run.Recovered	无

函数服务