Pular para o conteúdo principal
Versão: 0.4 · atual

Configurar a página de status pública

Guia de instruçõesRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Administrador de entidade
PlanosFree · Core · Pro · EnterpriseImplantaçãoAuto-hospedado

Cada entidade pode publicar uma página de status para pessoas sem conta: os clientes de uma empresa atendida, a equipe de uma filial, um parceiro. Ela responde a uma pergunta, o serviço que eu uso está funcionando?, com o nome, o logotipo e as cores da própria entidade. Este guia mostra como criar a página, montar os componentes, registrar incidentes e publicá-la.

Antes de começar​

  • Você precisa da função Entity admin (administrador de entidade) na entidade que a página representa.
  • A opção de recurso ui.public_status_page precisa estar ativada. Enquanto ela está desativada, a página não pode ser aberta e a tela informa isso; um superadministrador a ativa em Settings › Instance.
  • Decida o que os visitantes devem reconhecer: serviços como Portal do cliente ou Pagamentos com cartão, e não nomes de servidores.

O que os visitantes veem e o que nunca veem​

A página é montada campo a campo a partir de uma lista de permissões, nunca filtrando dados internos.

Na páginaNunca na página
O título, a introdução, o logotipo, o tema e a cor de destaqueNomes de recursos, nomes de host, tipos, marcas ou IDs
Os componentes com os nomes que você dá a eles, em grupos e na sua ordemVerificações, métricas, valores ou limites
O status de cada componente e a barra de disponibilidade de 90 dias deleAlertas, seus títulos, severidades ou contagens
Os incidentes que você registra, com cada atualização e o horário delaQuem registrou, quem é o responsável, qualquer coisa da caixa de entrada de alertas
A manutenção que você escolhe anunciar, com o título e a descrição públicosO motivo interno de uma janela de manutenção
Links para RSS, Atom e JSON Feed e um discreto link Sign inCaminhos de entidades, outras entidades ou o nome e o logotipo do produto

Criar a página​

  1. Abra Settings › Status page e escolha a entidade no seletor, por exemplo a Veredas Ltda..

  2. Selecione Create a status page for Veredas Ltda.. A página é criada como não publicada.

  3. Em Page, preencha as configurações:

    ConfiguraçãoObservações
    TitleTambém dá nome à guia do navegador e aos feeds
    IntroductionUm texto curto sob o título
    Logo addresshttps://… ou um caminho neste servidor, como /logos/ciguapa.svg. Quando está vazio, usa-se o logotipo do ramo, se houver; nunca o do produto
    ThemeQualquer um dos temas do console; Daylight por padrão
    Accent colourUma cor para links e anéis de foco, ou Use the theme's
    Time zone of the daily barsOnde cada dia das barras de disponibilidade começa e termina. Os horários de incidentes e de manutenções aparecem no fuso horário de cada visitante
    Own domainOpcional, como status.ciguapa.example; veja abaixo
  4. Selecione Save.

O Public address é https://<server>/status/<entity short name>. Open the public page o abre; Show preview o mostra aqui, publicado ou não.

Adicionar componentes​

Um componente é algo que os visitantes reconhecem. Ele acompanha recursos da entidade da página ou de entidades abaixo dela: um recurso inteiro ou uma única verificação de um recurso, quando apenas essa verificação importa para o serviço.

  1. Em Components, selecione Add a component.
  2. Informe o Name, por exemplo Pagamentos com cartão, e, opcionalmente, uma Description e um Group. Os componentes com o mesmo grupo são exibidos juntos.
  3. Em Follows, escolha um Resource e The whole resource ou uma Check, depois selecione Follow. Repita para cada recurso do qual o serviço depende.
  4. Mantenha Show the 90-day availability bar selecionado, a menos que uma porcentagem signifique pouco para este componente.
  5. Deixe Status shown em From what it follows.
  6. Selecione Save component.

Use as setas para mudar a ordem. A tela mostra, ao lado de cada componente, o que dizem os recursos que ele acompanha, o que facilita perceber um status manual desatualizado.

O que ele acompanha informaStatus do componente
Todos os recursos acompanhados estão íntegros; uma verificação com severidade de informação conta como íntegraOperational
Um está em avisoDegraded performance
Alguns estão em estado crítico ou inacessíveisPartial outage
Todos os que informam estão em estado críticoMajor outage
Todos estão em uma janela de manutençãoUnder maintenance
Nada informou aindaOperational na página, No data nas barras

Os recursos em manutenção não contam nem a favor nem contra: um nó de banco de dados em manutenção e o outro íntegro resultam em Operational. Um recurso silenciado conta pelo estado real das verificações dele, porque o silenciamento muda as notificações, não o serviço.

Para substituir o status manualmente, por exemplo por Major outage quando você sabe mais do que as verificações, escolha-o em Status shown. Depois, volte para From what it follows.

Publicar a página​

  1. Confira a página com Show preview.
  2. Em Page, selecione Published e, depois, Save.

