Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Integre con Prometheus

Prometheus recopila métricas de objetivos configurados a intervalos dados, evalúa Expresiones de regla, muestra los resultados y puede desencadenar alertas cuando observa condiciones específicas.

Nuestra integración te permite configurar Cloud Manager para enviar datos de métricas sobre tu implementación a tu instancia de Prometheus.

Para integrar Cloud Manager con Prometheus:

1
  1. Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haga clic en Project Settings.

    La página Configuración del proyecto se muestra.

2

En la barra lateral, haz clic en Integrations en la sección Settings.

La página de Integraciones del proyecto se muestra.

3
4

Las credenciales de autenticación de Prometheus están específicamente diseñadas para su uso con la integración de Prometheus en Cloud Manager. Cloud Manager utiliza estas credenciales sólo para acceder al endpoint de descubrimiento de Prometheus y obtener métricas de Prometheus de los nodos de Cloud Manager. Está estrictamente limitado a estas funciones y no tienen permisos o capacidades adicionales más allá del acceso y la recopilación de datos de supervisión.

Importante

Copie su nombre de usuario y contraseña en una ubicación segura. No puede acceder a la contraseña después de salir de esta pantalla.

5

Tip

El valor por defecto, 0.0.0.0:9216, recopila métricas en el puerto 9216 en todas las direcciones IPv4 en la máquina local.

6

Si habilitas esta opción, Cloud Manager garantiza que tu instancia de Prometheus utilice https para recopilar métricas.

Campos
Descripción

Ruta del archivo de clave del certificado TLS

PEM ruta del archivo que contiene el certificado y la clave necesarios para iniciar un punto final de extracción de Prometheus https.

Usted es responsable de lo siguiente:

  • Emisión y renovación del archivo de clave del certificado TLS.

  • Verificando si el endpoint se inició correctamente en los registros del agente de automatización.

Contraseña del archivo de clave del certificado TLS

Es obligatorio si el archivo clave del certificado está cifrado.

7
Método de descubrimiento
Descripción

Este método requiere Prometheus v2.28 y versiones posteriores. Genera la scrape_config parte de tu archivo de configuración para descubrir destinos en un endpoint HTTP.

Este método permite a Prometheus leer documentos YAML o JSON para configurar los objetivos que se van a raspar.

El usuario tiene la responsabilidad de proporcionar los objetivos realizando una solicitud a la Discovery API y almacenando los resultados en un archivo targets.json.

Para realizar la solicitud, sustituir el texto del marcador de posición en una de las siguientes pestañas o cree su propio script en otro lenguaje.

# Sets the `Authorization` header on every scrape# request with the username and password from the# previous step. The URL that Prometheus fetches the# targets from.# Replace the <group-id> with the project ID of your# Cloud Manager instance. curl --header 'Accept: application/json' \ --user <username>:<password> \ --request GET "https://cloud.mongodb.com/prometheus/v1.0/groups/{GROUP-ID}/discovery"

Para aprender más sobre la API de Discovery, consultar Devuelva los últimos objetivos para Prometheus.

8
9
  1. Se debe copiar el fragmento generado en la sección scrape_configs del archivo de configuración y sustituir el texto del marcador de posición.

    Para un ejemplo del archivo de configuración en cualquiera de los métodos, consulta Configuraciones de ejemplo.

  2. Se debe reiniciar la instancia de Prometheus.

  3. En su instancia de Prometheus, hacer clic en Status en la barra de navegación superior y luego en Targets para ver las métricas de la implementación.

Lo siguiente muestra ejemplos del archivo de configuración cuando utilizas el método de descubrimiento de servicios HTTP o descubrimiento de servicios por archivo.

El archivo de configuración en ambos métodos contiene los siguientes campos:

Campo
Descripción

scrape_interval

Tiempo que indica con qué frecuencia se deben recopilar los objetivos. Esta configuración soporta un tiempo mínimo de 10s.

job_name

Etiqueta legible por humanos asignada a las métricas recopiladas.

metrics_path

Ruta de recurso HTTP que indica dónde obtener métricas de los destinos.

scheme

Tu esquema de protocolo Prometheus configurado para solicitudes, ya sea http o https. Si configuras https, debes especificar tlsPemPath.

basic_auth

Encabezado de autorización para usar en cada solicitud de extracción.

