xrootd
XrdClMonitor.hh
Go to the documentation of this file.
1 //------------------------------------------------------------------------------
2 // Copyright (c) 2012 by the Board of Trustees of the Leland Stanford, Jr.,
3 // University
4 // Copyright (c) 2012 by European Organization for Nuclear Research (CERN)
5 // Author: Andrew Hanushevsky <abh@stanford.edu>
6 // Author: Lukasz Janyst <ljanyst@cern.ch>
7 //------------------------------------------------------------------------------
8 // XRootD is free software: you can redistribute it and/or modify
9 // it under the terms of the GNU Lesser General Public License as published by
10 // the Free Software Foundation, either version 3 of the License, or
11 // (at your option) any later version.
12 //
13 // XRootD is distributed in the hope that it will be useful,
14 // but WITHOUT ANY WARRANTY; without even the implied warranty of
15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 // GNU General Public License for more details.
17 //
18 // You should have received a copy of the GNU Lesser General Public License
19 // along with XRootD. If not, see <http://www.gnu.org/licenses/>.
20 //------------------------------------------------------------------------------
21 
22 //------------------------------------------------------------------------------
39 //------------------------------------------------------------------------------
40 
41 #ifndef __XRD_CL_MONITOR_HH__
42 #define __XRD_CL_MONITOR_HH__
43 
44 #include "XrdCl/XrdClFileSystem.hh"
45 
46 #include <sys/time.h>
47 
48 namespace XrdCl
49 {
50  class URL;
51 
52  //----------------------------------------------------------------------------
54  //----------------------------------------------------------------------------
55  class Monitor
56  {
57  public:
58  //------------------------------------------------------------------------
60  //------------------------------------------------------------------------
61  Monitor() {}
62 
63  //------------------------------------------------------------------------
65  //------------------------------------------------------------------------
66  virtual ~Monitor() {}
67 
68  //------------------------------------------------------------------------
70  //------------------------------------------------------------------------
71  struct ConnectInfo
72  {
74  {
75  sTOD.tv_sec = 0; sTOD.tv_usec = 0;
76  eTOD.tv_sec = 0; eTOD.tv_usec = 0;
77  }
78  std::string server;
79  std::string auth;
80  timeval sTOD;
81  timeval eTOD;
82  uint16_t streams;
83  };
84 
85  //------------------------------------------------------------------------
87  //------------------------------------------------------------------------
89  {
91  {}
92  std::string server;
93  uint64_t rBytes;
94  uint64_t sBytes;
95  time_t cTime;
97  };
98 
99  //------------------------------------------------------------------------
101  //------------------------------------------------------------------------
102  struct OpenInfo
103  {
104  OpenInfo(): file(0), fSize(0), oFlags(0) {}
105  const URL *file;
106  std::string dataServer;
107  uint64_t fSize;
108  uint16_t oFlags;
109  };
110 
111  //------------------------------------------------------------------------
113  //------------------------------------------------------------------------
114  struct CloseInfo
115  {
117  file(0), rBytes(0), vrBytes(0), wBytes(0), vwBytes(0), vSegs(0), rCount(0),
118  vCount(0), wCount(0), status(0)
119  {
120  oTOD.tv_sec = 0; oTOD.tv_usec = 0;
121  cTOD.tv_sec = 0; cTOD.tv_usec = 0;
122  }
123  const URL *file;
124  timeval oTOD;
125  timeval cTOD;
126  uint64_t rBytes;
127  uint64_t vrBytes;
128  uint64_t wBytes;
129  uint64_t vwBytes;
130  uint64_t vSegs;
131  uint32_t rCount;
132  uint32_t vCount;
133  uint32_t wCount;
135  };
136 
137  //------------------------------------------------------------------------
139  //------------------------------------------------------------------------
140  struct ErrorInfo
141  {
143  {
144  ErrOpen = 0,
149  ErrUnc
150  };
151 
152  ErrorInfo(): file(0), status(0), opCode( ErrUnc ) {}
153  const URL *file;
156  };
157 
158  //------------------------------------------------------------------------
160  //------------------------------------------------------------------------
162  {
164  const URL *origin;
165  const URL *target;
166  };
167 
168  //------------------------------------------------------------------------
172  //------------------------------------------------------------------------
173  struct CopyBInfo
174  {
176  };
177 
178  //------------------------------------------------------------------------
180  //------------------------------------------------------------------------
181  struct CopyEInfo
182  {
184  {
185  bTOD.tv_sec = 0; bTOD.tv_usec = 0;
186  eTOD.tv_sec = 0; eTOD.tv_usec = 0;
187  }
189  int sources;
190  timeval bTOD;
191  timeval eTOD;
193  };
194 
195  //------------------------------------------------------------------------
197  //------------------------------------------------------------------------
199  {
200  CheckSumInfo(): oTime(0), tTime(0), isOK(false) {}
202  std::string cksum;
203  uint64_t oTime;
204  uint64_t tTime;
205  bool isOK;
206  };
207 
208  //------------------------------------------------------------------------
211  //------------------------------------------------------------------------
213  {
221  EvDisconnect
222 
223  };
224 
225  //------------------------------------------------------------------------
232  //------------------------------------------------------------------------
233  virtual void Event( EventCode evCode, void *evData ) = 0;
234  };
235 }
236 
237 #endif // __XRD_CL_MONITOR_HH
An abstract class to describe the client-side monitoring plugin interface.
Definition: XrdClMonitor.hh:56
virtual ~Monitor()
Destructor.
Definition: XrdClMonitor.hh:66
Monitor()
Constructor.
Definition: XrdClMonitor.hh:61
EventCode
Definition: XrdClMonitor.hh:213
@ EvCopyBeg
CopyBInfo: Copy operation started.
Definition: XrdClMonitor.hh:214
@ EvDisconnect
DisconnectInfo: Logout from a server.
Definition: XrdClMonitor.hh:221
@ EvClose
CloseInfo: File closed.
Definition: XrdClMonitor.hh:218
@ EvCopyEnd
CopyEInfo: Copy operation ended.
Definition: XrdClMonitor.hh:215
@ EvCheckSum
CheckSumInfo: File checksummed.
Definition: XrdClMonitor.hh:216
@ EvErrIO
ErrorInfo: An I/O error occurred.
Definition: XrdClMonitor.hh:219
@ EvOpen
OpenInfo: File opened.
Definition: XrdClMonitor.hh:217
@ EvConnect
ConnectInfo: Login into a server.
Definition: XrdClMonitor.hh:220
virtual void Event(EventCode evCode, void *evData)=0
URL representation.
Definition: XrdClURL.hh:31
Request status.
Definition: XrdClXRootDResponses.hh:219
Definition: XrdClAction.hh:34
Describe a checksum event.
Definition: XrdClMonitor.hh:199
TransferInfo transfer
The transfer in question.
Definition: XrdClMonitor.hh:201
uint64_t tTime
Microseconds to obtain cksum from target.
Definition: XrdClMonitor.hh:204
bool isOK
True if checksum matched, false otherwise.
Definition: XrdClMonitor.hh:205
std::string cksum
Checksum as "type:value".
Definition: XrdClMonitor.hh:202
CheckSumInfo()
Definition: XrdClMonitor.hh:200
uint64_t oTime
Microseconds to obtain cksum from origin.
Definition: XrdClMonitor.hh:203
Describe a file close event.
Definition: XrdClMonitor.hh:115
uint64_t vwBytes
Total number of bytes written vie writev.
Definition: XrdClMonitor.hh:129
const XRootDStatus * status
Close status.
Definition: XrdClMonitor.hh:134
uint32_t wCount
Total count of writes.
Definition: XrdClMonitor.hh:133
CloseInfo()
Definition: XrdClMonitor.hh:116
uint64_t vSegs
Total count of readv segments.
Definition: XrdClMonitor.hh:130
uint64_t vrBytes
Total number of bytes read via readv.
Definition: XrdClMonitor.hh:127
timeval cTOD
gettimeofday() when file was closed
Definition: XrdClMonitor.hh:125
uint32_t vCount
Total count of readv.
Definition: XrdClMonitor.hh:132
const URL * file
The file in question.
Definition: XrdClMonitor.hh:123
uint64_t rBytes
Total number of bytes read via read.
Definition: XrdClMonitor.hh:126
timeval oTOD
gettimeofday() when file was opened
Definition: XrdClMonitor.hh:124
uint64_t wBytes
Total number of bytes written.
Definition: XrdClMonitor.hh:128
uint32_t rCount
Total count of reads.
Definition: XrdClMonitor.hh:131
Describe a server login event.
Definition: XrdClMonitor.hh:72
std::string server
"user@host:port"
Definition: XrdClMonitor.hh:78
uint16_t streams
Number of streams.
Definition: XrdClMonitor.hh:82
ConnectInfo()
Definition: XrdClMonitor.hh:73
timeval sTOD
gettimeofday() when login started
Definition: XrdClMonitor.hh:80
timeval eTOD
gettimeofday() when login ended
Definition: XrdClMonitor.hh:81
std::string auth
authentication protocol used or empty if none
Definition: XrdClMonitor.hh:79
Definition: XrdClMonitor.hh:174
TransferInfo transfer
The transfer in question.
Definition: XrdClMonitor.hh:175
Describe an end of copy event.
Definition: XrdClMonitor.hh:182
CopyEInfo()
Definition: XrdClMonitor.hh:183
TransferInfo transfer
The transfer in question.
Definition: XrdClMonitor.hh:188
int sources
Number of sources used for the copy.
Definition: XrdClMonitor.hh:189
timeval bTOD
Copy start time.
Definition: XrdClMonitor.hh:190
const XRootDStatus * status
Status of the copy.
Definition: XrdClMonitor.hh:192
timeval eTOD
Copy end time.
Definition: XrdClMonitor.hh:191
Describe a server logout event.
Definition: XrdClMonitor.hh:89
uint64_t rBytes
Number of bytes received.
Definition: XrdClMonitor.hh:93
Status status
Disconnection status.
Definition: XrdClMonitor.hh:96
std::string server
"user@host:port"
Definition: XrdClMonitor.hh:92
time_t cTime
Seconds connected to the server.
Definition: XrdClMonitor.hh:95
DisconnectInfo()
Definition: XrdClMonitor.hh:90
uint64_t sBytes
Number of bytes sent.
Definition: XrdClMonitor.hh:94
Describe an encountered file-based error.
Definition: XrdClMonitor.hh:141
Operation
Definition: XrdClMonitor.hh:143
@ ErrWrite
Write.
Definition: XrdClMonitor.hh:147
@ ErrReadV
Readv.
Definition: XrdClMonitor.hh:146
@ ErrUnc
Unclassified operation.
Definition: XrdClMonitor.hh:149
@ ErrOpen
Open (ditto)
Definition: XrdClMonitor.hh:144
@ ErrRead
Read.
Definition: XrdClMonitor.hh:145
@ ErrWriteV
WriteV.
Definition: XrdClMonitor.hh:148
const XRootDStatus * status
Status code.
Definition: XrdClMonitor.hh:154
const URL * file
The file in question.
Definition: XrdClMonitor.hh:153
Operation opCode
The associated operation.
Definition: XrdClMonitor.hh:155
ErrorInfo()
Definition: XrdClMonitor.hh:152
Describe a file open event to the monitor.
Definition: XrdClMonitor.hh:103
uint64_t fSize
File size in bytes.
Definition: XrdClMonitor.hh:107
const URL * file
File in question.
Definition: XrdClMonitor.hh:105
std::string dataServer
Actual fata server.
Definition: XrdClMonitor.hh:106
uint16_t oFlags
OpenFlags.
Definition: XrdClMonitor.hh:108
OpenInfo()
Definition: XrdClMonitor.hh:104
Describe the transfer.
Definition: XrdClMonitor.hh:162
const URL * target
URL of the target.
Definition: XrdClMonitor.hh:165
TransferInfo()
Definition: XrdClMonitor.hh:163
const URL * origin
URL of the origin.
Definition: XrdClMonitor.hh:164
Procedure execution status.
Definition: XrdClStatus.hh:115