Esta página ainda não foi traduzida: mostrando a versão em inglês.
Functions
Em Functions você acompanha e opera o código do seu jogo que roda no servidor. A página mostra a saúde e as réplicas de cada Function, as variáveis de ambiente e os secrets, as configurações de runtime, o histórico de deploys e os logs. O código chega aqui pela PlayServ CLI; o Backoffice executa, configura e observa o que você publicou. A página mostra o Environment selecionado na barra superior.
Game servers em pool e auto-hospedados não aparecem aqui
Functions lista as cloud functions e os Game servers que a PlayServ executa no Cloud Run. Game servers em um pool de máquinas ou nas suas próprias máquinas não têm nada para publicar ou escalar aqui; eles ficam em Servers.
Overview
Uma linha de indicadores para o Environment inteiro.
| Indicador | O que mostra |
|---|---|
| Functions live | Functions que estão atendendo tráfego agora. |
| Replicas running | Instâncias em execução e em quantas regiões. |
| Invocations 24h | Chamadas nas últimas 24 horas. |
| Error rate 24h | Fração de chamadas com falha: within target até 1%, elevated acima de 1%, above threshold acima de 5%. |
| P95 latency 24h | Tempo de resposta no percentil 95: warning a partir de 200 ms, critical acima de 800 ms. |
A lista de Functions
Cada linha mostra a linguagem, o nome e o status da Function, as réplicas, as invocações e a taxa de erros em 24 horas, a latência P95 e quando foi feito o deploy, com qual revisão. Pesquise por nome, handler ou trigger e filtre por Status, Trigger e Runtime.
| Status | Significado |
|---|---|
| live | Publicada e atendendo tráfego. |
| staged | Declarada, ainda sem código publicado. |
| failing | O último build falhou, ou um secret que a Function declara não tem valor neste Environment. |
| disabled | Parada por um operador. Não aceita chamadas; o código e os dados continuam lá. |
| deleted | Removida do Environment. |
Novas Functions são criadas quando você faz o deploy delas com a CLI ou com um push para uma branch vinculada. O botão New function no Backoffice ainda está por vir. Para conectar um repositório, use Project settings → Deployment: o botão Connect repo desta página ainda mostra coming soon.
Uma Function
Clique em uma Function para abrir o painel dela. O cabeçalho mostra o nome, o trigger, quando foi feito o deploy e de qual revisão. O painel tem quatro abas, e o rodapé oferece Disable (ou Enable) e Delete.
Status
| Bloco | O que mostra |
|---|---|
| Status · Auth · Last invocation | Se a Function atende tráfego e desde quando; se quem chama precisa de um Player logado; se ela foi chamada recentemente. |
| Replicas · 24h invocations · 24h error rate | Réplicas em execução em relação ao máximo e a política de escalonamento; chamadas e falhas nas últimas 24 horas. |
| Versions | O deploy mais recente e as version tags que atendem ao lado dele. |
| Replicas | Cada réplica em execução, com a região e o uso de recursos. Selecione uma para ver At a glance: status e uptime, região, memória em relação ao limite, CPU média em 15 minutos, o deploy que ela executa e o último erro. Logo abaixo, um tail ao vivo dos logs dessa réplica. |
Scale abre a janela de escalonamento: uma política manual, com um número fixo de réplicas, ou auto, com um mínimo e um máximo. O Cloud Run substitui as instâncias de uma Function por conta própria, então não dá para reiniciar nem parar réplicas individuais.
O escalonamento definido aqui é redefinido no próximo deploy
No momento do deploy, vale a especificação de escalonamento do platform.json. Se os novos valores devem permanecer, altere-os lá também.
Bindings
Tudo o que é injetado na Function em tempo de execução.
| Coluna | Variáveis de ambiente |
|---|---|
| Name | A variável, por exemplo LOG_LEVEL. |
| Effective value | O que a Function recebe de fato. |
| Manifest default | O valor do platform.json; somente leitura aqui. |
| Override (this env) | Um valor só para este Environment, editado na própria linha. |
| Coluna | Secrets |
|---|---|
| Name | O secret que a Function declara, por exemplo STRIPE_API_KEY. |
| Status | linked quando tem valor neste Environment, missing quando ainda não foi definido. Um secret ausente deixa a Function em failing. |
| Rotated | Quando o valor mudou pela última vez. |
Rotate substitui o valor de um secret: cole o novo valor, e as Functions que o usam passam a recebê-lo. Os valores nunca são exibidos. A aba Bindings do projeto, no topo de Functions, mostra as variáveis de todas as Functions em uma única tabela, além de um card Secrets: ali, Add secret dá valor a um secret missing, e um secret que nenhuma Function usa mais pode ser excluído.
Settings
| Configuração | Valores | Padrão |
|---|---|---|
| Memory tier | Light 128 MB · Standard 256 MB · Heavy 512 MB · XL 1 GB · 2XL 2 GB | — |
| Timeout | Até 3600 s por chamada | 60 s para uma cloud function, 3600 s para um Game server |
| Max concurrency | De 1 a 1000 chamadas simultâneas por réplica | 80 para uma cloud function, 1000 para um Game server |
| Scaling | manual · N replicas ou auto · min–max; alterado com Scale | Do platform.json |
| Auth requirement | player: quem chama precisa ser um Player logado. none: não é preciso Player. | Do platform.json |
Em ambos os casos, toda chamada precisa de uma API key; quem pode chamar a Function é definido por execute no manifesto dela. Quem não tem permissão recebe 403 function_execute_forbidden, e uma chamada sem a sessão de Player exigida recebe 401 player_auth_required. As configurações são salvas sem novo deploy.
Deploys
Cada build desta Function, do mais recente para o mais antigo, com quando foi feito o deploy, a revisão, quem o fez e como foi o build. A lista é somente leitura: os deploys vêm da CLI.
| Status | Significado |
|---|---|
| queued · building · deploying | Em andamento. |
| live | Atendendo tráfego. Bloqueado. |
| draining | A versão anterior, concluindo as chamadas em andamento enquanto o tráfego passa para a nova. |
| archived | Uma versão anterior. Você pode voltar para ela com playserv functions rollback. |
| failed · cancelled | Não chegou a entrar no ar. |
A ação de excluir faz o purge de um deploy arquivado, com falha ou cancelado.
Version tags
Uma tag publica uma segunda versão, endereçável, ao lado da mais recente. O tráfego normal continua indo para a versão mais recente sem tag; para chegar à versão com tag, quem chama envia X-Playserv-Function-Version: <tag> na chamada.
Uma tag desconhecida falha com 404 function_version_not_found, em vez de cair na versão mais recente. Dentro da Function, a tag que atendeu a chamada chega no mesmo header de requisição X-Playserv-Function-Version (req.ServingVersion em C#); ele não vem quando quem atendeu foi a versão mais recente. As tags são publicadas com --tag na CLI; veja Deploy com a CLI.
Um deploy também pode ser promovido para prod pela API da PlayServ ou pelo MCP. Um deploy com tag mantém a tag no Environment de destino, e um sem tag passa a ser a nova versão mais recente dele.
Deploys automáticos por branch
Um push para uma branch Git vinculada pode fazer o deploy das suas Functions no Environment dessa branch. Vincule as branches em Project settings → Deployment e adicione a GitHub Action da PlayServ ao repositório; a partir daí, cada push para uma branch vinculada executa playserv publish para aquele Environment.
A configuração e o workflow estão em Deployment → Branch deploys. Os deploys feitos assim aparecem em History como qualquer outro.
Logs
Um fluxo de logs do Environment inteiro. Escolha uma ou mais Functions à esquerda; cada linha mostra o horário com milissegundos, o nível, a Function e a mensagem, e as linhas de uma mesma chamada compartilham um trace id.
| Controle | Opções |
|---|---|
| Time range | Últimos 5 ou 15 minutos, última hora, últimas 4 ou 24 horas, 7 dias, hoje, ontem, todo o período ou um intervalo personalizado. |
| Level | info · warn · error · debug |
| Search | Busca de texto completo nas mensagens. |
| Live | Transmite as novas linhas conforme chegam. |
History
Todos os deploys que afetaram qualquer Function do projeto, do mais recente para o mais antigo: a revisão, a Function, quem fez o deploy, quando e quanto tempo levou o build. Filtre com Time range. Por enquanto, History mostra apenas os deploys em dev.
Próximos passos
- Deploy com a CLI — crie, publique e marque Functions com tags
- Cloud Functions e RPC — chame uma Function a partir do seu jogo em Unity
- Interface de linha de comando — logs, rollback, escalonamento e secrets pelo terminal
- Servers — Game servers em pools de máquinas e nas suas próprias máquinas
Atualizado em 14 de out. de 2026