El método de descubrimiento de HTTP Service también contiene el campo http_sd_configs con los siguientes subcampos:

Campo
Descripción

url

URL desde la cual Prometheus obtiene los objetivos.

refresh_interval

Hora que indica cuándo volver a realizar una query al punto de conexión.

basic_auth

Credenciales que se utilizarán para autenticar en el servidor de la API.

global: scrape_interval: 15s scrape_configs: - job_name: "CM-Testing-mongo-metrics" scrape_interval: 10s metrics_path: /metrics scheme : https basic_auth: username: prom_user_61e6e34e93eac1632d39f457 password: V7hTyLfkjwiWQbv http_sd_configs: - url: https://cloud.mongodb.com/prometheus/v1.0/groups/61e6e34e93eac1632d39f457/discovery refresh_interval: 60s basic_auth: username: prom_user_61e6e34e93eac1632d39f457 password: V7hTyLfkjwiWQbv

El método de descubrimiento de servicios de archivo también contiene el campo file_sd_configs con el siguiente subcampo:

Campo
Descripción

files

Lista que contiene los archivos de los que se extraerán los objetivos de extracción de métricas.

global: scrape_interval: 15s scrape_configs: - job_name: "CM-Testing-mongo-metrics" scrape_interval: 10s metrics_path: /metrics scheme : https basic_auth: username: prom_user_61e6e34e93eac1632d39f457 password: V7hTyLfkjwiWQbv file_sd_configs: - files: - /usr/local/etc/targets.json

Para importar un tablero de muestra de Grafana:

1

En la Interfaz de Usuario de Grafana, hacer clic en el botón y luego hacer clic en Import.

2
3

Para aprender más sobre la importación de tableros de Grafana, consulta la documentación de Grafana.

Las siguientes métricas están disponibles cuando utilizas la integración de Prometheus con tu clúster de MongoDB Atlas:

Cada métrica de MongoDB contiene las siguientes etiquetas:

Etiqueta
Descripción

group_id

String única de dígitos hexadecimales que identifica el proyecto.

org_id

String única de dígitos hexadecimales que identifica a la organización.

cl_role

Etiqueta legible por humanos que define el rol del clúster.

cl_name

Etiqueta legible por humanos que identifica el clúster.

rs_nm

Etiqueta legible por humanos que identifica el conjunto de réplicas.

rs_state

Número que indica el estado del Set de réplicas.

process_port

Puerto en el cual se ejecuta el proceso.

mongodb_info es un medidor que siempre tiene el valor de 1. Esta métrica contiene todas las Etiquetas de métricas de MongoDB y también las siguientes etiquetas:

Etiqueta
Descripción

mongodb_version

String que representa las versiones principal, secundaria y de parche.

replica_state_name

String que indica el estado del Set de réplicas.

process_type

String que indica el proceso en ejecución. Sus valores pueden ser mongod, mongos o config.

Nota

También puedes ver descripciones de cada métrica de hardware en el navegador de expresiones Prometheus.

Nombre
Sistema operativo
Tipo
Descripción

hardware_system_cpu_nice

Unix, Darwin

Contador

Tiempo empleado en el modo de usuario con prioridad baja.

hardware_system_cpu_io_wait

Unix

Contador

Tiempo de espera para que se complete la E/S.

hardware_system_cpu_irq

Unix

Contador

Tiempo dedicado a atender las interrupciones.

hardware_system_cpu_soft_irq

Unix

Contador

Tiempo dedicado al mantenimiento de softirq.

hardware_system_cpu_steal

Unix

Contador

Tiempo dedicado a otros sistemas operativos al ejecutarse en un entorno virtual.

hardware_system_cpu_guest

Unix

Contador

Tiempo dedicado a ejecutar una CPU virtual para los sistemas operativos invitados bajo el control del kernel de Linux.

hardware_system_cpu_guest_nice

Unix

Contador

Tiempo dedicado a ejecutar un invitado con una prioridad ajustada.

hardware_system_cpu_kernel_milliseconds

Todo

Contador

Tiempo empleado en moda de sistema.

hardware_system_cpu_user_milliseconds

Todo

Contador

Tiempo dedicado en modo de usuario.

hardware_disk_metrics_weighted_time_io

Unix

Contador

Tiempo ponderado dedicado a realizar operaciones de E/S.

