consul/website/content/commands/monitor.mdx

---
layout: commands
page_title: 'Commands: Monitor'
description: >-
  The `monitor` command is used to connect and follow the logs of a running
  Consul agent. Monitor will show the recent logs and then continue to follow
  the logs, not exiting until interrupted or until the remote agent quits.
---

# Consul Monitor

Command: `consul monitor`

The `monitor` command is used to connect and follow the logs of a running
Consul agent. Monitor will show the recent logs and then continue to follow
the logs, not exiting until interrupted or until the remote agent quits.

The power of the monitor command is that it allows you to log the agent
at a relatively high log level (such as "warn"), but still access debug
logs and watch the debug logs if necessary.

## Usage

Usage: `consul monitor [options]`

#### Command Options

- `-log-level` - The log level of the messages to show. By default this
  is "info". This log level can be more verbose than what the agent is
  configured to run at. Available log levels are "trace", "debug", "info",
  "warn", and "error".
- `-log-json` - Toggles whether the messages are streamed in JSON format.
  By default this is false.

#### API Options

@include 'http_api_options_client.mdx'
website: bulk copy from serf 2014-02-08 00:41:03 +00:00			`---`
docs: update structure (#8506) - moved and renamed files/folders based on new structure - updated docs navigation based on new structure - moved CLI to top nav (created commands.jsx and commands-navigation.js) - updated and added redirects - updating to be consistent with standalone categories - changing "overview" link in top nav to lead to where intro was moved (docs/intro) - adding redirects for intro content - deleting old intro folders - format all data/navigation files - deleting old commands folder - reverting changes to glossary page - adjust intro navigation for removal of 'vs' paths - add helm page redirect - fix more redirects - add a missing redirect - fix broken anchor links and formatting mistakes - deleted duplicate section, added redirect, changed link - removed duplicate glossary page 2020-09-01 15:14:13 +00:00			`layout: commands`
intro and api navigation converted 2020-04-07 18:55:19 +00:00			`page_title: 'Commands: Monitor'`
			`description: >-`
			The `monitor` command is used to connect and follow the logs of a running
			`Consul agent. Monitor will show the recent logs and then continue to follow`
			`the logs, not exiting until interrupted or until the remote agent quits.`
website: bulk copy from serf 2014-02-08 00:41:03 +00:00			`---`

website: updating documentation on commands 2014-02-19 01:32:13 +00:00			`# Consul Monitor`
website: bulk copy from serf 2014-02-08 00:41:03 +00:00
website: updating documentation on commands 2014-02-19 01:32:13 +00:00			Command: `consul monitor`
website: bulk copy from serf 2014-02-08 00:41:03 +00:00
Use new Markdown syntaxes and add SEO descriptions 2014-10-19 23:40:10 +00:00			The `monitor` command is used to connect and follow the logs of a running
website: updating documentation on commands 2014-02-19 01:32:13 +00:00			`Consul agent. Monitor will show the recent logs and then continue to follow`
website: bulk copy from serf 2014-02-08 00:41:03 +00:00			`the logs, not exiting until interrupted or until the remote agent quits.`

			`The power of the monitor command is that it allows you to log the agent`
			`at a relatively high log level (such as "warn"), but still access debug`
			`logs and watch the debug logs if necessary.`

			`## Usage`

website: updating documentation on commands 2014-02-19 01:32:13 +00:00			Usage: `consul monitor [options]`
website: bulk copy from serf 2014-02-08 00:41:03 +00:00
Convert monitor command to use base.Command 2017-02-09 22:31:52 +00:00			`#### Command Options`
website: bulk copy from serf 2014-02-08 00:41:03 +00:00
intro and api navigation converted 2020-04-07 18:55:19 +00:00			- `-log-level` - The log level of the messages to show. By default this
website: bulk copy from serf 2014-02-08 00:41:03 +00:00			`is "info". This log level can be more verbose than what the agent is`
			`configured to run at. Available log levels are "trace", "debug", "info",`
docs: Use "error" to use standard log level value (#13507) * docs: Use "error" to use standard log level value 2022-06-20 23:07:38 +00:00			`"warn", and "error".`
intro and api navigation converted 2020-04-07 18:55:19 +00:00			- `-log-json` - Toggles whether the messages are streamed in JSON format.
Allow users to configure either unstructured or JSON logging (#7130) * hclog Allow users to choose between unstructured and JSON logging 2020-01-28 23:50:41 +00:00			`By default this is false.`
docs: show CLI cmd-specific opts before general opts Applied to all remaining CLI commands. 2022-07-27 06:17:11 +00:00
			`#### API Options`

			`@include 'http_api_options_client.mdx'`