f2615992a4
The `nomad operator raft` and `nomad operator snapshot state` subcommands for inspecting on-disk raft state were hidden and undocumented. Expose and document these so that advanced operators have support for these tools.
39 lines
1,015 B
Plaintext
39 lines
1,015 B
Plaintext
---
|
|
layout: docs
|
|
page_title: 'Commands: operator raft logs'
|
|
description: |
|
|
Display Raft server state.
|
|
---
|
|
|
|
# Command: operator raft logs
|
|
|
|
The `raft logs` command is used to display the log entries persisted in
|
|
the Nomad [data directory] in JSON format.
|
|
|
|
This command requires file system permissions to access the data
|
|
directory on disk. The Nomad server locks access to the data
|
|
directory, so this command cannot be run on a data directory that is
|
|
being used by a running Nomad server.
|
|
|
|
~> **Warning:** This is a low-level debugging tool and not subject to
|
|
Nomad's usual backward compatibility guarantees.
|
|
|
|
## Usage
|
|
|
|
```plaintext
|
|
nomad operator raft logs [options] <path to data dir>
|
|
```
|
|
|
|
## Examples
|
|
|
|
The output of this command can be very large, so it's recommended that
|
|
you redirect the output to a file for later examination with other
|
|
tools.
|
|
|
|
```shell-session
|
|
$ sudo nomad operator raft logs /var/nomad/data > ~/raft-logs.json
|
|
$ jq . < ~/raft-logs.json
|
|
```
|
|
|
|
[data directory]: /docs/configuration#data_dir
|