open-vault/website/content/docs/commands/monitor.mdx
Meggie bb6ba32f65
Add note that monitor command may truncate logs (#13079)
* Add note that monitor command may truncate logs

* Apply suggestions from code review

Co-authored-by: Nick Cabatoff <ncabatoff@hashicorp.com>

Co-authored-by: Nick Cabatoff <ncabatoff@hashicorp.com>
2021-11-08 12:52:42 -05:00

44 lines
1.3 KiB
Plaintext

---
layout: docs
page_title: monitor - Command
description: |-
The "monitor" command displays the server logs of a Vault server in real
time.
---
# monitor
The `monitor` command shows a real time display of the server logs of a Vault
server. This command accepts a log level as an argument, which can be different
from the log level that the Vault server was started with.
The `monitor` command honors the `VAULT_ADDR` environment variable. The address
specified determines the target server that will be monitored.
Note that this command is designed to run indefinitely. It is similar to
`tail -f` in the Unix world. This command will not exit on its own unless
it encounters an unexpected error. As a user, you must terminate this
process yourself to shut it down.
If Vault is emitting log messages faster than a receiver can process them, the
some log lines will be dropped.
## Examples
Monitor server logs at the `debug` log level:
```shell-session
$ vault monitor -log-level=debug
```
## Usage
The following flags are available in addition to the [standard set of
flags](/docs/commands) included on all commands.
### Output Options
- `-log-level` `(string: "info")` - Monitor the Vault server at this log level.
Valid log levels are (in order of detail) "trace", "debug", "info",
"warn", "error". If this option is not specified, "info" is used.