p4 journals
Synopsis
Display history of checkpoint and journal activity for the server.
Syntax
p4 [g-opts
] journals [-F
filter
] [-T
fields
] [-m
max
]
Description
Use the p4 journals
command to display information from the
db.ckphist
table, which holds historical information about checkpoint
and journal activity. A server uses this table to record the following
checkpoint and journal events:
- the server takes a checkpoint
- the server rotates a journal
- the server replays a journal
- a replica schedules a checkpoint
Each server in a multi-server installation has its own, unique
db.ckphist
table. That is, the table is not replicated to replicas.
This table is not part of the main server database; it’s not journaled,
and it does not need to be backed up. It is not included in checkpoints.
If anything goes wrong, it can be thrown away.
Here’s an example of the output from p4 journals
.
mbp-jbujes:~ jbujes$ p4 -p qaplay:20141 journals ... start 1381278576 ... startDate 2013/10/08 17:29:36 ... end 1381278576 ... endDate 2013/10/08 17:29:36 ... pid 19960 ... type checkpoint ... flags ... jnum 19 ... jfile checkpoint.19 ... jdate 1381278576 ... jdateDate 2013/10/08 17:29:36 ... jdigest E4EB1FF5B589D05E9F5A8EE1F8183A86 ... jsize 27183115 ... jtype text ... failed 0 ... errmsg ... start 1381278576 ... startDate 2013/10/08 17:29:36 ... end 1381278576 ... endDate 2013/10/08 17:29:36 ... pid 19960 ... type checkpoint ... flags ... jnum 18 ... jfile journal.18 ... jdate 1381278575 ... jdateDate 2013/10/08 17:29:35 ... jdigest 00000000000000000000000000000000 ... jsize 15737 ... jtype text ... failed 1 ... errmsg ... start 1374629669 ... startDate 2013/07/23 18:34:29 ... end 1374629669 ... endDate 2013/07/23 18:34:29 ... pid 14700 ... type replay ... flags -r . -j r ... jnum -1 ... jfile basis.ckp ... jdate 1366076427 ... jdateDate 2013/04/15 18:40:27 ... jdigest 00000000000000000000000000000000 ... jsize 27181640 ... jtype text ... failed 1 ... errmsg
This command displays full error message text for a failed checkpoint.
Use the global -F
option to format the output from the p4
journals
; for example:
p4 -F "%jfile% %jnum%" journals -F type=checkpoint
The meaning of each field is described in the following table. Output entries are listed from newest event to oldest event.
|
Starting Unix timestamp of the command that ran. See type field to determine which command was executed. |
|
Human-readable form of start value. |
|
Ending Unix timestamp of the command that ran. |
|
Human-readable form of end value. |
|
The process id of the command whose execution produced this record. This value can be useful in searching for related entries in other logs. |
|
Indicates the command whose execution produced this record. Types include the following:
|
|
Flags passed to the command implied by the type filed. |
|
The checkpoint number. A value of -1 indicates that the journal number is unknown. |
|
The name of a journal or checkpoint file that was input to the command implied by the type field. |
|
Unix timestamp when the filed specified by |
|
Human-readable format of |
|
The digest of the checkpoint file. |
|
The size of the file specified by |
|
The type of the file specified by |
Options
|
List only the records that satisfy the filter expression. For instructions on constructing the filter expression, see Job Views. |
|
Limit output to the specified number of records. |
|
Limit output to the specified fields. Separate fields using a comma or a space. |
|
See “Global Options”. |
Usage Notes
Can File Arguments Use Revision Specifier? | Can File Arguments Use Revision Range? | Minimal Access Level Required |
---|---|---|
N/A |
N/A |
|