Métricas e Insights do MariaDB

O painel de métricas reúne o uso de recursos e um snapshot das métricas nativas de cada instância MariaDB. Compare conexões, atividade e armazenamento para entender mudanças de carga sem tratar um único campo como diagnóstico definitivo.

Acessando as métricas

No menu lateral, clique em Projetos.
Abra o banco MariaDB desejado.
Vá para a área de métricas do projeto.
Se houver mais de uma instância ou réplica, selecione a que deseja analisar.

Grupos de métricas nativas

Grupo	O que mostra	Como interpretar
Saúde	estado da amostra e tempo de atividade atual	O tempo de atividade descreve a instância atual; não representa SLA nem histórico de disponibilidade.
Conexões e threads	conexões atuais, limite, utilização, conexões interrompidas, threads conectadas e threads em execução	Threads conectadas representam sessões abertas. Threads em execução são as que estão trabalhando naquele momento e não equivalem ao total de conexões.
Atividade	total de queries e operações de cliente, queries por segundo, bytes recebidos/enviados por segundo e consultas lentas	Totais são contadores acumulados; campos por segundo são taxas entre amostras. Nenhum deles inclui texto ou parâmetros de consultas.
Cache de leitura	tamanho, dados, espaço livre, páginas sujas, leituras físicas/lógicas e razão de acertos do buffer pool	Mede o cache interno do MariaDB. Não mede o cache do sistema operacional. A razão só existe quando há dados suficientes.
Redo e I/O	escritas de log, esperas de log, sincronizações e taxa de I/O, quando disponíveis	A disponibilidade varia conforme a capacidade da instância; valores ausentes permanecem `null`.
Locks	esperas atuais, total e tempo de esperas de linha e deadlocks	Aumento persistente pode indicar contenção. O snapshot não identifica sessões, usuários ou consultas.
Latência	latência média agregada, quando disponível	Não inclui texto, agrupamentos ou identificadores de consultas e não oferece percentis não coletados.
Armazenamento	tamanho agregado do banco e uso/capacidade de armazenamento do projeto	O tamanho do banco pode ficar indisponível sem afetar as métricas de recurso. Não há detalhamento por tabela.
Replicação	estado, réplicas disponíveis e esperadas e atraso em segundos	Os campos aparecem somente quando a configuração oferece essa informação.

Threads conectadas e em execução

Esses campos respondem a perguntas diferentes:

threads_connected: quantas sessões estão conectadas, incluindo as que aguardam trabalho;
threads_running: quantas threads estão executando trabalho no momento da amostra.

Uma quantidade alta de threads conectadas com poucas threads em execução pode ser normal para aplicações que mantêm conexões abertas. Analise também utilização, limite e atividade antes de tomar uma decisão.

Valores atuais, contadores e taxas

Valor atual: representa o estado da amostra, como threads em execução ou utilização de conexões.
Contador: acumula eventos desde o último reinício ou reset e termina em _total, como queries_total.
Taxa: representa a variação entre duas amostras válidas e termina em _per_second, como bytes_sent_per_second.
Razão: é uma fração entre 0 e 1; o Console pode apresentá-la como percentual.

Depois de um reinício ou reset de contador, a taxa relacionada fica Não disponível até existirem duas amostras válidas. A Zenifra não apresenta uma taxa negativa nem transforma um valor ausente em zero.

Unidades

Sufixo ou campo	Unidade
`_bytes` e `_bytes_total`	bytes inteiros
`_per_second`	unidades por segundo; campos com `_bytes_per_second` usam bytes por segundo
`_ms` e `_ms_total`	milissegundos
`_seconds`	segundos
`_ratio`	fração de `0` a `1`
CPU	núcleos de CPU
Memória	bytes

Última coleta e disponibilidade

Cada snapshot informa dois horários:

observed_at: quando os valores foram observados na instância;
collected_at: quando o snapshot ficou disponível para consulta.

O Console usa Última coleta para mostrar a idade dos dados. O estado de disponibilidade esclarece a qualidade do snapshot:

Estado	Significado
Disponível (`available`)	a amostra foi concluída e os grupos esperados foram avaliados; campos condicionais ainda podem ser `null`.
Parcial (`partial`)	apenas parte dos grupos ou campos pôde ser obtida.
Desatualizada (`stale`)	uma amostra válida anterior é exibida com o horário original; ela não representa o estado atual.
Não disponível (`unavailable`)	não há uma amostra válida para apresentar no momento.

Um campo null significa que o valor não é suportado, não foi observado ou não pôde ser calculado. Não interprete null como zero.

Snapshot, não histórico

As métricas nativas representam a leitura mais recente por instância. A capacidade atual retorna history: null: ela não oferece retenção de séries nem gráficos históricos. Contadores podem refletir atividade acumulada da própria instância, mas isso não transforma os snapshots da Zenifra em histórico consultável.

Para integrações, consulte primeiro as capacidades e o contrato de métricas. Os endpoints públicos permanecem:

GET /v1/project/{id}/metrics/capabilities
GET /v1/project/{id}/metrics?instance={instance}