mirror of https://github.com/pvnis/srsRAN_4G.git
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
109 lines
3.9 KiB
C++
109 lines
3.9 KiB
C++
/**
|
|
* Copyright 2013-2021 Software Radio Systems Limited
|
|
*
|
|
* This file is part of srsRAN.
|
|
*
|
|
* srsRAN is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License as
|
|
* published by the Free Software Foundation, either version 3 of
|
|
* the License, or (at your option) any later version.
|
|
*
|
|
* srsRAN is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU Affero General Public License for more details.
|
|
*
|
|
* A copy of the GNU Affero General Public License can be found in
|
|
* the LICENSE file in the top-level directory of this distribution
|
|
* and at http://www.gnu.org/licenses/.
|
|
*
|
|
*/
|
|
|
|
#ifndef SRSLOG_EVENT_TRACE_H
|
|
#define SRSLOG_EVENT_TRACE_H
|
|
|
|
#include <chrono>
|
|
#include <string>
|
|
|
|
namespace srslog {
|
|
|
|
class log_channel;
|
|
|
|
/// The event tracing framework allows to trace any kind of event inside an
|
|
/// application.
|
|
/// To enable event tracing the ENABLE_SRSLOG_EVENT_TRACE macro symbol should
|
|
/// be defined, otherwise calls to the tracing framework will be ignored. This
|
|
/// is important to avoid the overhead of tracing when it is not required.
|
|
/// For details about each event trace type please refer to:
|
|
/// https://docs.google.com/document/d/1CvAClvFfyA5R-PhYUmn5OOQtYMH4h6I0nSsKchNAySU/edit
|
|
|
|
/// Initializes the event trace framework saving the trace events to a
|
|
/// "event_trace.log" file.
|
|
void event_trace_init();
|
|
|
|
/// Initializes the event trace framework using the specified log channel to log
|
|
/// all trace events.
|
|
void event_trace_init(log_channel& c);
|
|
|
|
/// Initializes the event trace framework.
|
|
/// The event trace data will be written into the specified filename after
|
|
/// capacity bytes of data have been generated or at program exit.
|
|
/// Returns true on success, otherwise false.
|
|
bool event_trace_init(const std::string& filename, std::size_t capacity = 1024 * 1024);
|
|
|
|
#ifdef ENABLE_SRSLOG_EVENT_TRACE
|
|
|
|
/// Generates the begin phase of a duration event.
|
|
void trace_duration_begin(const std::string& category, const std::string& name);
|
|
|
|
/// Generates the end phase of a duration event.
|
|
void trace_duration_end(const std::string& category, const std::string& name);
|
|
|
|
#define SRSLOG_TRACE_COMBINE1(X, Y) X##Y
|
|
#define SRSLOG_TRACE_COMBINE(X, Y) SRSLOG_TRACE_COMBINE1(X, Y)
|
|
|
|
/// Generates a complete event.
|
|
#define trace_complete_event(C, N) \
|
|
auto SRSLOG_TRACE_COMBINE(scoped_complete_event, __LINE__) = srslog::detail::scoped_complete_event(C, N)
|
|
|
|
/// Generates a complete event but only is recorded if the event duration exceeds a certain threshold in microseconds.
|
|
#define trace_threshold_complete_event(C, N, T) \
|
|
auto SRSLOG_TRACE_COMBINE(scoped_complete_event, __LINE__) = srslog::detail::scoped_complete_event(C, N, T)
|
|
|
|
#else
|
|
|
|
/// No-ops.
|
|
#define trace_duration_begin(C, N)
|
|
#define trace_duration_end(C, N)
|
|
#define trace_complete_event(C, N)
|
|
#define trace_threshold_complete_event(C, N, T)
|
|
|
|
#endif
|
|
|
|
namespace detail {
|
|
|
|
/// Scoped type object for implementing a complete event.
|
|
class scoped_complete_event
|
|
{
|
|
public:
|
|
scoped_complete_event(const char* cat,
|
|
const char* n,
|
|
std::chrono::microseconds threshold = std::chrono::microseconds::zero()) :
|
|
category(cat), name(n), start(std::chrono::steady_clock::now()), threshold(threshold)
|
|
{}
|
|
|
|
~scoped_complete_event();
|
|
|
|
private:
|
|
const char* const category;
|
|
const char* const name;
|
|
std::chrono::time_point<std::chrono::steady_clock> start;
|
|
std::chrono::microseconds threshold;
|
|
};
|
|
|
|
} // namespace detail
|
|
|
|
} // namespace srslog
|
|
|
|
#endif // SRSLOG_EVENT_TRACE_H
|