Bases de datos
    Actualizado mayo de 2026
    CouchDB logo

    CouchDB Seguimiento

    Supervisa en tiempo real las tasas de solicitudes de CouchDB, el estado de la replicación, las operaciones con documentos y las métricas de compactación sin necesidad de configuración.

    Empieza tu prueba gratuitaVer documentos

    ¿Por qué realizar un seguimiento? CouchDB?

    Apache CouchDB es una base de datos NoSQL orientada a documentos con replicación multimaster. La supervisión de CouchDB garantiza una replicación correcta, un rendimiento óptimo de las consultas y una compactación oportuna para tu capa de datos distribuida.

    Detección automática mediante Xitogent
    Monitorización de la tasa de solicitudes HTTP
    Estado de replicación y seguimiento del lag
    Operaciones de lectura/escritura de documentos
    Monitorización del progreso de compactación
    Métricas de construcción de índices de vistas
    Seguimiento del tamaño de las bases de datos
    Intervalos de recolección de 1 minuto
    Umbrales de alerta personalizables para cada métrica
    Intervalos de recopilación de métricas de 1 minuto listos para usar
    ¿Qué es el monitoreo de CouchDB?

    Monitoreo de CouchDB, explicado

    El monitoreo de CouchDB detecta fallos del programador de replicación, retrasos en la compactación smoosh, desequilibrios de shards, atascos en la construcción de índices de vistas y picos de errores HTTP antes de que provoquen fallos de sincronización en clientes PouchDB, corrupción de documentos o timeouts de consultas. Para aplicaciones móviles/web offline-first, sincronización IoT en el borde y cualquier clúster CouchDB multi-master, la visibilidad por nodo más la salud de los trabajos de replicación es lo que diferencia una alerta limpia de 60 segundos de una persecución de varios días a través de los logs de fabric. Xitoring detecta automáticamente su CouchDB, lee los endpoints HTTP nativos y envía las alertas a Slack, PagerDuty, Telegram o su sistema de guardias existente.

    Métricas

    Lo que monitorizamos

    Solicitudes/s

    Tasa de solicitudes a la API HTTP.

    Lecturas de documentos

    Operaciones de lectura de documentos por segundo.

    Escrituras de documentos

    Operaciones de escritura de documentos por segundo.

    Estado de replicación

    Estado de las tareas de replicación activas.

    Tamaño de la base de datos

    Tamaño de cada base de datos en disco.

    Estado de compactación

    Indica si la compactación está ejecutándose.

    Bases de datos abiertas / Archivos del SO abiertos

    `couchdb.open_databases` y `couchdb.open_os_files`. Acercarse al techo del `ulimit -n` del SO provoca fallos graves: aumente tanto `ulimit` como `[couchdb] max_dbs_open` de CouchDB de forma conjunta.

    Progreso de construcción de índices de vistas

    Desde `/_active_tasks` (type=indexer): `changes_done`/`total_changes` por documento de diseño. Las construcciones lentas o atascadas bloquean las consultas que dependen de esas vistas.

    Progreso de compactación

    Desde `/_active_tasks` (type=database_compaction / view_compaction): porcentaje de progreso. Smoosh gestiona la autocompactación en la 3.x; alerte cuando una tarea de compactación se prolongue más de lo esperado para el tamaño de la base de datos.

    Reparaciones de lectura de fabric

    `fabric.read_repairs.success`/`failure`. Refleja la inconsistencia de shards que se corrige sobre la marcha durante las lecturas. Reparaciones de lectura sostenidas señalan un nodo desincronizado o un shard defectuoso.

    Tasa de aciertos de caché de shards

    `mem3.shard_cache.hit` / (`hit` + `miss`). La caché interna del clúster para el enrutamiento de shards: una tasa de aciertos baja indica rotación (cambios de pertenencia) o presión de memoria.

    Tamaño de la base de datos en disco

    Tamaño del archivo por base de datos, rastreado en el tiempo. Un crecimiento estable entre compactaciones es normal; un pico que no se recupera significa que la compactación no está al ritmo de la tasa de escrituras.

    Desencadenantes y alertas

    Configurables condiciones de activación de alertas

    Configura alertas personalizadas en tu panel de control para recibir una notificación en cuanto las métricas de «CouchDB» superen los umbrales que hayas definido.

    CouchDB panel de control de la configuración de los desencadenantes de supervisión

    Lag de replicación

    crítico

    Se dispara cuando la replicación se retrasa.

    Tasa de solicitudes

    advertencia

    Alerta sobre patrones de solicitudes inusuales.

    Tamaño de la base de datos

    advertencia

    Se activa cuando la base de datos supera el umbral de tamaño.

    Compactación

    advertencia

    Se dispara cuando la compactación no se ha ejecutado recientemente.

    01

    Importancia de monitorización de CouchDB

    La replicación multimaestro de CouchDB requiere monitorización para garantizar la consistencia de los datos y el rendimiento.

    • Monitorizar la salud de la replicación entre clústeres
    • Monitorizar las operaciones sobre documentos para el rendimiento
    • Detectar las necesidades de compactación
    • Garantizar la gestión del tamaño de la base de datos
    Monitorización de CouchDB
    Analítica de replicación
    02

    Por qué elegir Xitoring

    Monitorización CouchDB sin configuración.

    • Instalación con un solo comando
    • Nodos globales
    • Panel unificado
    • Alertas multicanal
    • Retención histórica
    Vista general
    Alertas
    Casos de uso

    Escenarios habituales de monitoreo de CouchDB

    Dónde suele ejecutarse CouchDB hoy en día — y qué podría salir mal si nadie está vigilando.

    Aplicaciones móviles y de campo que funcionan sin conexión

    Las aplicaciones de punto de venta minorista, atención médica y servicio de campo sincronizan sus datos con un servidor central cada vez que están en línea. Cuando esa sincronización falla silenciosamente, el personal sigue trabajando — pero la oficina toma decisiones basándose en información obsoleta. Detectamos el fallo en el momento en que comienza para que los datos sigan siendo fiables.

    Datos que fluyen desde dispositivos remotos

    Los sensores y dispositivos en el campo envían sus lecturas a una base de datos central. Cuando esa tubería se atasca, los datos se acumulan en el dispositivo y eventualmente se pierden. Vigilamos el flujo de principio a fin para que cualquier bloqueo sea detectado antes de que se pierda una sola lectura.

    Base de datos de alta disponibilidad para aplicaciones críticas

    Las aplicaciones de producción distribuyen su base de datos en varios servidores para que un solo fallo no las derribe. Pero los desequilibrios sutiles entre servidores pueden erosionar silenciosamente esa protección. Los detectamos temprano para que la red de seguridad siga siendo efectiva cuando realmente la necesites.

    Antes de empezar

    Requisitos previos para CouchDB

    Asegúrate de tener todo esto en su sitio — la mayoría de las instalaciones tardan 60 segundos una vez listo.

    • CouchDB 2.x o 3.x en ejecución
    • Credenciales de admin con acceso a los endpoints /_node y /_stats
    • Conectividad de red desde Xitogent hacia la API HTTP de CouchDB
    Guía de configuración

    Empieza con minutos

    1

    Instalar Xitogent en tu servidor

    Si aún no lo has hecho, instala el agente de monitorización ligero Xitogent en el host que ejecuta CouchDB.

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

    Exponer el endpoint de estadísticas de CouchDB

    CouchDB sirve estadísticas del servidor a través de su API HTTP en `/_node/_local/_stats` (puerto 5984 por defecto). Asegúrate de que el endpoint es accesible desde el host del agente y de que el usuario configurado tiene acceso de lectura a los endpoints administrativos.

    sudo xitogent integrate
    3

    Habilitar la integración de CouchDB

    Usa el panel de Xitoring o la CLI para habilitar la integración de CouchDB. Xitogent detecta automáticamente tu nodo y comienza a recolectar métricas de requests, replicación y almacenamiento.

    4

    Configurar umbrales de alerta (opcional)

    Define umbrales personalizados para retraso de replicación, tasa de requests o tamaño de la base de datos para detectar problemas de capacidad y replicación antes de que se conviertan en caídas.

    5

    Verifica que funciona

    Ejecuta este comando en el servidor para confirmar que Xitogent ha detectado la integración. En unos 30 segundos comenzarán a llegar métricas nuevas a tu panel.

    sudo xitogent status
    Comparar

    ¿Estás considerando alternativas?

    Mira cómo se compara Xitoring frente a las alternativas para la supervisión de CouchDB: precios planos, integraciones más profundas y un solo agente que cubre todo tu stack.

    Ver todas las comparaciones

    Con frecuencia preguntas formuladas

    ¿Qué versiones de CouchDB son compatibles?
    Xitoring es compatible con Apache CouchDB 2.x y 3.x. La integración lee los puntos de conexión integrados de CouchDB /_node/_local/_stats y /_active_tasks, que están disponibles en todas las versiones recientes.
    ¿Afectará la integración al rendimiento de CouchDB?
    No. Xitogent recopila métricas mediante la lectura de los puntos finales de estadísticas HTTP ligeros de CouchDB. La sobrecarga es insignificante: equivale a una sola llamada a la API por intervalo de recopilación.
    ¿Supervisa la replicación de CouchDB?
    Sí. Xitoring realiza un seguimiento de las tareas de replicación activas, el retraso en la replicación y los números de secuencia de los documentos. Se le avisará si la replicación se retrasa o se detiene por completo, lo que le ayudará a mantener la coherencia de los datos entre los distintos nodos.
    ¿Puedo supervisar varias instancias de CouchDB en un mismo servidor?
    Sí. Si ejecutas varias instancias de CouchDB en diferentes puertos, Xitogent se puede configurar para supervisar cada una de ellas de forma independiente, con recopilación de métricas y umbrales de alerta distintos.
    ¿Cómo funciona el control de la compactación?
    Xitoring realiza un seguimiento de cuándo se ejecutó la compactación por última vez, del tamaño actual de los archivos de la base de datos y de las tareas de compactación activas. Puedes configurar alertas para que se activen cuando las bases de datos superen un umbral determinado o cuando la compactación no se haya ejecutado según el calendario previsto.
    ¿Con qué frecuencia se recopilan los datos?
    Por defecto, los datos se recopilan a intervalos de un minuto. Este intervalo se puede ajustar a través del panel de control de Xitoring o de la interfaz de línea de comandos (CLI) para adaptarlo a sus necesidades de supervisión.
    ¿Cómo monitoreo el rendimiento de lectura/escritura de CouchDB?
    Lea `couchdb.database_reads`/`database_writes` para obtener la tasa de operaciones a nivel de clúster, además de `couchdb.document_inserts`/`writes` para la tasa a nivel de documento. Compárelas con `couchdb.httpd.requests` para derivar la división lectura/escritura. Para el desglose por base de datos, consulte el `_stats` de cada base de datos (CouchDB 2.x) o lea desde la superficie de métricas por base de datos (CouchDB 3.x).
    ¿Cómo detecto el desequilibrio de shards en CouchDB?
    Tres señales: `mem3.shard_cache.miss` (alta tasa de fallos = rotación o topología de shards incorrecta), `fabric.read_repairs.success`/`failure` (reparaciones crecientes = inconsistencia de shards corrigiéndose durante las lecturas) y `couchdb.open_databases` por nodo (distribución desigual = se necesita rebalancear shards). Use `/_membership` para confirmar que todos los nodos participan; rebalancee mediante `mem3:expand_clusters/0` si el recuento de shards de un nodo es significativamente bajo.
    ¿Qué versiones de CouchDB son compatibles?
    Apache CouchDB 2.x y 3.x (3.3, 3.4, 3.5) son totalmente compatibles. La 3.4 añadió índices de cobertura solo de claves Mango (mejora x10 en p95 en consultas cubiertas); la 3.5 añadió la sonda de readiness para Clouseau. La integración también funciona con despliegues gestionados a través de la API HTTP compartida. Clouseau FTS (puerto 5985) se trata como un sidecar separado: monitoree `connected` para conocer su salud.

    Empieza a seguir a CouchDB hoy

    Se configura en menos de 60 segundos. No se necesita tarjeta de crédito. Estadísticas completas desde el primer día.

    Empieza tu prueba gratuita

    Sigue explorando

    Relacionado Integraciones