1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
```{eval-rst}
.. currentmodule:: tango
```
(logging)=
# Server logging in Python
This chapter instructs you on how to use the tango logging API (log4tango) to
create tango log messages on your device server.
The logging system explained here is the Tango Logging Service (TLS). For
detailed information on how this logging system works please check:
> - [Usage](https://tango-controls.readthedocs.io/en/latest/development/device-api/device-server-model.html#the-tango-logging-service)
> - [Property reference](https://tango-controls.readthedocs.io/en/latest/development/advanced/reference.html#the-device-logging)
The easiest way to start seeing log messages on your device server console is
by starting it with the verbose option. Example:
```
python PyDsExp.py PyDs1 -v4
```
This activates the console tango logging target and filters messages with
importance level DEBUG or more.
The links above provided detailed information on how to configure log levels
and log targets. In this document we will focus on how to write log messages on
your device server.
## Basic logging
The most basic way to write a log message on your device is to use the
{class}`~tango.server.Device` logging related methods:
> - {meth}`~tango.server.Device.debug_stream`
> - {meth}`~tango.server.Device.info_stream`
> - {meth}`~tango.server.Device.warn_stream`
> - {meth}`~tango.server.Device.error_stream`
> - {meth}`~tango.server.Device.fatal_stream`
Example:
```
def read_voltage(self):
self.info_stream("read voltage attribute")
# ...
return voltage_value
```
This will print a message like:
```
1282206864 [-1215867200] INFO test/power_supply/1 read voltage attribute
```
every time a client asks to read the *voltage* attribute value.
The logging methods support argument list feature (since PyTango 8.1). Example:
```
def read_voltage(self):
self.info_stream("read_voltage(%s, %d)", self.host, self.port)
# ...
return voltage_value
```
## Logging with print statement
*This feature is only possible since PyTango 7.1.3*
It is possible to use the print statement to log messages into the tango logging
system. This is achieved by using the python's print extend form sometimes
refered to as *print chevron*.
Same example as above, but now using *print chevron*:
```
def read_voltage(self, the_att):
print >>self.log_info, "read voltage attribute"
# ...
return voltage_value
```
Or plain print:
```
def read_Long_attr(self, the_att):
print("read voltage attribute", file=self.log_info)
# ...
return voltage_value
```
## Logging with decorators
*This feature is only possible since PyTango 7.1.3*
PyTango provides a set of decorators that place automatic log messages when
you enter and when you leave a python method. For example:
```
@tango.DebugIt()
def read_Long_attr(self, the_att):
the_att.set_value(self.attr_long)
```
will generate a pair of log messages each time a client asks for the 'Long_attr'
value. Your output would look something like:
```
1282208997 [-1215965504] DEBUG test/pydsexp/1 -> read_Long_attr()
1282208997 [-1215965504] DEBUG test/pydsexp/1 <- read_Long_attr()
```
Decorators exist for all tango log levels:
: - {class}`tango.DebugIt`
- {class}`tango.InfoIt`
- {class}`tango.WarnIt`
- {class}`tango.ErrorIt`
- {class}`tango.FatalIt`
The decorators receive three optional arguments:
: - show_args - shows method arguments in log message (defaults to False)
- show_kwargs shows keyword method arguments in log message (defaults to False)
- show_ret - shows return value in log message (defaults to False)
Example:
```
@tango.DebugIt(show_args=True, show_ret=True)
def IOLong(self, in_data):
return in_data * 2
```
will output something like:
```
1282221947 [-1261438096] DEBUG test/pydsexp/1 -> IOLong(23)
1282221947 [-1261438096] DEBUG test/pydsexp/1 46 <- IOLong()
```
|