Enquanto a página não está publicada, o endereço dela responde que a página não foi encontrada; a visualização prévia continua funcionando.

Registrar um incidente​

  1. Em Incidents, selecione Report an incident.
  2. Informe o Title, o Impact (No impact, Minor impact, Major impact ou Critical impact), os Affected components, o Status e uma primeira Message.
  3. Selecione Report. O incidente e a primeira atualização dele aparecem na página e nos feeds com o horário.
  4. À medida que souber mais, registre atualizações com Post update, cada uma com um status (Investigating, Identified, Monitoring ou Resolved) e uma mensagem.

Um incidente aberto eleva o status dos componentes que ele afeta, no mínimo, ao nível do impacto dele: o impacto menor leva a Degraded performance, o maior a Partial outage e o crítico a Major outage. Registrar Resolved o encerra; ele permanece em Past incidents por 30 dias.

Pela API, você também pode corrigir o texto de uma atualização anterior, mas não o horário nem o status dela, e registrar um incidente depois do fato, informando quando ele começou.

Anunciar uma manutenção​

Ao criar uma janela de manutenção, selecione Announce on the status page e informe um Public title e, opcionalmente, uma Public description; consulte Planejar uma janela de manutenção. A janela aparece na página de toda entidade cujos componentes acompanham recursos que ela abrange: em Maintenance enquanto está em andamento e, caso contrário, a próxima ocorrência dentro de 30 dias. Uma janela semanal informa que se repete, em vez de listar cada semana. Apenas o título e a descrição públicos são exibidos, nunca o motivo interno.

Servir a página no próprio domínio​

Para publicar a página como https://status.ciguapa.example/status/ciguapa:

  1. Aponte o DNS do nome para o servidor, com um registro CNAME ou A.
  2. Peça a um superadministrador que adicione o nome como alias em Settings › Server and certificates e, com um certificado do Let's Encrypt ou próprio, que o mantenha entre os nomes do certificado. Consulte Configurar nomes e TLS.
  3. Informe o nome em Own domain da página e selecione Save.

Os links na página e nos feeds passam a usar esse nome quando a página é aberta por ele. A raiz desse nome, https://status.ciguapa.example/, ainda abre a página de entrada do console, então compartilhe o endereço completo com /status/<short name>.

Definir a aparência de um ramo​

Settings › Branch appearance define um Default theme e um Logo address em uma entidade; todas as entidades abaixo dela os herdam até definirem os próprios. In effect mostra o resultado e de onde ele vem. Uma página de status sem logotipo próprio usa o da entidade dela. Nesta versão, o próprio console ainda não aplica o tema de um ramo; a escolha de tema de uma pessoa prevaleceria sobre ele de qualquer forma.

Disponibilidade​

Cada componente registra quanto tempo passou em cada status, por dia do fuso horário da página. Os dias com mudança de horário de verão têm 23 ou 25 horas. A barra mostra uma célula por dia, 90 em um computador, 60 em um tablet e 30 em um celular, colorida pelo pior status que durou um minuto ou mais naquele dia, com detalhes ao apontar, tocar ou mover o foco do teclado.

  • Disponibilidade diária = 1 − (interrupção grave + 0,3 × interrupção parcial) ÷ tempo conhecido. O desempenho degradado conta como disponível. A manutenção e No data ficam fora do tempo conhecido, então o trabalho planejado nunca reduz o valor.
  • A porcentagem principal usa a mesma fórmula ao longo de 90 dias. Um componente criado há pouco tempo mostra uptime since seguido do primeiro dia dele.
  • Um período com qualquer indisponibilidade mostra no máximo 99,99%, nunca 100%.
  • O histórico é mantido por 400 dias. Um novo fuso horário se aplica a novos dias; os dias já registrados mantêm os horários de início e de fim.

Feeds e cache​

A página tem links para três feeds com as atualizações de incidentes e as manutenções anunciadas: RSS 2.0, Atom 1.0 e JSON Feed 1.1, em /api/v1/status/<short name>/feed.rss, feed.atom e feed.json. Adicione ?lang=es para ter os rótulos em espanhol. As assinaturas por e-mail ainda não estão disponíveis.

Os endereços públicos não exigem entrada e são baratos de servir. A página responde com Cache-Control: public, max-age=30 e um ETag, e os feeds com max-age=300, de modo que uma CDN ou o proxy na frente pode armazená-los em cache como estão. As respostas trazem Access-Control-Allow-Origin: *, então outros sites podem ler o JSON.

Tirar a página do ar​

  • Para ocultá-la por um tempo, desmarque Published e salve. O endereço dela passa a responder, na mesma hora, que a página não foi encontrada.
  • Desativar a opção de recurso ui.public_status_page faz o mesmo para todas as páginas.
  • Delete the page a remove com os componentes, os incidentes e o histórico de disponibilidade. Não é possível desfazer.