Banche dati
    Aggiornato il maggio 2026
    CouchDB logo

    CouchDB Monitoraggio

    Monitora in tempo reale la frequenza delle richieste a CouchDB, lo stato della replica, le operazioni sui documenti e le metriche di compattazione senza alcuna configurazione.

    Perché monitorare CouchDB?

    Apache CouchDB è un database NoSQL orientato ai documenti con replica multi-master. Il monitoraggio di CouchDB garantisce una replica efficiente, prestazioni ottimali nelle query e una compattazione tempestiva per il vostro livello di dati distribuito.

    Rilevamento automatico tramite Xitogent
    Monitoraggio del tasso di richieste HTTP
    Stato della replica e monitoraggio del lag
    Operazioni di lettura/scrittura di documenti
    Monitoraggio dell'avanzamento della compattazione
    Metriche di build degli indici delle viste
    Monitoraggio delle dimensioni del database
    Intervalli di raccolta di 1 minuto
    Soglie di alert personalizzabili per ogni metrica
    Intervalli di raccolta metriche a 1 minuto out of the box
    Cos’è il monitoring di CouchDB?

    Monitoring di CouchDB, spiegato

    Il monitoring di CouchDB intercetta i fallimenti dello scheduler di replication, gli arretrati di compaction di smoosh, lo sbilanciamento degli shard, lo stallo della build degli indici view e i picchi di errori HTTP prima che causino fallimenti di sync nei client PouchDB, corruzione dei documenti o timeout sulle query. Per app mobile/web offline-first, sync IoT edge e qualsiasi cluster CouchDB multi-master, la visibilità per nodo unita alla salute dei job di replication è ciò che separa un alert pulito a 60 secondi da giorni di caccia nei log di fabric. Xitoring rileva automaticamente il suo CouchDB, legge gli endpoint HTTP nativi e instrada gli alert verso Slack, PagerDuty, Telegram o il suo on-call esistente.

    Indicatori

    Ciò che monitoriamo

    Richieste/sec

    Tasso di richieste API HTTP.

    Letture di documenti

    Operazioni di lettura di documenti al secondo.

    Scritture di documenti

    Operazioni di scrittura di documenti al secondo.

    Stato della replica

    Stato delle attività di replica attive.

    Dimensione del database

    Dimensione di ogni database su disco.

    Stato della compattazione

    Indica se la compattazione è in corso.

    Database aperti / File OS aperti

    `couchdb.open_databases` e `couchdb.open_os_files`. Avvicinarsi al tetto dell’`ulimit -n` del sistema operativo causa fallimenti gravi — alzi insieme l’`ulimit` e il `[couchdb] max_dbs_open` di CouchDB.

    Avanzamento build degli indici view

    Da `/_active_tasks` (type=indexer): `changes_done`/`total_changes` per design document. Build lente o in stallo bloccano le query che dipendono da quelle view.

    Avanzamento compaction

    Da `/_active_tasks` (type=database_compaction / view_compaction): percentuale di avanzamento. Smoosh gestisce l’auto-compaction in 3.x — imposti un alert quando un task di compaction dura più del previsto per la dimensione del database.

    Fabric Read Repair

    `fabric.read_repairs.success`/`failure`. Riflette le inconsistenze tra shard riparate al volo durante le letture. Read repair persistenti segnalano un nodo fuori sync o uno shard danneggiato.

    Hit rate della shard cache

    `mem3.shard_cache.hit` / (`hit` + `miss`). La cache interna del cluster per il routing degli shard — un hit rate basso indica turnover (modifiche di membership) o pressione di memoria.

    Dimensione del database su disco

    Dimensione del file per database, tracciata nel tempo. Una crescita costante tra una compaction e l’altra è normale; picchi che non rientrano significano che la compaction non sta tenendo il passo del tasso di scrittura.

    Notifiche e avvisi

    Configurabile condizioni di attivazione

    Imposta dei trigger personalizzati nella tua dashboard per ricevere una notifica non appena le metriche dell{name}e superano le soglie da te definite.

    CouchDB pannello di controllo per la configurazione dei trigger di monitoraggio

    Lag della replica

    critico

    Si attiva quando la replica resta indietro.

    Tasso di richieste

    avviso

    Avvisa su pattern di richieste insoliti.

    Dimensione del database

    avviso

    Si attiva quando il database supera la soglia dimensionale.

    Compattazione

    avviso

    Si attiva quando la compattazione non è stata eseguita di recente.

    01

    Importanza del monitoraggio CouchDB

    La replica multi-master di CouchDB richiede monitoraggio per garantire coerenza dei dati e prestazioni.

    • Monitorare lo stato della replica tra cluster
    • Monitorare le operazioni sui documenti per le prestazioni
    • Rilevare la necessità di compattazione
    • Garantire la gestione delle dimensioni del database
    Monitoraggio CouchDB
    Analisi della replica
    02

    Perché scegliere Xitoring

    Monitoraggio CouchDB zero-config.

    • Installazione con un solo comando
    • Nodi globali
    • Dashboard unificata
    • Avvisi multicanale
    • Conservazione storica
    Panoramica
    Avvisi
    Casi d’uso

    Scenari comuni di monitoring per CouchDB

    Dove viene solitamente utilizzato CouchDB al giorno d'oggi — e cosa potrebbe andare storto se nessuno lo tenesse d'occhio.

    App mobili e da campo che funzionano offline

    Le app per i punti vendita al dettaglio, il settore sanitario e l'assistenza sul campo sincronizzano i propri dati con un server centrale ogni volta che sono online. Quando la sincronizzazione fallisce in modo invisibile, il personale continua a lavorare, ma l'ufficio prende decisioni basandosi su informazioni non aggiornate. Noi individuiamo l'errore nel momento stesso in cui si verifica, garantendo così l'affidabilità dei dati.

    Dati provenienti da dispositivi remoti

    I sensori e i dispositivi sul campo inviano i propri dati a un database centrale. Quando questo flusso si interrompe, i dati si accumulano nel dispositivo e finiscono per andare persi. Monitoriamo il flusso dall'inizio alla fine, in modo che qualsiasi blocco venga individuato prima che venga persa anche una sola lettura.

    Database ad alta disponibilità per applicazioni critiche

    Le applicazioni di produzione distribuiscono il proprio database su più server, in modo che un singolo guasto non ne causi l'interruzione. Tuttavia, sottili squilibri tra i server possono minare silenziosamente tale protezione. Noi li individuiamo tempestivamente, affinché la rete di sicurezza rimanga efficace proprio quando ne avete davvero bisogno.

    Prima di iniziare

    Prerequisiti per CouchDB

    Assicurati di avere tutto questo in posizione — la maggior parte delle installazioni dura 60 secondi una volta soddisfatte le condizioni.

    • CouchDB 2.x o 3.x in esecuzione
    • Credenziali admin con accesso agli endpoint /_node e /_stats
    • Raggiungibilità di rete da Xitogent verso l'API HTTP di CouchDB
    Guida all'installazione

    Inizia con verbali

    1

    Installa Xitogent sul tuo server

    Se non l'hai già fatto, installa il leggero agente di monitoraggio Xitogent sull'host che esegue CouchDB.

    curl -s https://xitoring.com/install.sh | sudo bash -s -- --key=YOUR_API_KEY
    2

    Esponi l'endpoint delle statistiche di CouchDB

    CouchDB fornisce statistiche server tramite la sua API HTTP all'indirizzo `/_node/_local/_stats` (porta 5984 predefinita). Assicurati che l'endpoint sia raggiungibile dall'host dell'agente e che l'utente configurato abbia accesso in lettura agli endpoint amministrativi.

    sudo xitogent integrate
    3

    Abilita l'integrazione CouchDB

    Usa la dashboard di Xitoring o la CLI per abilitare l'integrazione CouchDB. Xitogent rileva automaticamente il tuo nodo e inizia a raccogliere metriche di request, replicazione e archiviazione.

    4

    Configura le soglie di allerta (opzionale)

    Imposta soglie personalizzate per Replication Lag, request rate o dimensione del database per intercettare problemi di capacità e replicazione prima che diventino interruzioni.

    5

    Verifica che funzioni

    Esegui questo comando sul server per confermare che Xitogent ha rilevato l'integrazione. In circa 30 secondi nuove metriche cominceranno a comparire sulla tua dashboard.

    sudo xitogent status

    Spesso domande poste

    Quali versioni di CouchDB sono supportate?
    Xitoring supporta Apache CouchDB 2.x e 3.x. L'integrazione legge dai punti di accesso integrati di CouchDB /_node/_local/_stats e /_active_tasks, disponibili in tutte le versioni recenti.
    L'integrazione influirà sulle prestazioni di CouchDB?
    No. Xitogent raccoglie i dati statistici leggendo gli endpoint HTTP leggeri di CouchDB dedicati alle statistiche. Il sovraccarico è trascurabile: equivale a una singola chiamata API per ogni intervallo di raccolta.
    Monitora la replica di CouchDB?
    Sì. Xitoring monitora le attività di replica attive, il ritardo di replica e i numeri di sequenza dei documenti. Riceverai una notifica se la replica subisce un ritardo o si interrompe completamente, aiutandoti a mantenere la coerenza dei dati tra i nodi.
    È possibile monitorare più istanze di CouchDB su un unico server?
    Sì. Se si eseguono più istanze di CouchDB su porte diverse, Xitogent può essere configurato per monitorarle singolarmente, con raccolta delle metriche e soglie di allerta distinte per ciascuna di esse.
    Come funziona il monitoraggio della compattazione?
    Xitoring ha traccia dell'ultima volta in cui è stata eseguita la compattazione, delle dimensioni attuali dei file di database e delle attività di compattazione attive. È possibile impostare avvisi che si attivano quando i database superano una soglia prestabilita o quando la compattazione non è stata eseguita secondo la pianificazione prevista.
    Con quale frequenza vengono raccolti i dati?
    Per impostazione predefinita, i dati vengono raccolti a intervalli di 1 minuto. È possibile modificare questo intervallo tramite la dashboard di Xitoring o la CLI in base alle proprie esigenze di monitoraggio.
    Come monitoro il throughput di lettura/scrittura di CouchDB?
    Legga `couchdb.database_reads`/`database_writes` per il tasso di operazioni a livello di cluster, più `couchdb.document_inserts`/`writes` per il tasso a livello di documento. Confronti con `couchdb.httpd.requests` per ricavare lo split read/write. Per il breakdown per database, interroghi gli `_stats` di ciascun database (CouchDB 2.x) o legga la superficie metriche per database (CouchDB 3.x).
    Come rilevo uno sbilanciamento degli shard di CouchDB?
    Tre segnali: `mem3.shard_cache.miss` (alto miss rate = turnover o topologia di shard sbagliata), `fabric.read_repairs.success`/`failure` (repair in crescita = inconsistenze tra shard riparate durante le letture) e `couchdb.open_databases` per nodo (distribuzione disomogenea = serve un rebalance degli shard). Usi `/_membership` per confermare che tutti i nodi partecipino; ribilanci tramite `mem3:expand_clusters/0` se il numero di shard di un nodo è significativamente basso.
    Quali versioni di CouchDB sono supportate?
    Apache CouchDB 2.x e 3.x (3.3, 3.4, 3.5) sono pienamente supportati. La 3.4 ha aggiunto i covering index Mango keys-only (guadagno 10x sulla p95 per le query coperte); la 3.5 ha aggiunto la readiness probe di Clouseau. L’integrazione funziona anche con i deployment gestiti tramite la stessa API HTTP. Clouseau FTS (porta 5985) è trattato come sidecar separato — monitori `connected` per la sua salute.

    Inizia a monitorare CouchDB oggi

    Configurazione in meno di 60 secondi. Non è richiesta alcuna carta di credito. Statistiche complete fin dal primo giorno.

    Inizia la prova gratuita

    Continua a esplorare

    Correlati Integrazioni