Blame view

trunk/src/app/srs_app_kbps.hpp 6.4 KB
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
/*
The MIT License (MIT)

Copyright (c) 2013-2014 winlin

Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/

#ifndef SRS_APP_KBPS_HPP
#define SRS_APP_KBPS_HPP

/*
#include <srs_app_kbps.hpp>
*/

#include <srs_core.hpp>
33
#include <srs_protocol_io.hpp>
34 35

/**
36 37 38 39 40 41 42 43 44 45 46 47 48 49
* a kbps sample, for example, 1minute kbps, 
* 10minute kbps sample.
*/
class SrsKbpsSample
{
public:
    int64_t bytes;
    int64_t time;
    int kbps;
public:
    SrsKbpsSample();
};

/**
50
* a slice of kbps statistic, for input or output.
51 52 53 54 55 56 57 58 59 60
* a slice contains a set of sessions, which has a base offset of bytes,
* where a slice is:
*       starttime(oldest session startup time)
*               bytes(total bytes of previous sessions)
*               io_bytes_base(bytes offset of current session)
*                       last_bytes(bytes of current session)
* so, the total send bytes now is:
*       send_bytes = bytes + last_bytes - io_bytes_base
* so, the bytes sent duration current session is:
*       send_bytes = last_bytes - io_bytes_base
61 62
* @remark use set_io to start new session.
* @remakr the slice is a data collection object driven by SrsKbps.
63 64 65 66 67
*/
class SrsKbpsSlice
{
private:
    union slice_io {
68 69
        ISrsProtocolStatistic* in;
        ISrsProtocolStatistic* out;
70 71
    };
public:
72 73
    // the slice io used for SrsKbps to invoke,
    // the SrsKbpsSlice itself never use it.
74
    slice_io io;
75 76
    // session startup bytes
    // @remark, use total_bytes() to get the total bytes of slice.
77
    int64_t bytes;
78
    // slice starttime, the first time to record bytes.
79
    int64_t starttime;
80
    // session startup bytes number for io when set it,
81 82 83 84 85
    // the base offset of bytes for io.
    int64_t io_bytes_base;
    // last updated bytes number,
    // cache for io maybe freed.
    int64_t last_bytes;
86 87 88 89 90
    // samples
    SrsKbpsSample sample_30s;
    SrsKbpsSample sample_1m;
    SrsKbpsSample sample_5m;
    SrsKbpsSample sample_60m;
91
public:
92 93 94
    // for the delta bytes.
    int64_t delta_bytes;
public:
95 96
    SrsKbpsSlice();
    virtual ~SrsKbpsSlice();
97 98 99 100 101 102 103 104 105
public:
    /**
    * get current total bytes.
    */
    virtual int64_t get_total_bytes();
    /**
    * resample all samples.
    */
    virtual void sample();
106 107 108
};

/**
109 110 111 112 113 114 115 116 117 118 119 120 121
* the interface which provices delta of bytes.
*/
class IKbpsDelta
{
public:
    IKbpsDelta();
    virtual ~IKbpsDelta();
public:
    virtual int64_t get_send_bytes_delta() = 0;
    virtual int64_t get_recv_bytes_delta() = 0;
};

/**
122
* to statistic the kbps of io.
123 124 125 126 127 128 129 130 131 132 133 134 135 136
* itself can be a statistic source, for example, used for SRS bytes stat.
* there are two usage scenarios:
* 1. connections to calc kbps:
*       set_io(in, out)
*       sample()
*       get_xxx_kbps().
*   the connections know how many bytes already send/recv.
* 2. server to calc kbps:
*       set_io(NULL, NULL)
*       for each connection in connections:
*           add_delta(connections) // where connection is a IKbpsDelta*
*       sample()
*       get_xxx_kbps().
*   the server never know how many bytes already send/recv, for the connection maybe closed.
137
*/
138
class SrsKbps : public virtual ISrsProtocolStatistic, public virtual IKbpsDelta
139 140
{
private:
141 142
    SrsKbpsSlice is;
    SrsKbpsSlice os;
143 144 145 146
public:
    SrsKbps();
    virtual ~SrsKbps();
public:
147
    /**
148
    * set io to start new session.
149 150 151 152 153 154 155
    * set the underlayer reader/writer,
    * if the io destroied, for instance, the forwarder reconnect,
    * user must set the io of SrsKbps to NULL to continue to use the kbps object.
    * @param in the input stream statistic. can be NULL.
    * @param out the output stream statistic. can be NULL.
    * @remark if in/out is NULL, use the cached data for kbps.
    */
156
    virtual void set_io(ISrsProtocolStatistic* in, ISrsProtocolStatistic* out);
157
public:
158 159
    /**
    * get total kbps, duration is from the startup of io.
160
    * @remark, use sample() to update data.
161
    */
162 163
    virtual int get_send_kbps();
    virtual int get_recv_kbps();
164
    // 30s
165 166
    virtual int get_send_kbps_30s();
    virtual int get_recv_kbps_30s();
167
    // 5m
168 169
    virtual int get_send_kbps_5m();
    virtual int get_recv_kbps_5m();
170 171 172
public:
    /**
    * get the total send/recv bytes, from the startup of the oldest io.
173
    * @remark, use sample() to update data.
174 175 176
    */
    virtual int64_t get_send_bytes();
    virtual int64_t get_recv_bytes();
177 178 179 180 181 182
    /**
    * get the delta of send/recv bytes.
    * @remark, used for add_delta to calc the total system bytes/kbps.
    */
    virtual int64_t get_send_bytes_delta();
    virtual int64_t get_recv_bytes_delta();
183 184
public:
    /**
185 186 187 188 189 190 191 192 193 194 195 196
    * add delta to kbps clac mechenism.
    * we donot know the total bytes, but know the delta, for instance, 
    * for rtmp server to calc total bytes and kbps.
    * @remark user must invoke sample() when invoke this method.
    * @param delta, assert should never be NULL.
    */
    virtual void add_delta(IKbpsDelta* delta);
    /**
    * resample all samples, ignore if in/out is NULL.
    * used for user to calc the kbps, to sample new kbps value.
    * @remark if user, for instance, the rtmp server to calc the total bytes,
    *       use the add_delta() is better solutions.
197 198
    */
    virtual void sample();
199 200
};
201 202 203 204 205 206 207 208 209 210 211 212 213
/**
* the kbps limit, if exceed the kbps, slow down.
*/
class SrsKbpsLimit
{
private:
    int _limit_kbps;
    SrsKbps* _kbps;
public:
    SrsKbpsLimit(SrsKbps* kbps, int limit_kbps);
    virtual ~SrsKbpsLimit();
public:
    /**
214 215 216 217
    * get the system limit kbps.
    */
    virtual int limit_kbps();
    /**
218 219 220 221 222 223 224 225 226
    * limit the recv bandwidth.
    */
    virtual void recv_limit();
    /**
    * limit the send bandwidth.
    */
    virtual void send_limit();
};
227
#endif