跳到主要内容
工程

本页尚未翻译,当前显示英文版本。

Functions

Functions 是你监控和运维游戏服务端代码的地方。 这里展示每个 Function 的健康状况和副本、环境变量和 secret、运行时设置、部署历史和日志。代码通过 PlayServ CLI 部署到这里;Backoffice 负责运行、配置和观察你部署的内容。页面内容限定在顶栏所选的 Environment。

机器池上和自托管的 game server 不在这里列出

Functions 列出的是 PlayServ 在 Cloud Run 上运行的云函数和 game server。运行在 machine pool 或你自己机器上的 game server 在这里没有可部署或扩缩的内容,它们位于 Servers。


概览

整个 Environment 的一排关键指标。

指标含义
Functions live当前正在处理流量的 Function 数量。
Replicas running正在运行的实例数,以及分布在多少个区域。
Invocations 24h过去 24 小时的调用次数。
Error rate 24h失败调用的占比:不超过 1% 为 within target,超过 1% 为 elevated,超过 5% 为 above threshold。
P95 latency 24h第 95 百分位响应时间:从 200 ms 起为 warning,超过 800 ms 为 critical。

Function 列表

每一行显示 Function 的语言、名称、状态、副本数、24 小时调用量和错误率、P95 延迟,以及部署时间和对应的 revision。可以按名称、处理器或触发器搜索,并按 Status、Trigger 和 Runtime 筛选。

状态含义
live已部署并正在处理流量。
staged已声明,但还没有部署代码。
failing最近一次构建失败,或者 Function 声明的某个 secret 在当前 Environment 中没有值。
disabled被运营人员停用。不接受任何调用,代码和数据保留。
deleted已从 Environment 中移除。

新 Function 通过 CLI 部署来创建,或者通过向已绑定的分支推送来创建。Backoffice 中的 New function 即将推出。要连接代码仓库,请使用 Project settings → Deployment:本页上的 Connect repo 按钮仍显示 coming soon。


单个 Function

点击某个 Function 打开它的面板。面板顶部显示名称、触发器、部署时间以及来自哪个 revision。面板有四个标签页,底部提供 Disable(或 Enable)和 Delete。

状态

区块含义
Status · Auth · Last invocation是否在处理流量、从何时开始;调用方是否需要已登录的 Player;最近是否被调用过。
Replicas · 24h invocations · 24h error rate运行中的副本数与上限,以及扩缩策略;过去 24 小时的调用次数和失败次数。
Versions最新的部署,以及与之并行提供服务的版本标签。
Replicas每个运行中的副本,包括区域和资源占用。选中一个即可查看 At a glance:状态和运行时长、区域、内存占用与上限、15 分钟平均 CPU、它运行的部署,以及最近一次错误。下方是该副本日志的实时尾部输出。

Scale 打开扩缩对话框:manual 策略使用固定的副本数,auto 策略设置最小值和最大值。Cloud Run 会自行替换 Function 的实例,因此无法重启或停止单个副本。

在这里设置的扩缩配置会在下次部署时重置

部署时以 platform.json 中的扩缩配置为准。如果希望新值保留下来,也要在那里修改。

Bindings

运行时注入到 Function 中的所有内容。

列环境变量
Name变量名,例如 LOG_LEVEL。
Effective valueFunction 实际收到的值。
Manifest default来自 platform.json 的值,在这里只读。
Override (this env)只对当前 Environment 生效的值,可直接在行内编辑。
列Secret
NameFunction 声明的 secret,例如 STRIPE_API_KEY。
Status在当前 Environment 中有值时为 linked,尚未设置时为 missing。缺少 secret 会让 Function 处于 failing。
Rotated值最近一次更改的时间。

Rotate 替换 secret 的值:粘贴新值后,使用它的 Function 会读取到新值。值永远不会显示出来。Functions 顶部项目级的 Bindings 标签页在一张表里列出所有 Function 的变量,还有一张 Secrets 卡片:在那里点 Add secret 可以给 missing 的 secret 设置值,不再被任何 Function 使用的 secret 也可以在那里删除。

设置

设置取值默认值
Memory tierLight 128 MB · Standard 256 MB · Heavy 512 MB · XL 1 GB · 2XL 2 GB—
Timeout每次调用最长 3600 s云函数为 60 s,game server 为 3600 s
Max concurrency每个副本同时处理 1–1000 个调用云函数为 80,game server 为 1000
Scalingmanual · N replicas 或 auto · min–max;通过 Scale 修改来自 platform.json
Auth requirementplayer:调用方必须是已登录的 Player。none:不需要 Player。来自 platform.json

无论哪种设置,每次调用都需要 API key;谁可以调用某个 Function,由其 manifest 中的 execute 决定。被拒绝的调用方会收到 403 function_execute_forbidden,缺少所需 Player 会话的调用会收到 401 player_auth_required。设置保存后立即生效,无需重新部署。

部署

这个 Function 的每一次构建,按时间倒序排列,包括部署时间、revision、部署人以及构建结果。列表只读:部署来自 CLI。

状态含义
queued · building · deploying进行中。
live正在处理流量。已锁定。
draining上一个版本,在流量切换到新版本期间处理完正在进行的调用。
archived过去的版本。可以用 playserv functions rollback 回滚到它。
failed · cancelled未上线。

删除操作会清除已归档、失败或已取消的部署。


版本标签

标签会在最新版本旁边再部署一个可单独访问的版本。 普通流量仍然发往不带标签的最新版本;调用方在请求中带上 X-Playserv-Function-Version: <tag> 即可访问带标签的版本。

未知标签会返回 404 function_version_not_found,不会回退到最新版本。在 Function 内部,处理本次调用的标签会出现在同一个 X-Playserv-Function-Version 请求头中(C# 中为 req.ServingVersion);由最新版本处理时则没有这个请求头。标签通过 CLI 的 --tag 部署,见使用 CLI 部署。

部署也可以通过 PlayServ API 或 MCP 提升到 prod。带标签的部署在目标 Environment 中保留原标签,不带标签的部署则成为那里新的最新版本。


按分支自动部署

向已绑定的 Git 分支推送,就能把你的 Function 部署到该分支对应的 Environment。 在 Project settings → Deployment 中绑定分支,并把 PlayServ 的 GitHub Action 添加到仓库;此后每次向已绑定分支推送,都会针对该 Environment 运行 playserv publish。

配置方法和 workflow 见 Deployment → Branch deploys。通过这种方式完成的部署和其他部署一样,会出现在 History 中。


日志

整个 Environment 的日志流。在左侧选择一个或多个 Function;每一行显示精确到毫秒的时间、级别、Function 和消息,同一次调用产生的日志行共享同一个 trace id。

控件选项
Time range最近 5 或 15 分钟、最近 1 小时、4 或 24 小时、7 天、今天、昨天、全部时间,或自定义范围。
Levelinfo · warn · error · debug
Search对消息进行全文搜索。
Live新日志行到达时实时输出。

历史记录

项目中涉及任意 Function 的每一次部署,按时间倒序排列:revision、哪个 Function、部署人、部署时间,以及构建耗时。可以用 Time range 筛选。目前 History 只显示 dev 中的部署。


下一步

更新于 2026年10月14日