hardware_disk_metrics_physical_write_count

Unix

Contador

Número de I/O de guardar físicas procesadas.

hardware_disk_metrics_physical_read_count

Unix

Contador

Número de I/O de lectura física procesadas.

hardware_disk_metrics_total_time

Unix

Contador

Tiempo total que el dispositivo de bloque está activo.

hardware_disk_metrics_idle_time

Windows

Contador

Tiempo dedicado a la tarea inactiva.

hardware_disk_metrics_disk_space_free_bytes

Todo

Medidor

Espacio en disco disponible en el sistema de archivos montado.

hardware_disk_metrics_disk_space_used_bytes

Todo

Medidor

Espacio en disco utilizado en el sistema de archivos montado.

hardware_disk_metrics_read_count

Todo

Contador

Número de E/S de lectura procesadas.

hardware_disk_metrics_read_time_milliseconds

Todo

Contador

Tiempo total de espera para las solicitudes de lectura.

hardware_disk_metrics_write_count

Todo

Contador

Número de E/S de guardado procesadas.

hardware_disk_metrics_write_time_milliseconds

Todo

Contador

Tiempo total de espera para las solicitudes de guardado.

hardware_process_cpu_children_user

Unix

Contador

Cantidad de tiempo programado en modo de usuario para que este proceso espere a los procesos secundarios.

hardware_process_cpu_children_kernel

Unix

Contador

Cantidad de tiempo programada en el modo kernel para que este proceso espere a los procesos secundarios.

hardware_process_cpu_kernel_milliseconds

Todo

Contador

Cantidad de tiempo programada en modo kernel para este proceso.

hardware_process_cpu_user_milliseconds

Todo

Contador

Cantidad de tiempo programada en modo usuario para este proceso.

hardware_system_vm_page_swap_in

Unix

Contador

Número de páginas que el sistema ha intercambiado desde el disco.

hardware_system_vm_page_swap_out

Unix

Contador

Número de páginas que el sistema ha paginado al disco.

hardware_system_memory_mem_total

Unix

Medidor

RAM total utilizable (RAM física menos algunos bits reservados y el código binario del kernel).

hardware_system_memory_mem_free

Unix

Medidor

Suma de LowFree y HighFree.

hardware_system_memory_mem_available

Unix

Medidor

Una estimación de la cantidad de memoria disponible para iniciar nuevas aplicaciones, sin intercambio de memoria.

hardware_system_memory_buffers

Unix

Medidor

Almacenamiento temporal para bloques de disco sin procesar que no deberían volverse excesivamente grandes.

hardware_system_memory_cached

Unix

Medidor

Caché en memoria para archivos leídos desde el disco. Esto no incluye SwapCached.

hardware_system_memory_swap_total

Unix

Medidor

Cantidad total de espacio de intercambio disponible.

hardware_system_memory_swap_free

Unix

Medidor

Cantidad total de espacio de intercambio no utilizado.

hardware_system_memory_shared_mem

Unix

Medidor

Cantidad de memoria consumida en sistemas de archivos cuyos contenidos residen en la memoria virtual.

hardware_system_memory_swap_free_kilobytes

Todo

Medidor

Cantidad total de espacio de intercambio no utilizado.

hardware_system_memory_swap_total_kilobytes

Todo

Medidor

Cantidad total de espacio de intercambio disponible.

hardware_platform_num_logical_cpus

Todo

Medidor

Número de CPUs lógicas utilizables por el proceso actual.

hardware_system_network_eth0_bytes_in_bytes

Todo

Contador

Número de bytes de datos recibidos por la interfaz.

hardware_system_network_eth0_bytes_out_bytes

Todo

Contador

Número de bytes de datos transmitidos por la interfaz.

hardware_system_network_lo_bytes_in_bytes

Todo

Contador

Número de bytes de datos recibidos por la interfaz.

hardware_system_network_lo_bytes_out_bytes

Todo

Contador

Número de bytes de datos transmitidos por la interfaz.

Cada métrica de hardware contiene las siguientes etiquetas:

Etiqueta
Descripción

group_id

String única de dígitos hexadecimales que identifica el proyecto.

org_id

String única de dígitos hexadecimales que identifica a la organización.

process_port

Puerto en el cual se ejecuta el proceso.

disk_name

Etiqueta legible por humanos que identifica el disco.