`mongotop`

Los binarios de la herramienta de base de datos de línea de comandos de MongoDB no son compatibles ni han sido probados para su uso con implementaciones de MongoDB no genuinas. Aunque las herramientas pueden funcionar en estas implementaciones, no se garantiza la compatibilidad.

Esta documentación es para la versión 100.14.1 de mongotop.

Synopsis

mongotop es una herramienta de línea de comandos que proporciona un método para rastrear la cantidad de tiempo que una instancia de MongoDB mongod dedica tiempo a leer y escribir datos. mongotop proporciona estadísticas por recopilación. Por defecto, mongotop devuelve valores cada segundo.

Sintaxis

mongotop sintaxis:

mongotop <options> <connection-string> <polling interval in seconds>

Si se ejecuta mongotop sin ninguna opción de línea de comandos, se conectará a la instancia que se mongod ejecuta en el host local a través del puerto 27017 y devolverá valores cada segundo de manera predeterminada.

mongotop

Para que mongotop informe cada 30 segundos, especifique el intervalo de sondeo:

mongotop 30

Cuando se conecta a una instancia, el programa informa primero sobre la conexión y luego informa sobre las estadísticas con la frecuencia mongod configurada.

2019-04-29T15:35:27.785-0400 connected to: 127.0.0.1
             ns    total      read      write    <timestamp>
<db.collection>    81802ms     0ms    81802ms
...

Opciones de línea de comandos

mongotop [options] [frequency]

Puede ejecutar mongotop con varias opciones de línea de comandos.

Por ejemplo, para conectar mongotop a una instancia que se ejecuta en un host mongod remoto mongodb0.example.com e informar cada 30 segundos:

Puede incluir la frecuencia deseada de informes (en este ejemplo, 30 segundos) y la opción para especificar el host y el --uri puerto:
```
mongotop 30 --uri='mongodb://mongodb0.example.com:27017' [additional options]
```
Si la instancia requiere autenticación, puede especificar el usuario, la contraseña y la base de datos de autenticación como parte de la cadena de conexión mongod URI:
```
mongotop 30 --uri='mongodb://user:password@mongodb0.example.com:27017/?authSource=admin' [additional options]
```
El usuario que ejecuta mongotop debe tener los privilegios serverStatus top y.
Para obtener más información sobre la cadena de conexión URI,--uri consulte.
Alternativamente, puede utilizar las --host opciones y para especificar el host y el puerto:--port
```
mongotop 30 --host=mongodb0.example.com --port=27017 [additional options]
```
Si la mongod instancia requiere autenticación, puede especificar el usuario -u y la base de --authenticationDatabase datos de autenticación. Omita la --password opción para tener mongoexport Solicitar la contraseña.
```
mongotop 30 --host=mongodb0.example.com --port=27017 -u=user --authenticationDatabase=admin [additional options]
```
El usuario que ejecuta mongotop debe tener los privilegios serverStatus top y.

Para obtener más información sobre las opciones disponibles, consulta Opciones.

Cuando se conecta a una instancia, el programa informa primero sobre la conexión y luego informa sobre las estadísticas con la frecuencia mongod configurada.

2019-04-29T15:35:27.785-0400 connected to: 127.0.0.1
             ns    total      read      write    <timestamp>
<db.collection>    81802ms     0ms    81802ms
...

opciones

--help: Devuelve información sobre las opciones y el uso de mongotop.

--verbose, -v: Aumenta la cantidad de reportes internos devueltos en la salida estándar o en las entradas de registro. Aumenta el nivel de verbosidad con la forma -v incluyendo la opción varias veces (por ejemplo, -vvvvv.)

--quiet

Ejecuta mongotop en modo silencioso que intenta limitar la cantidad de salida.

Esta opción suprime:

resultado de los comandos de base de datos
Actividad de replicación
eventos de aceptación de conexión
eventos de cierre de conexión

--version: Devuelve el número de la versión mongotop.

--config=<filename>

Nuevo en la versión 100.3.0.

Especifica la ruta completa a un archivo de configuración YAML que contiene valores confidenciales para las siguientes opciones mongotop:

--password
--uri
--sslPEMKeyPassword

Esta es la forma recomendada de especificar una contraseña para mongotop, además de especificarla mediante una solicitud de contraseña. Puedes utilizar cualquier combinación de los argumentos en el archivo.

