Docs Home → MongoDB Command Line Interface
mongocli atlas logs download
mongocli atlas commands are now deprecated because there's a new, dedicated CLI available for Atlas users. Migrate to the Atlas CLI to enjoy the same capabilities and the latest features. You can use mongocli atlas commands until April 30, 2023.Download a compressed file that contains the MongoDB logs for the specified host.
This command downloads a file with a .gz extension.
To find the hostnames for an Atlas project, use the process list command.
To use this command, you must authenticate with a user account or an API key that has the Project Data Access Read/Write role.
Syntax
Command Syntax
mongocli atlas logs download <hostname> <mongodb.gz|mongos.gz|mongosqld.gz|mongodb-audit-log.gz|mongos-audit-log.gz> [options]
Arguments
Name | Type | Required | Description |
|---|---|---|---|
hostname | string | true | Label that identifies the host that stores the log files that you want to download. |
mongodb.gz|mongos.gz|mongosqld.gz|mongodb-audit-log.gz|mongos-audit-log.gz | string | true | Log file that you want to return. |
Options
Name | Type | Required | Description |
|---|---|---|---|
--end | int | false | UNIX Epoch-formatted ending date and time for the range of log messages to retrieve. This value defaults to the current timestamp. |
--force | false | Overwrites the destination file. | |
-h, --help | false | help for download | |
--out | string | false | Output file name. Uses the log name if the output file's name is not specified. |
--projectId | string | false | Hexadecimal string that identifies the project to use. This option overrides the settings in the configuration file or environment variable. |
--start | int | false | UNIX Epoch-formatted starting date and time for the range of log messages to retrieve. This value defaults to 24 hours prior to the current timestamp. |
Inherited Options
Name | Type | Required | Description |
|---|---|---|---|
-P, --profile | string | false | Name of the profile to use from your configuration file. To learn about profiles for MongoCLI, see https://dochub.mongodb.org/core/atlas-cli-configuration-file. |
Output
If the command succeeds, the CLI returns output similar to the following sample. Values in brackets represent your values.
Download of <Name> completed.
Examples
# Download the mongodb log file from the host atlas-123abc-shard-00-00.111xx.mongodb.net for the project with the ID 5e2211c17a3e5a48f5497de3: mongocli atlas logs download atlas-123abc-shard-00-00.111xx.mongodb.net mongodb.gz --projectId 5e2211c17a3e5a48f5497de3