Operação e monitoramento
Leia a saúde, os recursos, o uso e os logs do seu ambiente, aja nos serviços dele, altere as variáveis e entre como o primeiro administrador.
Tudo sobre o ambiente em execução fica em Ambiente, em quatro visões: Painel, Serviços, Monitoramento e Configuração. O endereço guarda a visão em que você está, então um link para ela abre a mesma visão, e o Guia do ambiente, no topo da página, explica cada parte na própria tela.
Saúde, recursos, logs e variáveis são lidos na hora, do provedor de hospedagem e do próprio ambiente, a cada visita, nunca de uma cópia guardada.
Quem pode fazer o quê
| Quem | O que pode fazer |
|---|---|
| Proprietário ou administrador da conta | Tudo na página: reiniciar o ambiente, agir nos serviços, salvar variáveis, alterar o domínio, recriar ou remover o ambiente e revelar uma vez as credenciais de primeiro acesso. |
| Membros da equipe que podem ler a conta | Ler a página: saúde, serviços, recursos, uso, logs, variáveis e domínio. |
| Operador da plataforma | Todas as ações em qualquer ambiente, mesmo antes de ele ficar pronto, inclusive retomar um provisionamento que falhou. Nunca as credenciais de primeiro acesso. |
O dono só opera o ambiente enquanto ele está Pronto. Toda alteração feita aqui entra na trilha de auditoria da conta com quem a fez; os valores enviados, como as variáveis, não são registrados. Veja Auditoria e insights.
Painel
O painel resume o ambiente em blocos, e cada bloco abre a visão que o detalha.
| Bloco | O que mostra |
|---|---|
| Ambiente | O nome e a versão, os endereços do console e da API, o usuário para entrar, o e-mail do administrador, e quando ele foi criado e ficou pronto. |
| Saúde | A leitura geral, atualizada a cada 30 segundos a partir da verificação de saúde da própria API, com o código de status que ela respondeu e quanto tempo levou. |
| Serviços rodando | Quantos dos quatro serviços estão rodando. |
| Erros da API | Os erros entre as últimas 100 linhas que a API registrou. Abre os logs filtrados por erro. |
| Primeiro acesso | Revela uma vez as credenciais do primeiro administrador. Veja Primeiro administrador. |
| CPU e memória | O que os serviços usam agora em relação ao que podem usar. Os mostradores passam para alerta a partir de 80% e para crítico a partir de 95%. |
| Rede e disco | O tráfego de entrada e de saída no período escolhido, e o disco que o banco de dados e o cache usam. |
| Cada serviço | Como está o último deploy dele, a CPU e a memória, e quando foi feito o deploy. Abre no painel lateral com as ações. |
| Uso | Realms, clients, usuários, pessoas que entraram, logins e a taxa de sucesso deles nos últimos 7 dias. |
Saúde
| Leitura | O que significa |
|---|---|
| Saudável | Todos os serviços estão implantados e a API responde à verificação de saúde. |
| Degradado | A API responde, mas algum serviço não está num deploy em execução. |
| Indisponível | A API não responde, ou o deploy dela falhou. |
| Desconhecido | O ambiente ainda não está rodando, então não há o que medir. |
Serviços e deploys
Serviços lista a API, o console, o banco de dados e o cache, cada um com os últimos deploys e o status deles. Toda ação pede confirmação antes e diz o que vai acontecer.
| Ação | O que faz |
|---|---|
| Reiniciar | Reinicia o deploy em execução com o mesmo build, os mesmos dados e as mesmas configurações. O serviço para de responder por um instante. Tente primeiro quando um serviço se comportar mal. |
| Refazer deploy | Faz um novo deploy com a imagem e as configurações atuais, que assume no lugar do anterior assim que estiver no ar, em poucos minutos. Num serviço parado, a ação aparece como Iniciar. |
| Parar | Para o deploy em execução até o serviço ser iniciado de novo. Os dados e as configurações dele são mantidos. |
| Cancelar deploy | Só aparece enquanto um deploy ainda está sendo compilado ou implantado. O deploy que rodava antes dele, se havia algum, continua respondendo. |
Reiniciar ambiente, no topo da página, refaz o deploy da API e do console juntos, com os mesmos dados e configurações.
Monitoramento
Recursos
CPU, memória, rede de entrada e de saída e disco de cada serviço, como o provedor de hospedagem mede. Escolha a última hora (uma leitura por minuto), as últimas 24 horas (uma leitura a cada 15 minutos) ou os últimos 7 dias (uma leitura por hora).
Uso
O uso é contado pelo próprio ambiente, em 7 ou 30 dias: realms, clients e usuários como estão agora, logins com a taxa de sucesso e o número de pessoas que entraram, logins por dia (UTC), e os realms e grant types mais usados. Quando não dá para ler o uso, a página diz por quê em vez de mostrar zeros:
| Mensagem | Por quê |
|---|---|
| O uso ainda não está disponível | O ambiente ainda não está pronto. |
| O relatório de uso começa depois da próxima atualização | O ambiente foi criado antes de existir o relatório de uso. |
| O seu ambiente não respondeu | O ambiente não respondeu desta vez. Tente de novo daqui a pouco. |
| O seu ambiente roda uma versão sem relatório de uso | A versão que ele roda não informa o uso. |
Logs
Escolha o serviço e quantas das últimas linhas ler — 50, 100, 250 ou 500, das mais novas para as mais antigas — e filtre por texto, por período ou por severidade. As linhas vêm do último deploy do serviço. Uma linha abre inteira no painel lateral, onde pode ser copiada.
Variáveis de configuração
Configuração → Variáveis reúne as configurações que cabe a você alterar. O resto — strings de conexão, chaves, endereços — é administrado pela plataforma, e um pedido para alterá-lo é recusado com DedicatedVariableNotEditable.
| Grupo | Variáveis | O que definem |
|---|---|---|
EMAIL_FROM_NAME, EMAIL_FROM_ADDRESS | O nome e o endereço de onde os e-mails saem. | |
EMAIL_SMTP_HOST, EMAIL_SMTP_PORT, EMAIL_SMTP_USERNAME, EMAIL_SMTP_PASSWORD, EMAIL_SMTP_ENABLESSL | O seu próprio servidor SMTP. | |
EMAIL_MAILERSEND_APIKEY | Uma chave do MailerSend. Enquanto ela estiver definida, o e-mail sai pelo MailerSend em vez do SMTP. | |
| Mensageria | SERVICEBUS_CONNECTION_STRING | Um namespace do Azure Service Bus para o trabalho em segundo plano. Opcional: sem ele, a própria API entrega e-mails e eventos. |
| Notificações push | FIREBASE_SERVICE_ACCOUNT | O JSON da conta de serviço do Firebase com que as aprovações push são enviadas. Sem ele, as aprovações push falham; os outros passos de login funcionam. |
| Consultor de IA | ANTHROPIC_API_KEY | A chave com que o consultor de IA chama o Claude. Sem ela, o consultor se informa indisponível. |
- As variáveis são salvas juntas com Salvar e refazer o deploy, que refaz o deploy da API — todas as variáveis acima ficam nela — em poucos minutos. Salve quando uma interrupção curta for aceitável.
- Um segredo — a senha SMTP e todas as chaves acima — só informa se está definido; o valor nunca mais é mostrado. Digitar um valor substitui o atual, deixar o campo em branco mantém, e Remover apaga ao salvar.
- As variáveis só podem ser alteradas enquanto o ambiente está pronto.
Levar o e-mail para o seu próprio servidor está descrito passo a passo em Enviando pelo seu próprio e-mail.
Primeiro administrador
O console do seu ambiente não tem cadastro público. Ele começa com um administrador, criado no primeiro deploy do ambiente, que cria os realms, os clients e os usuários e convida o resto da equipe.
Revele as credenciais
Quando o ambiente estiver pronto, escolha Revelar credenciais no bloco Primeiro acesso do painel. Só um proprietário ou administrador da conta pode fazer isso, no próprio ambiente.
Copie a senha
O usuário, o e-mail e a senha são mostrados uma única vez. Sair da página esconde a senha de vez: o Authio deixa de guardá-la, para você e para qualquer outra pessoa da conta.
Entre pelo usuário
Abra o endereço do console e entre com o usuário —
admin, a menos que a plataforma tenha escolhido outro —, não com o e-mail. O e-mail é o endereço do dono da conta, para onde vão as redefinições de senha.Troque a senha
No console do seu ambiente, abra realm
authio→ Usuários, edite o seu usuário e defina uma senha nova.
authio também renovam a senha por um link enviado por e-mail quando ela expira, no máximo a cada 90 dias, então mantenha o ambiente capaz de enviar e-mail.