> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Painel de observabilidade

> Monitore o volume de atestados, a saúde do serviço em 10 serviços de backend, percentis de latência e uso do plano no console.

O painel de observabilidade oferece uma visão em tempo real do seu ambiente Truthlocks diretamente no console. Use-o para rastrear a atividade de atestação, monitorar a saúde do serviço, identificar tendências de latência e verificar o uso do plano — tudo sem sair do navegador.

O painel está disponível em duas visualizações: um painel de **observabilidade da plataforma** para administradores de plataforma e um painel de **observabilidade do locatário** para usuários locatários.

> [!NOTE]
>
> O painel de observabilidade do inquilino está disponível nos planos **Business** e **Enterprise**. Se você estiver em um plano Gratuito ou Starter, verá um prompt de atualização ao navegar para o painel. O painel de observabilidade da plataforma está disponível para todos os administradores da plataforma. Consulte [faturamento](https://docs.truthlocks.com/pt/billing/overview.md) para detalhes do plano.

## Observabilidade da plataforma

Navegue até **Observabilidade** na barra lateral do console da plataforma. O painel apresenta desempenho de SLO, saúde do serviço, distribuição de erros e links de infraestrutura em nuvem em uma única página com gráficos interativos.

### Linha de KPI

Quatro cartões com detalhes de borda esquerda coloridos exibem métricas de alto nível:

| Cartão | Cor de destaque | O que ele mostra |
| :- | :- | :- |
| **Gateway** | Ciano | Status atual do gateway (por exemplo, "operacional") |
| **Serviços** | Verde | Serviços saudáveis do total (por exemplo, "9/10") |
| **Status do SLO** | Roxo | Crachá de status geral do SLO — verde, âmbar ou vermelho |
| **Erros Recentes** | Vermelho | Contagem de erros agrupados recentes |

### Desempenho de SLO

Quando os dados de SLO estão disponíveis, o painel exibe três visualizações:

#### Medidor de disponibilidade

Um medidor de barra radial mostrando a porcentagem de disponibilidade atual. O medidor é codificado por cores:

| Cor | Disponibilidade |
| :- | :- |
| Verde | 99,9% ou superior |
| Âmbar | 99.0% – 99.9% |
| Vermelho | Abaixo de 99,0% |

O orçamento de erro consumido é exibido abaixo do medidor.

#### Scorecards SLO

Dois placares mostram:

* **Disponibilidade** — a porcentagem atual em relação à meta de 99,9%.
* **Latência p99** — o pior tempo de resposta em relação ao alvo de 200 ms.

Cada scorecard é codificado por cores — verde quando dentro da meta, âmbar quando se aproxima do limite e vermelho quando a meta é violada.

#### Gráficos de tendência SLO

Dois gráficos de linha de sete dias mostram a tendência histórica de disponibilidade e latência p99. Uma linha de referência âmbar tracejada marca o alvo SLO em cada gráfico. Use-os para identificar se seus SLOs estão se aproximando ou se afastando do alvo.

### Saúde do serviço

A seção de serviços inclui três visualizações:

* **Donut de saúde do serviço** — um gráfico radial compacto mostrando a proporção de serviços saudáveis, degradados e desconhecidos.
* **Gráfico de latência do serviço** — um gráfico de barras horizontal mostrando o tempo de resposta de cada serviço em milissegundos. As barras são codificadas por cores de acordo com a latência (verde abaixo de 50 ms, ciano abaixo de 200 ms, âmbar abaixo de 500 ms, vermelho acima). Uma linha de referência tracejada em 200 ms marca o limite do SLA.
* **Cartões de detalhes do serviço** — cartões expansíveis para cada serviço de backend mostrando status, URL de destino, tempo de resposta com uma barra de progresso proporcional e links para logs e rastreamentos.

O painel da plataforma monitora os seguintes serviços:

| Serviço | Descrição |
| :- | :- |
| Gateway API | Ponto de extremidade principal da API para todas as solicitações de entrada |
| Registro de Confiança | Identidade, emissores, chaves e governança |
| Serviço de Atestado | Cunhagem e ciclo de vida de credenciais |
| Serviço de Assinatura | Gerenciamento e assinatura de chaves criptográficas |
| Log de Transparência | Árvore Merkle somente de adição à prova de adulteração |
| Serviço de Verificação | Verificação e validação de credenciais |
| Serviço de Auditoria | Trilha de auditoria à prova de adulteração com encadeamento de hash |
| Serviço de Faturamento | Medição de uso e gerenciamento de assinaturas |
| Identidade da Máquina | Registro de agente, sessões e pontuação de confiança |
| CMO de IA | Moderação e orquestração de conteúdo de IA |

Cada serviço exibe seu status atual (**saudável**, **degradado** ou **inativo**). Um serviço é marcado como **degradado** quando responde, mas leva mais de 2 segundos, e **inativo** quando não responde dentro do tempo limite de 5 segundos.

### Distribuição de erros

Um gráfico de barras detalha erros agrupados recentes por assinatura, codificados por cores para identificação rápida. Abaixo do gráfico, cada grupo de erros mostra sua contagem, origem e IDs de rastreamento de amostra. Links para CloudWatch Logs Insights e X-Ray Service Map são fornecidos quando disponíveis.

### Lançadores CloudWatch

Botões de inicialização rápida para suas ferramentas de monitoramento em nuvem — Painel, Métricas, Insights de Logs, X-Ray e Alarmes. Eles abrem diretamente em seu console AWS.

### Consulta de rastreamento

Insira um ID de rastreamento para obter um link direto para o AWS X-Ray (ou seu backend OTLP) para essa solicitação específica. Pressione Enter ou clique em **Pesquisar** para resolver o rastreamento.

### Atualização automática

O painel consulta todas as fontes de dados a cada 30 segundos. Ative ou desative a atualização automática no cabeçalho. Uma contagem regressiva mostra quando a próxima atualização ocorrerá. Clique em **Atualizar** a qualquer momento para buscar os dados mais recentes imediatamente.

## Observabilidade do inquilino

Navegue até **Observabilidade** na barra lateral do console do inquilino. O painel do inquilino é organizado em quatro abas com gráficos interativos.

### Abas do painel

| Aba | O que mostra |
| :- | :- |
| **Visão Geral** | Estatísticas de alto nível, medidores de desempenho, gráficos de ciclo de vida de atestados e um gráfico de tendência de latência |
| **Serviços** | Saúde por serviço, barras de conformidade SLA, porcentagens de tempo de atividade, detalhes de latência e uma tendência de latência de vários serviços |
| **Uso e Cotas** | Consumo de cunhagens, verificações, armazenamento e outros recursos medidos com um gráfico de barras horizontal |
| **Segurança** | Integridade criptográfica, isolamento de inquilinos e cartões de postura de trilha de auditoria com tabelas de controle detalhadas |

### Visão geral

A aba de visão geral exibe quatro cartões de estatísticas principais:

* **Total de atestados** — contagens ativas, revogadas e substituídas.
* **Emissores ativos** — quantos dos seus emissores são atualmente confiáveis.
* **Eventos de auditoria** — total de eventos registrados com integridade de cadeia de hash.
* **Saúde do sistema** — quantos serviços de backend estão saudáveis do total monitorado.

Abaixo dos cartões de estatísticas, três medidores de desempenho mostram:

* **Latência média** em todos os serviços.
* **Latência P95** — o pior tempo de resposta para o serviço mais lento.
* **Verificações de saúde realizadas** desde que a página foi aberta.

#### Gráfico do ciclo de vida da atestação

Um gráfico de rosca divide seus atestados totais em categorias **ativas** (verde), **revogadas** (vermelho) e **outras** (cinza). Um gráfico de barras complementar mostra os mesmos dados com contagens e porcentagens para cada categoria.

#### Gráfico de tendência de latência

Um gráfico de área sobrepõe os tempos de resposta para todos os serviços monitorizados sobre as verificações de saúde recentes. Cada serviço é codificado por cores com o seu próprio preenchimento gradiente. Uma legenda abaixo do gráfico identifica cada serviço. Os limiares de SLA são anotados: verde abaixo de 200 ms, amarelo abaixo de 500 ms, vermelho a 1000 ms ou acima.

### Serviços

A guia de serviços mostra a saúde de cada serviço de backend monitorado:

| Serviço | Descrição |
| :- | :- |
| Gateway API | Ponto de extremidade principal da API para todas as solicitações de entrada |
| Registro de Confiança | Identidade, emissores, chaves e governança |
| Serviço de Atestado | Cunhagem e ciclo de vida de credenciais |
| Serviço de Assinatura | Gerenciamento e assinatura de chaves criptográficas |
| Log de Transparência | Árvore Merkle somente de adição à prova de adulteração |
| Serviço de Verificação | Verificação e validação de credenciais |
| Serviço de Auditoria | Trilha de auditoria à prova de adulteração com encadeamento de hash |
| Serviço de Faturamento | Medição de uso e gerenciamento de assinaturas |
| Identidade da Máquina | Registro de agente, sessões e pontuação de confiança |
| CMO de IA | Moderação e orquestração de conteúdo de IA |

Cada serviço exibe seu status atual (**saudável**, **degradado** ou **inativo**), tempo de resposta e porcentagem de tempo de atividade da sessão. Uma barra de conformidade de SLA compara o tempo de atividade de cada serviço com a meta de 99,9%.

> [!NOTE]
>
> As porcentagens de tempo de atividade mostradas na guia de serviços são restritas à sessão — elas são redefinidas cada vez que você abre o painel. Para dados históricos de tempo de atividade, visite a [página de status pública](https://status.truthlocks.com) ou consulte a [API de status](https://docs.truthlocks.com/pt/ops/health.md#programmatic-status-api).

### Uso e cotas

A guia de uso exibe um gráfico de barras horizontal mostrando o consumo de cada recurso medido como uma porcentagem do limite do seu plano. As barras são codificadas por cores:

| Cor | Nível de uso |
| :- | :- |
| Ciano | Normal (abaixo de 80%) |
| Âmbar | Alto (80% ou superior) |
| Vermelho | No limite (100%) |

Medidores sem uma cota configurada são listados separadamente abaixo do gráfico. Passe o mouse sobre qualquer barra para ver a contagem e o limite exatos.

> [!TIP]
>
> Se um medidor de uso estiver se aproximando do limite, considere atualizar seu plano ou entrar em contato com o suporte para uma cota personalizada. Uma vez atingido o limite, as solicitações de API para essa operação retornam HTTP 402. Consulte [limites de taxa](https://docs.truthlocks.com/pt/ops/limits.md) para detalhes.

### Segurança

A guia de segurança oferece uma visão em tempo real da postura de segurança do seu ambiente em três dimensões. Na parte superior, três cartões de postura resumem a força geral:

| Cartão de postura | O que ele mede |
| :- | :- |
| **Integridade criptográfica** | Assinaturas Ed25519, hash de auditoria SHA-256 e transparência da árvore Merkle. |
| **Isolamento de inquilino** | Segurança em nível de linha PostgreSQL, chaves por inquilino e aplicação em nível de gateway. |
| **Trilha de auditoria** | Contagem de eventos encadeados por hash com status de verificação de integridade. Mostra "Atenção" até que seu primeiro evento de auditoria seja registrado. |

Abaixo dos cartões de postura, os controles de segurança individuais são agrupados em três categorias:

#### Controles criptográficos

| Controle | Algoritmo | Descrição |
| :- | :- | :- |
| Assinatura de atestado | Ed25519 (EdDSA) | Cada atestado é assinado criptograficamente com uma chave Ed25519. |
| Cadeia de hash de auditoria | SHA-256 | Os eventos de auditoria são encadeados com hashes SHA-256 para que a adulteração seja detectável. |
| Autenticação / JWKS | ES256 (ECDSA P-256) | Os tokens JWT e as chaves JWKS usam ES256 para autenticação. |
| Log de transparência | Árvore Merkle / SHA-256 | Uma árvore Merkle à prova de adulteração oferece auditabilidade pública. |

#### Controles de acesso

| Controle | Mecanismo | Descrição |
| :- | :- | :- |
| Segurança em nível de linha | PostgreSQL RLS | Todas as tabelas do banco de dados impõem isolamento de locatário em nível de linha. |
| RBAC | Controle de acesso baseado em função | Permissões granulares com escopo para suas funções definidas. |
| Gateway API | nginx + limitação de taxa | Limites de taxa por IP e por inquilino aplicados no gateway. |
| Autenticação de serviço | Chaves de serviço internas | A comunicação serviço a serviço é autenticada com chaves compartilhadas. |

#### Controles de proteção de dados

| Controle | Mecanismo | Descrição |
| :- | :- | :- |
| Isolamento de inquilinos | RLS multi-inquilino | Segregação completa de dados entre inquilinos no nível do banco de dados. |
| Imutabilidade da auditoria | Somente anexar + cadeia de hash | Os eventos não podem ser excluídos ou modificados após a criação. Mostra "Atenção" até que seu primeiro evento seja registrado. |
| Rotação de chaves | Ciclo de vida da chave por emissor | As chaves podem ser rotacionadas e substituídas sem perder atestados históricos. |

Cada controle mostra um selo **Aplicado** quando ativo ou um selo **Atenção** quando requer ação (por exemplo, se nenhum evento de auditoria foi registrado ainda).

## Gráficos do painel do inquilino

O painel principal do locatário (página **Início** na barra lateral do console) inclui três gráficos de insights de atestação quando você tem pelo menos uma atestação:

| Gráfico | Tipo | O que ele mostra |
| :- | :- | :- |
| **Status de atestado** | Donut (pizza) | Detalhamento de atestados ativos, revogados e outros com uma legenda codificada por cores |
| **Cobertura do emissor** | Gráfico de barras | Emissores ativos versus total de emissores configurados |
| **Saúde da plataforma** | Medidor radial | Porcentagem de atestados que estão atualmente ativos, exibidos como um medidor de semicírculo |

Esses gráficos fornecem um resumo visual rápido da saúde do seu portfólio de atestados sem precisar navegar até o painel completo de observabilidade.

## Monitoramento programático

Para dados de saúde legíveis por máquina fora da consola, use a [API de status](https://docs.truthlocks.com/pt/ops/health.md#programmatic-status-api) ou o [endpoint de uso de faturamento](https://docs.truthlocks.com/pt/api-reference/billing/usage.md). Esses endpoints permitem integrar métricas do Truthlocks em seus próprios painéis ou pipelines de alerta.

## Próximos passos

> [card] [Saúde e prontidão](https://docs.truthlocks.com/ops/health.md)
>
> Endpoints de saúde, página de status e integrações de monitoramento.

> [card] [Uso de faturamento](https://docs.truthlocks.com/api-reference/billing/usage.md)
>
> Rastreie cunhagens, verificações e armazenamento via API.

> [card] [Limites de taxa](https://docs.truthlocks.com/ops/limits.md)
>
> Planeje cotas e como lidar com respostas 429 e 402.

> [card] [Registros de auditoria](https://docs.truthlocks.com/security/audit.md)
>
> Consulte e exporte seu registro de auditoria.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.