Componentes e status

Componentes sao os servicos, sistemas ou partes de infraestrutura exibidos na sua status page. Cada componente tem um status que reflete sua saude atual.

Adicionando componentes

1. Abra as configuracoes da sua status page.
2. Navegue ate a aba Componentes.
3. Clique em Adicionar Componente.
4. Insira um nome (ex: "API Gateway", "Banco de Dados", "CDN").
5. Opcionalmente, agrupe componentes em categorias.

TIP

Agrupe componentes relacionados sob uma categoria pai. Por exemplo, agrupe "PostgreSQL Primario", "PostgreSQL Replica" e "Redis Cache" sob "Camada de Dados".

Niveis de status

Cada componente pode ter um de quatro niveis de status:

Status	Descricao	Cor
Operacional	O componente esta funcionando normalmente	Verde
Degradado	O componente esta parcialmente afetado, usuarios podem notar lentidao	Amarelo
Interrupcao Parcial	O componente esta fora do ar para um subconjunto de usuarios	Laranja
Interrupcao Total	O componente esta completamente indisponivel	Vermelho

Atualizando o status dos componentes

O status dos componentes pode ser atualizado de tres formas:

Atualizacao manual

1. Abra o componente nas configuracoes da sua status page.
2. Selecione o novo nivel de status.
3. Opcionalmente, adicione uma mensagem explicando a mudanca.
4. Salve.

Atualizacao automatica a partir de incidentes

Quando um incidente e transmitido para uma status page, o Batida pode definir automaticamente os componentes afetados com o status apropriado. Para habilitar isso, vincule componentes aos incidentes ao declara-los.

Atualizacao via API

PATCH /api/v1/status-pages/{page_id}/components/{component_id}
Authorization: Bearer <token>
Content-Type: application/json

{
  "status": "degraded",
  "message": "Latencia elevada devido ao aumento de trafego"
}

Grupos de componentes

Grupos de componentes permitem organizar servicos relacionados sob um unico cabecalho. O status do grupo e derivado automaticamente de seus filhos:

Status dos filhos	Status do grupo
Todos operacionais	Operacional
Alguns degradados, nenhum fora do ar	Degradado
Alguns com interrupcao parcial ou total	Interrupcao Parcial
Todos com interrupcao total	Interrupcao Total

Melhores praticas

• Mantenha a lista de componentes focada em servicos visiveis ao usuario. Infraestrutura interna que os usuarios nao podem observar nao precisa estar na status page.
• Atualize o status dos componentes prontamente quando um incidente comeca e quando e resolvido.
• Use mensagens descritivas para explicar mudancas de status. "Timeouts de queries no banco de dados" e mais util do que "Degradado."