/proc/self/cwd/source/server/admin/stats_handler.cc
Line | Count | Source (jump to first uncovered line) |
1 | | #include "source/server/admin/stats_handler.h" |
2 | | |
3 | | #include <functional> |
4 | | #include <vector> |
5 | | |
6 | | #include "envoy/admin/v3/mutex_stats.pb.h" |
7 | | #include "envoy/server/admin.h" |
8 | | |
9 | | #include "source/common/buffer/buffer_impl.h" |
10 | | #include "source/common/common/empty_string.h" |
11 | | #include "source/common/http/headers.h" |
12 | | #include "source/common/http/utility.h" |
13 | | #include "source/server/admin/prometheus_stats.h" |
14 | | #include "source/server/admin/stats_request.h" |
15 | | |
16 | | #include "absl/strings/numbers.h" |
17 | | |
18 | | namespace Envoy { |
19 | | namespace Server { |
20 | | |
21 | | const uint64_t RecentLookupsCapacity = 100; |
22 | | |
23 | 4.47k | StatsHandler::StatsHandler(Server::Instance& server) : HandlerContextBase(server) {} |
24 | | |
25 | | Http::Code StatsHandler::handlerResetCounters(Http::ResponseHeaderMap&, Buffer::Instance& response, |
26 | 0 | AdminStream&) { |
27 | 0 | for (const Stats::CounterSharedPtr& counter : server_.stats().counters()) { |
28 | 0 | counter->reset(); |
29 | 0 | } |
30 | 0 | server_.stats().symbolTable().clearRecentLookups(); |
31 | 0 | response.add("OK\n"); |
32 | 0 | return Http::Code::OK; |
33 | 0 | } |
34 | | |
35 | | Http::Code StatsHandler::handlerStatsRecentLookups(Http::ResponseHeaderMap&, |
36 | 0 | Buffer::Instance& response, AdminStream&) { |
37 | 0 | Stats::SymbolTable& symbol_table = server_.stats().symbolTable(); |
38 | 0 | std::string table; |
39 | 0 | const uint64_t total = |
40 | 0 | symbol_table.getRecentLookups([&table](absl::string_view name, uint64_t count) { |
41 | 0 | table += fmt::format("{:8d} {}\n", count, name); |
42 | 0 | }); |
43 | 0 | if (table.empty() && symbol_table.recentLookupCapacity() == 0) { |
44 | 0 | table = "Lookup tracking is not enabled. Use /stats/recentlookups/enable to enable.\n"; |
45 | 0 | } else { |
46 | 0 | response.add(" Count Lookup\n"); |
47 | 0 | } |
48 | 0 | response.add(absl::StrCat(table, "\ntotal: ", total, "\n")); |
49 | 0 | return Http::Code::OK; |
50 | 0 | } |
51 | | |
52 | | Http::Code StatsHandler::handlerStatsRecentLookupsClear(Http::ResponseHeaderMap&, |
53 | 0 | Buffer::Instance& response, AdminStream&) { |
54 | 0 | server_.stats().symbolTable().clearRecentLookups(); |
55 | 0 | response.add("OK\n"); |
56 | 0 | return Http::Code::OK; |
57 | 0 | } |
58 | | |
59 | | Http::Code StatsHandler::handlerStatsRecentLookupsDisable(Http::ResponseHeaderMap&, |
60 | | Buffer::Instance& response, |
61 | 0 | AdminStream&) { |
62 | 0 | server_.stats().symbolTable().setRecentLookupCapacity(0); |
63 | 0 | response.add("OK\n"); |
64 | 0 | return Http::Code::OK; |
65 | 0 | } |
66 | | |
67 | | Http::Code StatsHandler::handlerStatsRecentLookupsEnable(Http::ResponseHeaderMap&, |
68 | 0 | Buffer::Instance& response, AdminStream&) { |
69 | 0 | server_.stats().symbolTable().setRecentLookupCapacity(RecentLookupsCapacity); |
70 | 0 | response.add("OK\n"); |
71 | 0 | return Http::Code::OK; |
72 | 0 | } |
73 | | |
74 | 0 | Admin::RequestPtr StatsHandler::makeRequest(AdminStream& admin_stream) { |
75 | 0 | StatsParams params; |
76 | 0 | Buffer::OwnedImpl response; |
77 | 0 | Http::Code code = params.parse(admin_stream.getRequestHeaders().getPathValue(), response); |
78 | 0 | if (code != Http::Code::OK) { |
79 | 0 | return Admin::makeStaticTextRequest(response, code); |
80 | 0 | } |
81 | | |
82 | 0 | if (params.format_ == StatsFormat::Prometheus) { |
83 | | // TODO(#16139): modify streaming algorithm to cover Prometheus. |
84 | | // |
85 | | // This may be easiest to accomplish by populating the set |
86 | | // with tagExtractedName(), and allowing for vectors of |
87 | | // stats as multiples will have the same tag-extracted names. |
88 | | // Ideally we'd find a way to do this without slowing down |
89 | | // the non-Prometheus implementations. |
90 | 0 | Buffer::OwnedImpl response; |
91 | 0 | Http::Code code = prometheusFlushAndRender(params, response); |
92 | 0 | return Admin::makeStaticTextRequest(response, code); |
93 | 0 | } |
94 | | |
95 | 0 | if (server_.statsConfig().flushOnAdmin()) { |
96 | 0 | server_.flushStats(); |
97 | 0 | } |
98 | |
|
99 | 0 | bool active_mode; |
100 | 0 | #ifdef ENVOY_ADMIN_HTML |
101 | 0 | active_mode = params.format_ == StatsFormat::ActiveHtml; |
102 | | #else |
103 | | active_mode = false; |
104 | | #endif |
105 | 0 | return makeRequest( |
106 | 0 | server_.stats(), params, server_.clusterManager(), |
107 | 0 | [this, active_mode]() -> Admin::UrlHandler { return statsHandler(active_mode); }); |
108 | 0 | } |
109 | | |
110 | | Admin::RequestPtr StatsHandler::makeRequest(Stats::Store& stats, const StatsParams& params, |
111 | | const Upstream::ClusterManager& cluster_manager, |
112 | 0 | StatsRequest::UrlHandlerFn url_handler_fn) { |
113 | 0 | return std::make_unique<StatsRequest>(stats, params, cluster_manager, url_handler_fn); |
114 | 0 | } |
115 | | |
116 | | Http::Code StatsHandler::handlerPrometheusStats(Http::ResponseHeaderMap&, |
117 | | Buffer::Instance& response, |
118 | 0 | AdminStream& admin_stream) { |
119 | 0 | return prometheusStats(admin_stream.getRequestHeaders().getPathValue(), response); |
120 | 0 | } |
121 | | |
122 | | Http::Code StatsHandler::prometheusStats(absl::string_view path_and_query, |
123 | 0 | Buffer::Instance& response) { |
124 | 0 | StatsParams params; |
125 | 0 | Http::Code code = params.parse(path_and_query, response); |
126 | 0 | if (code != Http::Code::OK) { |
127 | 0 | return code; |
128 | 0 | } |
129 | | |
130 | 0 | if (server_.statsConfig().flushOnAdmin()) { |
131 | 0 | server_.flushStats(); |
132 | 0 | } |
133 | |
|
134 | 0 | return prometheusFlushAndRender(params, response); |
135 | 0 | } |
136 | | |
137 | | Http::Code StatsHandler::prometheusFlushAndRender(const StatsParams& params, |
138 | 0 | Buffer::Instance& response) { |
139 | 0 | absl::Status paramsStatus = PrometheusStatsFormatter::validateParams(params); |
140 | 0 | if (!paramsStatus.ok()) { |
141 | 0 | response.add(paramsStatus.message()); |
142 | 0 | return Http::Code::BadRequest; |
143 | 0 | } |
144 | 0 | if (server_.statsConfig().flushOnAdmin()) { |
145 | 0 | server_.flushStats(); |
146 | 0 | } |
147 | 0 | prometheusRender(server_.stats(), server_.api().customStatNamespaces(), server_.clusterManager(), |
148 | 0 | params, response); |
149 | 0 | return Http::Code::OK; |
150 | 0 | } |
151 | | |
152 | | void StatsHandler::prometheusRender(Stats::Store& stats, |
153 | | const Stats::CustomStatNamespaces& custom_namespaces, |
154 | | const Upstream::ClusterManager& cluster_manager, |
155 | 0 | const StatsParams& params, Buffer::Instance& response) { |
156 | 0 | const std::vector<Stats::TextReadoutSharedPtr>& text_readouts_vec = |
157 | 0 | params.prometheus_text_readouts_ ? stats.textReadouts() |
158 | 0 | : std::vector<Stats::TextReadoutSharedPtr>(); |
159 | 0 | PrometheusStatsFormatter::statsAsPrometheus(stats.counters(), stats.gauges(), stats.histograms(), |
160 | 0 | text_readouts_vec, cluster_manager, response, params, |
161 | 0 | custom_namespaces); |
162 | 0 | } |
163 | | |
164 | | Http::Code StatsHandler::handlerContention(Http::ResponseHeaderMap& response_headers, |
165 | 0 | Buffer::Instance& response, AdminStream&) { |
166 | |
|
167 | 0 | if (server_.options().mutexTracingEnabled() && server_.mutexTracer() != nullptr) { |
168 | 0 | response_headers.setReferenceContentType(Http::Headers::get().ContentTypeValues.Json); |
169 | |
|
170 | 0 | envoy::admin::v3::MutexStats mutex_stats; |
171 | 0 | mutex_stats.set_num_contentions(server_.mutexTracer()->numContentions()); |
172 | 0 | mutex_stats.set_current_wait_cycles(server_.mutexTracer()->currentWaitCycles()); |
173 | 0 | mutex_stats.set_lifetime_wait_cycles(server_.mutexTracer()->lifetimeWaitCycles()); |
174 | 0 | response.add(MessageUtil::getJsonStringFromMessageOrError(mutex_stats, true, true)); |
175 | 0 | } else { |
176 | 0 | response.add("Mutex contention tracing is not enabled. To enable, run Envoy with flag " |
177 | 0 | "--enable-mutex-tracing."); |
178 | 0 | } |
179 | 0 | return Http::Code::OK; |
180 | 0 | } |
181 | | |
182 | 4.47k | Admin::UrlHandler StatsHandler::statsHandler(bool active_mode) { |
183 | 4.47k | Admin::ParamDescriptor usedonly{ |
184 | 4.47k | Admin::ParamDescriptor::Type::Boolean, "usedonly", |
185 | 4.47k | "Only include stats that have been written by system since restart"}; |
186 | 4.47k | Admin::ParamDescriptor histogram_buckets{Admin::ParamDescriptor::Type::Enum, |
187 | 4.47k | "histogram_buckets", |
188 | 4.47k | "Histogram bucket display mode", |
189 | 4.47k | {"cumulative", "disjoint", "detailed", "summary"}}; |
190 | 4.47k | Admin::ParamDescriptor format{Admin::ParamDescriptor::Type::Enum, |
191 | 4.47k | "format", |
192 | 4.47k | "Format to use", |
193 | 4.47k | {"html", "active-html", "text", "json"}}; |
194 | 4.47k | Admin::ParamDescriptor filter{Admin::ParamDescriptor::Type::String, "filter", |
195 | 4.47k | "Regular expression (Google re2) for filtering stats"}; |
196 | 4.47k | Admin::ParamDescriptor type{Admin::ParamDescriptor::Type::Enum, |
197 | 4.47k | "type", |
198 | 4.47k | "Stat types to include.", |
199 | 4.47k | {StatLabels::All, StatLabels::Counters, StatLabels::Histograms, |
200 | 4.47k | StatLabels::Gauges, StatLabels::TextReadouts}}; |
201 | | |
202 | 4.47k | Admin::ParamDescriptorVec params{usedonly, filter}; |
203 | 4.47k | if (!active_mode) { |
204 | 4.47k | params.push_back(format); |
205 | 4.47k | } |
206 | 4.47k | params.push_back(type); |
207 | 4.47k | if (!active_mode) { |
208 | 4.47k | params.push_back(histogram_buckets); |
209 | 4.47k | } |
210 | | |
211 | 4.47k | return { |
212 | 4.47k | "/stats", |
213 | 4.47k | "print server stats", |
214 | 4.47k | [this](AdminStream& admin_stream) -> Admin::RequestPtr { return makeRequest(admin_stream); }, |
215 | 4.47k | false, |
216 | 4.47k | false, |
217 | 4.47k | params}; |
218 | 4.47k | } |
219 | | |
220 | | } // namespace Server |
221 | | } // namespace Envoy |