Skip to content

Commit

Permalink
Merge pull request #2189 from yujuhong/cri-log-format
Browse files Browse the repository at this point in the history
Update the documentation of CRI log format
  • Loading branch information
k8s-ci-robot committed May 25, 2018
2 parents 3b5dc10 + 31e0993 commit fa89031
Showing 1 changed file with 14 additions and 3 deletions.
17 changes: 14 additions & 3 deletions contributors/design-proposals/node/kubelet-cri-logging.md
Expand Up @@ -142,11 +142,22 @@ extend this by maintaining a metadata file in the pod directory.
**Log format**

The runtime should decorate each log entry with a RFC 3339Nano timestamp
prefix, the stream type (i.e., "stdout" or "stderr"), and ends with a newline.
prefix, the stream type (i.e., "stdout" or "stderr"), the tags of the log
entry, the log content that ends with a newline.

The `tags` fields can support multiple tags, delimited by `:`. Currently, only
one tag is defined in CRI to support multi-line log entries: partial or full.
Partial (`P`) is used when a log entry is split into multiple lines by the
runtime, and the entry has not ended yet. Full (`F`) indicates that the log
entry is completed -- it is either a single-line entry, or this is the last
line of the muiltple-line entry.

For example,
```
2016-10-06T00:17:09.669794202Z stdout The content of the log entry 1
2016-10-06T00:17:10.113242941Z stderr The content of the log entry 2
2016-10-06T00:17:09.669794202Z stdout F The content of the log entry 1
2016-10-06T00:17:09.669794202Z stdout P First line of log entry 2
2016-10-06T00:17:09.669794202Z stdout P Second line of the log entry 2
2016-10-06T00:17:10.113242941Z stderr F Last line of the log entry 2
```

With the knowledge, kubelet can parses the logs and serve them for `kubectl
Expand Down

0 comments on commit fa89031

Please sign in to comment.