{"id":7194,"date":"2019-07-11T10:00:53","date_gmt":"2019-07-11T17:00:53","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=7194"},"modified":"2025-06-13T21:33:42","modified_gmt":"2025-06-14T04:33:42","slug":"monitoring-couchbase-sync-gateway-kubernetes-cluster-prometheus","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/monitoring-couchbase-sync-gateway-kubernetes-cluster-prometheus\/","title":{"rendered":"Monitorizaci\u00f3n Prometheus de Couchbase Mobile Kubernetes Cluster"},"content":{"rendered":"

ACTUALIZACI\u00d3N: A partir de la versi\u00f3n 2.8, Sync Gateway incluye soporte integrado para el exportador Prometheus<\/a>. Las estad\u00edsticas se exportan en formato compatible con Prometheus a trav\u00e9s del punto final de m\u00e9tricas. Esto implica que ya no es necesario tener un exportador separado. Lee la documentaci\u00f3n de Couchbase para m\u00e1s detalles sobre supervisi\u00f3n de Sync Gateway v2.8+ mediante el nuevo punto final<\/a>.<\/em><\/p>\n

En Couchbase M\u00f3vil 2.5<\/a> introdujo una amplia informes estad\u00edsticos<\/a> capacidades en el Pasarela de sincronizaci\u00f3n<\/a>. Las estad\u00edsticas proporcionan informaci\u00f3n clave sobre la salud de su despliegue Couchbase Mobile y constituye una parte integral de cualquier despliegue.<\/p>\n

Esta es una gu\u00eda paso a paso para utilizar Prometeo<\/a> (supervisi\u00f3n y alerta de c\u00f3digo abierto) con cl\u00fasteres Sync Gateway en Kubernetes<\/a>. Utilizaremos Grafana<\/a> para visualizar las estad\u00edsticas.<\/p>\n

A menudo se afirma que Prometheus y Kubernetes comparten un \"ascendencia espiritual<\/em>\". Ambos proyectos est\u00e1n alojados en la Fundaci\u00f3n para la Computaci\u00f3n Nativa en la Nube<\/a>. Se rigen por objetivos de dise\u00f1o comunes, lo que hace que Prometheus sea muy adecuado para supervisar las implementaciones de Kubernetes.<\/p>\n

En un post relacionado<\/a>En el art\u00edculo anterior, hablamos de la configuraci\u00f3n de la monitorizaci\u00f3n con Prometheus en un cl\u00faster de Couchbase Mobile en un entorno sin Kubernetes. Si hab\u00edas seguido ese post, puedes saltarte las secciones iniciales y pasar directamente a la secci\u00f3n Arquitectura de implantaci\u00f3n<\/em> secci\u00f3n.<\/p>\n

Fondo<\/h2>\n

Informes estad\u00edsticos de Sync Gateway<\/h3>\n

Las estad\u00edsticas de Sync Gateway se presentan en formato JSON y est\u00e1n disponibles a trav\u00e9s de la funci\u00f3n _expvar<\/a> a trav\u00e9s de Sync Gateway Admin REST<\/a> interfaz.
\nEstas son las categor\u00edas de estad\u00edsticas de las que se informa.
\n\"\"<\/p>\n

Prometeo<\/h3>\n

Prometeo<\/a> es una plataforma de alerta y monitorizaci\u00f3n de sistemas de c\u00f3digo abierto. En su n\u00facleo, Servidor Prometheus<\/strong> es responsable de sondear los \"objetivos de Prometheus\" para obtener estad\u00edsticas y almacenarlas como datos de series temporales. Los objetivos Prometheus se configuran est\u00e1ticamente o pueden ser descubiertos por Prometheus.<\/p>\n

Grafana<\/h3>\n

Grafana<\/a> es una plataforma de alerta y visualizaci\u00f3n de datos de c\u00f3digo abierto. Admite Prometheus como fuente de datos y puede utilizarse para crear cuadros de mando completos.<\/p>\n

Presentaci\u00f3n del exportador de Prometheus Sync Gateway<\/h2>\n

Para que Prometheus pueda supervisar el Sync Gateway, necesitamos un \"objetivo Prometheus\" correspondiente al Sync Gateway. Este objetivo es el Exportador de Sync Gateway<\/strong>en lo sucesivo denominado \"el Exportador\". En pocas palabras, el Exportador<\/a> se encarga de exportar las estad\u00edsticas de Sync Gateway a las m\u00e9tricas de Prometheus.<\/p>\n

\"\"<\/figure>\n

Arquitectura de implantaci\u00f3n<\/h2>\n

Si unimos todo esto, un despliegue t\u00edpico tiene el siguiente aspecto:<\/p>\n

\"\"<\/figure>\n

Vale... parece mucho m\u00e1s complejo de lo que es en realidad. De hecho, es bastante sencillo:<\/p>\n

Contenedor exportador de Sync Gateway<\/strong><\/p>\n

Los contenedores Exporter y Sync Gateway deben estar ubicados en el mismo pod utilizando el patr\u00f3n sidecar<\/a>. La API REST de Sync Gateway Admin es, por defecto, s\u00f3lo expuesto<\/a> en localhost. Esta configuraci\u00f3n tambi\u00e9n se recomienda encarecidamente en entornos de producci\u00f3n. Dado que el exportador consulta la API de administraci\u00f3n de Sync Gateway para obtener estad\u00edsticas, debe estar en el mismo host\/nodo que Sync Gateway.<\/p>\n

Adem\u00e1s, las estad\u00edsticas de Sync Gateway se notifican por nodo. Por lo tanto, en un cl\u00faster de dos o m\u00e1s nodos de Sync Gateway, cada nodo de Sync Gateway debe tener su propio exportador.<\/p>\n

Servicio Exportador de Sync Gateway<\/strong><\/p>\n

Los pods de Sync Gateway que contienen el exportador deben estar expuestos a otros servicios del cl\u00faster. En Kubernetes, esto se hace a trav\u00e9s de un comando Servicio de red Kubernetes<\/a>. El servicio exportador de Sync Gateway expone los pods de Sync Gateway y los hace accesibles al servicio Prometheus.<\/p>\n

Operador de Prometheus<\/strong><\/p>\n

Sondea continuamente el exportador en busca de estad\u00edsticas, que a su vez sondea el punto final REST de Sync Gateway. El servidor utiliza las reglas definidas en el rules.yaml<\/em> para enviar alertas al Gestor de alertas<\/strong>. La forma m\u00e1s sencilla de desplegar Prometheus en el cl\u00faster de Kubernetes es utilizando el comando Operador de Prometheus<\/a>. El Operador de Prometheus se encarga de desplegar la pila de Prometheus incluyendo el Gestor de Alertas y Grafana.
\nEl operador act\u00faa sobre una serie de definiciones de recursos personalizadas (CRD). La m\u00e1s interesante es la Monitor de servicio<\/strong>. El monitor de servicios se encarga de definir c\u00f3mo se van a supervisar los servicios. En este caso, se supervisan los pods de Sync Gateway que se exponen a trav\u00e9s del servicio Sync Gateway Exporter.<\/p>\n

Grafana<\/strong><\/p>\n

El servicio sondea el servidor Prometheus en busca de estad\u00edsticas y las representa gr\u00e1ficamente en un panel basado en web al que se puede acceder a trav\u00e9s del navegador web. Para acceder al panel de Grafana desde fuera del cl\u00faster, tendr\u00e1 que utilizar el reenv\u00edo de puertos. Tambi\u00e9n podr\u00eda exponerlo utilizando NodePort o el equivalente en Kubernetes. De nuevo, Prometheus Operator deber\u00eda encargarse de desplegarlo.<\/p>\n

C\u00f3digo fuente del exportador<\/h2>\n

Sync Gateway Exporter es de c\u00f3digo abierto couchbaselabs<\/em><\/a> y disponible en GitHub. Es compatible con Couchbase Sync Gateway 2.5+. Por ello, aunque nos esforzaremos por mantenerlo actualizado con la \u00faltima versi\u00f3n de Sync Gateway, no podemos garantizarlo. La buena noticia es que es de c\u00f3digo abierto e incluye detallada instrucciones sobre c\u00f3mo ampliarlo para que admita estad\u00edsticas adicionales<\/a>.<\/p>\n

Clona el c\u00f3digo fuente de Exporter de Github y actualiza los subm\u00f3dulos relevantes. El repositorio incluye todos los yaml<\/em> que se utilizar\u00e1n para la implantaci\u00f3n.<\/p>\n

git clone https:\/\/github.com\/couchbaselabs\/couchbase-sync-gateway-exporter\r\n\r\ngit submodule update --init --rebase --remote --recursive<\/code><\/pre>\n
En yaml<\/em> Los archivos de configuraci\u00f3n a los que se hace referencia en este post est\u00e1n disponibles en la carpeta \"kubernetes\".<\/p>\n
cd \/path\/to\/cloned\/exporter\/source\/kubernetes<\/code><\/pre>\n
Instalaci\u00f3n<\/h2>\n
En el resto del post, vamos a caminar a trav\u00e9s de los pasos para configurar el monitoreo en un cl\u00faster Couchbase Mobile en el cl\u00faster Kubernetes. Las instrucciones aqu\u00ed descritas deber\u00edan aplicarse a cualquier despliegue gestionado de Kubernetes.<\/p>\n
Despliegue del cl\u00faster de servidores Couchbase<\/h3>\n
Siga las instrucciones aqu\u00ed<\/a> para desplegar la \u00faltima versi\u00f3n del cluster de Couchbase Server usando Couchbase Autonomous Operator.<\/p>\n
Despliegue del cl\u00faster de Sync Gateway<\/h3>\n
Siga las instrucciones aqu\u00ed<\/a> para desplegar un cl\u00faster de Sync Gateway en Kubernetes<\/p>\n
Despliegue de Prometheus y Grafana<\/h3>\n
Existen varios opciones<\/a> para desplegar Prometheus. De hecho, la mayor\u00eda de los servicios gestionados de Kubernetes pueden tener opciones
\nUna de las opciones m\u00e1s sencillas es desplegar utilizando la funci\u00f3n Operador de Prometheus<\/a> utilizando Tim\u00f3n<\/a>.<\/p>\n
El gr\u00e1fico de Prometheus desplegar\u00e1 toda la pila de monitorizaci\u00f3n, incluido el servidor de Prometheus, Grafana, Alert Manager, etc.<\/p>\n
Instalaci\u00f3n de Helm<\/h4>\n
Si ya tiene Helm funcionando en su cluster, omita este paso<\/p>\n
kubectl create serviceaccount --namespace kube-system tiller\r\n\r\nkubectl create clusterrolebinding tiller-cluster-admin --clusterrole=cluster-admin --serviceaccount=kube-system:tiller\r\nhelm init --service-account tiller --upgrade<\/code><\/pre>\n
Instalaci\u00f3n de Prometheus<\/h4>\n
Instale el Operador Prometheus ejecutando este comando desde la ra\u00edz del repositorio clonado.<\/p>\n