Pular para o conteúdo principal
Engenharia

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.

IndicadorO que mostra
Functions liveFunctions que estão atendendo tráfego agora.
Replicas runningInstâncias em execução e em quantas regiões.
Invocations 24hChamadas nas últimas 24 horas.
Error rate 24hFração de chamadas com falha: within target até 1%, elevated acima de 1%, above threshold acima de 5%.
P95 latency 24hTempo 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.

StatusSignificado
livePublicada e atendendo tráfego.
stagedDeclarada, ainda sem código publicado.
failingO último build falhou, ou um secret que a Function declara não tem valor neste Environment.
disabledParada por um operador. Não aceita chamadas; o código e os dados continuam lá.
deletedRemovida 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

BlocoO que mostra
Status · Auth · Last invocationSe 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 rateRéplicas em execução em relação ao máximo e a política de escalonamento; chamadas e falhas nas últimas 24 horas.
VersionsO deploy mais recente e as version tags que atendem ao lado dele.
ReplicasCada 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.

ColunaVariáveis de ambiente
NameA variável, por exemplo LOG_LEVEL.
Effective valueO que a Function recebe de fato.
Manifest defaultO valor do platform.json; somente leitura aqui.
Override (this env)Um valor só para este Environment, editado na própria linha.
ColunaSecrets
NameO secret que a Function declara, por exemplo STRIPE_API_KEY.
Statuslinked quando tem valor neste Environment, missing quando ainda não foi definido. Um secret ausente deixa a Function em failing.
RotatedQuando 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çãoValoresPadrão
Memory tierLight 128 MB · Standard 256 MB · Heavy 512 MB · XL 1 GB · 2XL 2 GB—
TimeoutAté 3600 s por chamada60 s para uma cloud function, 3600 s para um Game server
Max concurrencyDe 1 a 1000 chamadas simultâneas por réplica80 para uma cloud function, 1000 para um Game server
Scalingmanual · N replicas ou auto · min–max; alterado com ScaleDo platform.json
Auth requirementplayer: 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.

StatusSignificado
queued · building · deployingEm andamento.
liveAtendendo tráfego. Bloqueado.
drainingA versão anterior, concluindo as chamadas em andamento enquanto o tráfego passa para a nova.
archivedUma versão anterior. Você pode voltar para ela com playserv functions rollback.
failed · cancelledNã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.

ControleOpçõ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.
Levelinfo · warn · error · debug
SearchBusca de texto completo nas mensagens.
LiveTransmite 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

Atualizado em 14 de out. de 2026