El archivo de configuración tiene la siguiente estructura:

password: <password>
uri: mongodb://mongodb0.example.com:27017
sslPEMKeyPassword: <password>

Si especifica la opción password sin especificar uri, puede especificar los otros componentes de la cadena de conexión utilizando las opciones de línea de comandos mongotop, como --username y --host.

Asegúrate de proteger este archivo con los permisos adecuados del sistema de archivos.

Importante

Al utilizar la opción --config, ten en cuenta las siguientes limitaciones y comportamientos:

Si proporcionas el campo password y una cadena de conexión en el campo uri con una contraseña conflictiva, mongorestore resultará en un error.
Si especifica un archivo de configuración con --config y también utiliza las opciones de línea de comandos --password, --uri o --sslPEMKeyPassword mongotop, la opción de línea de comandos anulará la opción correspondiente del archivo de configuración.

--uri=<connectionString>

Especifica la cadena de conexión URI resoluble de la implementación de MongoDB, entre comillas:

--uri="mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]"

A partir de la versión 100.0 de mongotop, la cadena de conexión puede proporcionarse alternativamente como un parámetro posicional, sin utilizar la opción --uri:

mongotop mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]

Como parámetro de posicionamiento, la cadena de conexión puede especificarse en cualquier punto de la línea de comandos, siempre que comience con mongodb:// o mongodb+srv://. Por ejemplo:

mongotop --username joe --password secret1 mongodb://mongodb0.example.com:27017 --ssl

Solo se puede proporcionar una cadena de conexión. Intentar incluir más de uno, ya sea utilizando la opción --uri o como argumento posicional, resultará en un error.

Para obtener información sobre los componentes de la cadena de conexión, consulta la documentación del formato URI de la cadena de conexión.

Nota

Algunos componentes en el connection string pueden especificarse alternativamente utilizando sus propias opciones explícitas de línea de comandos, como --username y --password. El proveer una cadena de conexión, mientras también se utiliza una opción explícita y se especifica información conflictiva, resultará en error.

Nota

