summaryrefslogtreecommitdiff
path: root/indra/llcommon/llmetricperformancetester.h
blob: 15c564f2ca5021196b224659f31203f805af9514 (plain)
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
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
/**
 * @file llmetricperformancetester.h
 * @brief LLMetricPerformanceTesterBasic and LLMetricPerformanceTesterWithSession classes definition
 *
 * $LicenseInfo:firstyear=2004&license=viewerlgpl$
 * Second Life Viewer Source Code
 * Copyright (C) 2010, Linden Research, Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation;
 * version 2.1 of the License only.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 *
 * Linden Research, Inc., 945 Battery Street, San Francisco, CA  94111  USA
 * $/LicenseInfo$
 */

#ifndef LL_METRICPERFORMANCETESTER_H
#define LL_METRICPERFORMANCETESTER_H

char const* const DEFAULT_METRIC_NAME = "metric";

/**
 * @class LLMetricPerformanceTesterBasic
 * @brief Performance Metric Base Class
 */
class LL_COMMON_API LLMetricPerformanceTesterBasic
{
public:
    /**
     * @brief Creates a basic tester instance.
     * @param[in] name - Unique string identifying this tester instance.
     */
    LLMetricPerformanceTesterBasic(std::string name);
    virtual ~LLMetricPerformanceTesterBasic();

    /**
     * @return Returns true if the instance has been added to the tester map.
     * Need to be tested after creation of a tester instance so to know if the tester is correctly handled.
     * A tester might not be added to the map if another tester with the same name already exists.
     */
    BOOL isValid() const { return mValidInstance; }

    /**
     * @brief Write a set of test results to the log LLSD.
     */
    void outputTestResults() ;

    /**
     * @brief Compare the test results.
     * By default, compares the test results against the baseline one by one, item by item,
     * in the increasing order of the LLSD record counter, starting from the first one.
     */
    virtual void analyzePerformance(llofstream* os, LLSD* base, LLSD* current) ;

    static void doAnalysisMetrics(std::string baseline, std::string target, std::string output) ;

    /**
     * @return Returns the number of the test metrics in this tester instance.
     */
    auto getNumberOfMetrics() const { return mMetricStrings.size() ;}
    /**
     * @return Returns the metric name at index
     * @param[in] index - Index on the list of metrics managed by this tester instance.
     */
    std::string getMetricName(size_t index) const { return mMetricStrings[index] ;}

protected:
    /**
     * @return Returns the name of this tester instance.
     */
    std::string getTesterName() const { return mName ;}

    /**
     * @brief Insert a new metric to be managed by this tester instance.
     * @param[in] str - Unique string identifying the new metric.
     */
    void addMetric(std::string str) ;

    /**
     * @brief Compare test results, provided in 2 flavors: compare integers and compare floats.
     * @param[out] os - Formatted output string holding the compared values.
     * @param[in] metric_string - Name of the metric.
     * @param[in] v_base - Base value of the metric.
     * @param[in] v_current - Current value of the metric.
     */
    virtual void compareTestResults(llofstream* os, std::string metric_string, S32 v_base, S32 v_current) ;
    virtual void compareTestResults(llofstream* os, std::string metric_string, F32 v_base, F32 v_current) ;

    /**
     * @brief Reset internal record count. Count starts with 1.
     */
    void resetCurrentCount() { mCount = 1; }
    /**
     * @brief Increment internal record count.
     */
    void incrementCurrentCount() { mCount++; }
    /**
     * @return Returns the label to be used for the current count. It's "TesterName"-"Count".
     */
    std::string getCurrentLabelName() const { return llformat("%s-%d", mName.c_str(), mCount) ;}

    /**
     * @brief Write a test record to the LLSD. Implementers need to overload this method.
     * @param[out] sd - The LLSD record to store metric data into.
     */
    virtual void outputTestRecord(LLSD* sd) = 0 ;

private:
    void preOutputTestResults(LLSD* sd) ;
    void postOutputTestResults(LLSD* sd) ;
    static LLSD analyzeMetricPerformanceLog(std::istream& is) ;

    std::string mName ;                         // Name of this tester instance
    S32 mCount ;                                // Current record count
    BOOL mValidInstance;                        // TRUE if the instance is managed by the map
    std::vector< std::string > mMetricStrings ; // Metrics strings

// Static members managing the collection of testers
public:
    // Map of all the tester instances in use
    typedef std::map< std::string, LLMetricPerformanceTesterBasic* > name_tester_map_t;
    static name_tester_map_t sTesterMap ;

    /**
     * @return Returns a pointer to the tester
     * @param[in] name - Name of the tester instance queried.
     */
    static LLMetricPerformanceTesterBasic* getTester(std::string name) ;

    /**
     * @return Delete the named tester from the list
     * @param[in] name - Name of the tester instance to delete.
     */
    static void deleteTester(std::string name);

    /**
     * @return Returns TRUE if that metric *or* the default catch all metric has been requested to be logged
     * @param[in] name - Name of the tester queried.
     */
    static BOOL isMetricLogRequested(std::string name);

    /**
     * @return Returns TRUE if there's a tester defined, FALSE otherwise.
     */
    static BOOL hasMetricPerformanceTesters() { return !sTesterMap.empty() ;}
    /**
     * @brief Delete all testers and reset the tester map
     */
    static void cleanupClass() ;

private:
    // Add a tester to the map. Returns false if adding fails.
    static BOOL addTester(LLMetricPerformanceTesterBasic* tester) ;
};

/**
 * @class LLMetricPerformanceTesterWithSession
 * @brief Performance Metric Class with custom session
 */
class LL_COMMON_API LLMetricPerformanceTesterWithSession : public LLMetricPerformanceTesterBasic
{
public:
    /**
     * @param[in] name - Unique string identifying this tester instance.
     */
    LLMetricPerformanceTesterWithSession(std::string name);
    virtual ~LLMetricPerformanceTesterWithSession();

    /**
     * @brief Compare the test results.
     * This will be loading the base and current sessions and compare them using the virtual
     * abstract methods loadTestSession() and compareTestSessions()
     */
    virtual void analyzePerformance(llofstream* os, LLSD* base, LLSD* current) ;

protected:
    /**
     * @class LLMetricPerformanceTesterWithSession::LLTestSession
     * @brief Defines an interface for the two abstract virtual functions loadTestSession() and compareTestSessions()
     */
    class LL_COMMON_API LLTestSession
        {
        public:
            virtual ~LLTestSession() ;
        };

    /**
     * @brief Convert an LLSD log into a test session.
     * @param[in] log - The LLSD record
     * @return Returns the record as a test session
     */
    virtual LLMetricPerformanceTesterWithSession::LLTestSession* loadTestSession(LLSD* log) = 0;

    /**
     * @brief Compare the base session and the target session. Assumes base and current sessions have been loaded.
     * @param[out] os - The comparison result as a standard stream
     */
    virtual void compareTestSessions(llofstream* os) = 0;

    LLTestSession* mBaseSessionp;
    LLTestSession* mCurrentSessionp;
};

#endif