1CONTAINER-EXCEPTION(1)                                  CONTAINER-EXCEPTION(1)
2
3
4

NAME

6       container-exception-logger - log from a container to a host
7

SYNOPSIS

9       container-exception-logger [--no-tag | --tag TAG | --help]
10

DESCRIPTION

12       A tool designed to run inside of a container which can get its input
13       outside of the container.
14
15       --no-tag
16           do not add tag container-exception-logger at the beginning of log
17           message
18
19       --tag TAG
20           define your own tag which will be added at the beginning of log
21           message
22

INPUT FORMAT SPECIFICATION

24       It’s possible to use whatever format of a message you want. Openshift
25       logging system (fluentd) and ABRT use JSON. For this reason, we
26       recommend using JSON too.
27
28   Mandatory elements
29       Tools which parse container-exception-logger messages expecting the
30       messages contain following elements:
31
32       type
33           string - exception type - Python, Python3, Ruby, etc.
34
35       executable
36           string - the executable which caused the problem
37
38       reason
39           string - the reason for the problem
40
41       backtrace
42           string - the backtrace of the problem
43
44       time
45           int - seconds since 1970-01-01 00:00:00 UTC
46
47   Optional elements
48       Additional elements can be added without any limitation. For instance
49       pid, uid, msg, etc.
50

EXAMPLES

52       Example of an input message:
53
54           {"type": "Python3", "executable": "/usr/bin/will_python3_raise", "reason":
55           "will_python3_raise:3:<module>:ZeroDivisionError: division by zero",
56           "backtrace": "will_python3_raise:3:<module>:ZeroDivisionError: division by
57           zero\n\nTraceback (most recent call last):\n  File
58           \"/usr/bin/will_python3_raise\", line 3, in <module>\n", "time": 1521454815,
59           "pid": 23}
60
61       Example of the tool usage (MSG variable represents the message above):
62
63           Container:
64            $ echo $MSG | container-exception-logger
65           Host's log:
66            Mar 19 14:59:04 localhost dockerd-current[981]: container-exception-logger - $MSG
67
68           Container:
69            $ echo $MSG | container-exception-logger --no-tag
70           Host's log:
71            Mar 19 15:00:27 localhost dockerd-current[981]: $MSG
72
73           Container:
74            $ echo $MSG | container-exception-logger --tag new-tag
75           Host's log:
76            Mar 19 15:00:27 localhost dockerd-current[981]: new-tag - $MSG
77

AUTHORS

79       ·   ABRT team
80
81
82
83                                  05/13/2019            CONTAINER-EXCEPTION(1)
Impressum