Si se usa mongotop en Ubuntu 18.04, se puede recibir un mensaje de error cannot unmarshal DNS al usar cadenas de conexión SRV (en el formato mongodb+srv://) con la opción --uri. Si es así, se debe usar una de las siguientes opciones en su lugar:

la opción --uri con una cadena de conexión no SRV (en la forma mongodb://)
la opción --host para especificar el host al cual conectarse directamente

Advertencia

En algunos sistemas, una contraseña proporcionada en una cadena de conexión con la opción --uri puede ser visible para programas de estado del sistema como ps que pueden ser invocados por otros usuarios. Considera en cambio:

omitir la contraseña en la cadena de conexión para recibir un aviso interactivo de contraseña, o
utilizando la opción --config para especificar un archivo de configuración que contenga la contraseña.

--host=<hostname><:port>, -h=<hostname><:port>

Por defecto: localhost:27017

Especifica el nombre de host resoluble de la implementación de MongoDB. Por defecto, mongotop intenta conectarse a una instancia de MongoDB que se ejecuta en el host local en el número de puerto 27017.

Para conectarse a un set de réplicas, especifica el replSetName y una lista de nodos iniciales de los miembros del set, tal como se muestra a continuación:

--host=<replSetName>/<hostname1><:port>,<hostname2><:port>,<...>

Al especificar el formato de la lista del set de réplicas, mongotop siempre se conecta al primario.

También puedes conectarte a cualquier Nodo individual del Set de réplicas especificando el host y el puerto de solo ese Nodo:

--host=<hostname1><:port>

Si utilizas IPv6 y el formato <address>:<port>, debes encerrar la parte de una combinación de dirección y puerto entre corchetes (por ejemplo, [<address>]).

Alternativamente, también puedes especificar el nombre de host directamente en el URI connection string. El ofrecer una cadena de conexión, mientras también se utiliza --host y ademas se especifica información conflictiva, resultará en error.

Si está conectado a un conjunto de réplicas donde no se puede acceder al principal, mongotop devuelve un mensaje de error.

--port=<port>

Por defecto: 27017

Especifica el puerto TCP en el que la instancia de MongoDB escucha las conexiones de los clientes.

Alternativamente, también puedes especificar el puerto directamente en la URI connection string. Proveer una cadena de conexión, mientras también se utiliza --port y se especifica información conflictiva, dará como resultado un error.

--ssl

Permite la conexión a un mongod o a un mongos que tenga habilitado el soporte de TLS/SSL.

Alternativamente, también puedes configurar el soporte TLS/SSL directamente en el URI connection string. Proveer una cadena de conexión, mientras también se utiliza --ssl y se especifica información conflictiva, resultará en error.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

--sslCAFile=<filename>

Especifica el archivo .pem que contiene la cadena de certificados raíz de la Autoridad Certificadora. Especifica el nombre del archivo .pem con rutas relativas o absolutas.

Alternativamente, también puedes especificar el archivo .pem directamente en la URI connection string. Proveer una cadena de conexión, mientras también se utiliza --sslCAFile y se especifica información conflictiva, resultará en error.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

--sslPEMKeyFile=<filename>

Especifica el archivo .pem que contiene tanto el certificado TLS/SSL como la clave. Especifica el nombre del archivo .pem con rutas relativas o absolutas.

Esta opción es obligatoria cuando se utiliza la opción --ssl para conectarse a un mongod o mongos que tiene CAFile habilitado sin allowConnectionsWithoutCertificates.

Alternativamente, también puedes especificar el archivo .pem directamente en la URI connection string. Proveer una cadena de conexión, mientras también se utiliza --sslPEMKeyFile y se especifica información conflictiva, resultará en error.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

--sslPEMKeyPassword=<value>

Especifica la contraseña para descifrar el archivo de clave del certificado (es decir, --sslPEMKeyFile). Utiliza la opción --sslPEMKeyPassword solo si el archivo de clave del certificado está cifrado. En todos los casos, el mongotop ocultará la contraseña de todos los registros y reportes de salida.

Si la llave privada en el archivo PEM está cifrada y no se especifica la opción --sslPEMKeyPassword, el mongotop solicitará una frase de contraseña. Consultar la frase de contraseña del certificado TLS/SSL.

Alternativamente, también puedes especificar la contraseña directamente en la URI connection string. El ofrecer una cadena de conexión, mientras también se utiliza --sslPEMKeyPassword y ademas se especifica información conflictiva, resultará en error.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

Advertencia

En algunos sistemas, una contraseña proporcionada directamente mediante la opción --sslPEMKeyPassword puede ser visible para los programas de estado del sistema, como ps, que pueden ser invocados por otros usuarios. En su lugar, considera usar la opción --config para especificar un archivo de configuración que contenga la contraseña.

--sslCRLFile=<filename>

Especifica el archivo .pem que contiene la Lista de revocación de certificados. Especifica el nombre del archivo .pem con rutas relativas o absolutas.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

--sslAllowInvalidCertificates

Omite las comprobaciones de validación de los certificados de servidor y permite el uso de certificados no válidos. Si utilizas la configuraciónallowInvalidCertificates, MongoDB realiza un registro como advertencia del uso del certificado no válido.

Advertencia

Aunque está disponible, evita utilizar la opción --sslAllowInvalidCertificates en lo posible. Si necesitas usar --sslAllowInvalidCertificates, utiliza únicamente la opción en los sistemas donde no sea posible la intrusión.

Conectarse a una instancia mongod o mongos sin validar los certificados del servidor es un riesgo potencial para la seguridad. Si solo necesitas deshabilitar la validación del nombre de host en los certificados TLS/SSL, consulta --sslAllowInvalidHostnames.

Alternativamente, también puedes deshabilitar la validación del certificado directamente en la URI connection string. Proveer una cadena de conexión, mientras también se utiliza --sslAllowInvalidCertificates y se especifica información conflictiva, resultará en error.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

--sslAllowInvalidHostnames

Desactiva la validación de los nombres de host en los certificados TLS/SSL. Permite a mongotop conectarse a instancias de MongoDB incluso si el nombre de host en sus certificados no coincide con el nombre de host especificado.

Como alternativa, también puedes desactivar la validación del nombre de host directamente en la URI connection string. El ofrecer una cadena de conexión, mientras también se utiliza --sslAllowInvalidHostnames y ademas se especifica información conflictiva, resultará en error.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

--username=<username>, -u=<username>

Especifica un nombre de usuario con el cual autenticarte en una base de datos MongoDB que utiliza autenticación. Utilízalo en conjunto con las --password y --authenticationDatabase opciones.

Alternativamente, también puede especificar el nombre de usuario directamente en el URI connection string. Proporcionar una cadena de conexión mientras también se utiliza --username y especificar información conflictiva resultará en un error.

Si se realiza la conexión a un clúster de MongoDB Atlas con el MONGODB-AWS authentication mechanism, se puede especificar la ID de clave de acceso de AWS en:

este campo,
la connection string o
la variable de entorno AWS_ACCESS_KEY_ID.

Consulta Conectar a un clúster de MongoDB Atlas usando credenciales de AWS IAM para obtener un ejemplo de cada uno.

--password=<password>, -p=<password>

Especifica una contraseña con la que autenticarse en una base de datos de MongoDB que utiliza autenticación. Utiliza en conjunto con las --username y --authenticationDatabase opciones.

Para solicitar la contraseña al usuario, pasar la opción --username sin --password o especificar una string vacía como valor de --password, como en --password "" .

Alternativamente, también puedes especificar la contraseña directamente en la URI connection string. El ofrecer una cadena de conexión, mientras también se utiliza --password y ademas se especifica información conflictiva, resultará en error.

Si se realiza la conexión a un clúster MongoDB Atlas con el authentication mechanism de MONGODB-AWS, se puede especificar la clave de acceso secreta de AWS en:

este campo,
la connection string o
la variable de entorno AWS_SECRET_ACCESS_KEY.

Consulta Conectar a un clúster de MongoDB Atlas usando credenciales de AWS IAM para obtener un ejemplo de cada uno.

Advertencia

En algunos sistemas, una contraseña proporcionada directamente mediante la opción --password puede ser visible para programas de estado del sistema, como ps, que pueden ser invocados por otros usuarios. Considera en cambio:

omitiendo la opción --password para recibir una solicitud interactiva de contraseña, o
utilizando la opción --config para especificar un archivo de configuración que contenga la contraseña.

--awsSessionToken=<AWS Session Token>

Si se realiza la conexión a un clúster de MongoDB Atlas con el authentication mechanism de MONGODB-AWS y se usan tokens de sesión además de la ID de clave de acceso de AWS y la clave de acceso secreta, se puede especificar el token de sesión de AWS en:

este campo,
el parámetro AWS_SESSION_TOKEN authMechanismProperties para el connection string, o
la variable de entorno AWS_SESSION_TOKEN.

Consulta Conectar a un clúster de MongoDB Atlas usando credenciales de AWS IAM para obtener un ejemplo de cada uno.

Solo válido cuando se utiliza el MONGODB-AWS authentication mechanism.

--authenticationDatabase=<dbname>

Especifica la base de datos de autenticación donde se ha creado el --username especificado. --authenticationDatabase es obligatorio para instancias de mongod y mongos que utilizan Autenticación en Implementaciones Autogestionadas. Consulte Base de Datos de Autenticación.

Si utiliza GSSAPI (Kerberos), PLAIN (LDAP SASL) o MONGODB-AWS authentication mechanisms, deberá configurar --authenticationDatabase a $external.

Alternativamente, también puedes especificar la base de datos de autenticación directamente en la URI connection string. El ofrecer una cadena de conexión, mientras también se utiliza --authenticationDatabase y ademas se especifica información conflictiva, resultará en error.

--authenticationMechanism=<name>

Por defecto: SCRAM-SHA-1

Especifica el mecanismo de autenticación que la instancia mongotop utiliza para autenticarse en el mongod o en el mongos.

Cambiado en la versión 100.1.0: A partir de la versión 100.1.0, mongotop agrega soporte para el mecanismo de autenticación MONGODB-AWS al conectarse a un clúster de MongoDB Atlas.

Valor	Descripción
SCRAM-SHA-1	Solicitud de comentarios 5802 Mecanismo de autenticación de respuesta de desafío salado estándar que utiliza la función hash SHA-1.
SCRAM-SHA-256	RFC 7677 estándar del mecanismo de autenticación de respuesta a desafío salado utilizando la función de hash SHA-256. Se debe establecer featureCompatibilityVersion en `4.0`.
MONGODB-X.509	Autenticación de certificados TLS/SSL de MongoDB.
`MONGODB-AWS`	Autenticación externa utilizando credenciales de AWS IAM para conectarse a un clúster de MongoDB Atlas. Consulte Conéctese a un clúster de MongoDB Atlas usando credenciales de AWS IAM. Nuevo en la versión 100.1.0.
GSSAPI (Kerberos)	Autenticación externa mediante Kerberos. Este mecanismo solo está disponible en MongoDB Enterprise.
PLAIN (SASL LDAP)	Autenticación externa mediante LDAP. También puedes utilizar `PLAIN` para autenticar a los usuarios de base de datos. `PLAIN` transmite contraseñas en texto plano. Este mecanismo solo está disponible en MongoDB Enterprise.

Alternativamente, también puedes especificar el mecanismo de autenticación directamente en la URI connection string. Proveer una cadena de conexión, mientras también se utiliza --authenticationMechanism y se especifica información conflictiva, resultará en error.

--gssapiServiceName=<serviceName>

Especifica el nombre del servicio mediante GSSAPI/Kerberos. Solo es necesario si el servicio no utiliza el nombre por defecto de mongodb.

Esta opción solo está disponible en MongoDB Enterprise.

--gssapiHostName=<hostname>

Especifica el nombre de host de un servicio utilizando GSSAPI/Kerberos. Solo es necesario si el nombre de host de una máquina no coincide con el nombre de host resuelto por DNS.

Esta opción solo está disponible en MongoDB Enterprise.

--locks

Activa o desactiva el modo para mongotop informar sobre el uso de bloqueos por base de datos. Estos datos solo están disponibles al conectarse a una instancia de MongoDB 2.6 o anterior.

--locks devuelve un error cuando se llama contra una mongod 3.0 instancia o más nueva que no informa el uso del bloqueo por base de datos.

--rowcount=<int>, -n=<int>: Número de líneas de datos que mongotop debe imprimir. "0 para indefinido"

--json: Devuelve la salida de mongotop en formato JSON. Además de los datos de tiempo, la --json opción también devuelve un recuento del número de operaciones realizadas durante el intervalo de sondeo.

<sleeptime>: El último argumento es el tiempo, en segundos, que mongotop espera entre llamadas. Por defecto, mongotop devuelve datos cada segundo.

Campos

Cuando se conecta a una instancia, el programa informa primero sobre la conexión y luego informa sobre las estadísticas con la frecuencia mongod configurada. mongotop devuelve valores de tiempo especificados en milisegundos (ms).

2019-04-29T15:35:27.785-0400 connected to: 127.0.0.1
             ns    total      read      write    <timestamp>
<db.collection>    81802ms     0ms    81802ms
...
             ns    total      read      write    <timestamp>
<db.collection>    0ms         0ms        0ms
...

mongotop Solo informa sobre espacios de nombres o bases de datos activos, según la opción. Si no ve una base de datos o colección, significa --locks mongo que no mongotop ha tenido actividad reciente. Puede ejecutar una operación simple en el shell para generar actividad que afecte la salida de.

mongotop.ns

Contiene el espacio de nombres de la base de datos, que combina el nombre de la base de datos y la colección.

Si mongotop --locks utiliza, el campo no aparece en ns la mongotop salida.

mongotop.db

Contiene el nombre de la base de datos. La base de datos nombrada . se refiere al bloqueo global, en lugar de a una base de datos específica.

Este campo no aparece a menos que haya invocado mongotop con la --locks opción.

mongotop.total: Proporciona la cantidad total de tiempo que este mongod pasó operando en este espacio de nombres.

mongotop.read: Proporciona la cantidad de tiempo que este mongod dedicó a realizar operaciones de lectura en este espacio de nombres.

mongotop.write: Proporciona la cantidad de tiempo que este mongod dedicó a realizar operaciones de guardar en este namespace.

mongotop.<timestamp>: Proporciona una marca de tiempo para los datos devueltos.

Información Adicional

Para más información sobre la supervisión de MongoDB, consulta Supervisión de MongoDB.

Para obtener información adicional sobre otras salidas de estado de MongoDB, consulte:

Para obtener una utilidad adicional que proporciona métricas de MongoDB,mongostat consulte.

Obtén más información

Volver

Ejemplos

Compatibilidad e instalación