Coverage Report

Created: 2026-04-10 05:02

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
be/src/storage/compaction_task_tracker.cpp
Line
Count
Source
1
// Licensed to the Apache Software Foundation (ASF) under one
2
// or more contributor license agreements.  See the NOTICE file
3
// distributed with this work for additional information
4
// regarding copyright ownership.  The ASF licenses this file
5
// to you under the Apache License, Version 2.0 (the
6
// "License"); you may not use this file except in compliance
7
// with the License.  You may obtain a copy of the License at
8
//
9
//   http://www.apache.org/licenses/LICENSE-2.0
10
//
11
// Unless required by applicable law or agreed to in writing,
12
// software distributed under the License is distributed on an
13
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
// KIND, either express or implied.  See the License for the
15
// specific language governing permissions and limitations
16
// under the License.
17
18
#include "storage/compaction_task_tracker.h"
19
20
#include "common/config.h"
21
#include "common/logging.h"
22
23
namespace doris {
24
25
13.7k
const char* to_string(CompactionProfileType type) {
26
13.7k
    switch (type) {
27
56
    case CompactionProfileType::BASE:
28
56
        return "base";
29
13.6k
    case CompactionProfileType::CUMULATIVE:
30
13.6k
        return "cumulative";
31
42
    case CompactionProfileType::FULL:
32
42
        return "full";
33
13.7k
    }
34
0
    return "unknown";
35
13.7k
}
36
37
12.0k
const char* to_string(CompactionTaskStatus status) {
38
12.0k
    switch (status) {
39
0
    case CompactionTaskStatus::PENDING:
40
0
        return "PENDING";
41
11
    case CompactionTaskStatus::RUNNING:
42
11
        return "RUNNING";
43
11.9k
    case CompactionTaskStatus::FINISHED:
44
11.9k
        return "FINISHED";
45
54
    case CompactionTaskStatus::FAILED:
46
54
        return "FAILED";
47
12.0k
    }
48
0
    return "UNKNOWN";
49
12.0k
}
50
51
13.7k
const char* to_string(TriggerMethod method) {
52
13.7k
    switch (method) {
53
11.9k
    case TriggerMethod::AUTO:
54
11.9k
        return "AUTO";
55
1.80k
    case TriggerMethod::MANUAL:
56
1.80k
        return "MANUAL";
57
0
    case TriggerMethod::LOAD_TRIGGERED:
58
0
        return "LOAD_TRIGGERED";
59
13.7k
    }
60
0
    return "UNKNOWN";
61
13.7k
}
62
63
240k
CompactionTaskTracker* CompactionTaskTracker::instance() {
64
240k
    static CompactionTaskTracker s_instance;
65
240k
    return &s_instance;
66
240k
}
67
68
6.90k
void CompactionTaskTracker::register_task(CompactionTaskInfo info) {
69
6.90k
    if (!config::enable_compaction_task_tracker) {
70
1
        return;
71
1
    }
72
6.90k
    std::unique_lock wlock(_mutex);
73
6.90k
    _active_tasks[info.compaction_id] = std::move(info);
74
6.90k
}
75
76
6.54k
void CompactionTaskTracker::update_to_running(int64_t compaction_id, const RunningStats& stats) {
77
6.54k
    if (!config::enable_compaction_task_tracker) {
78
0
        return;
79
0
    }
80
6.54k
    std::unique_lock wlock(_mutex);
81
6.54k
    auto it = _active_tasks.find(compaction_id);
82
6.54k
    if (it != _active_tasks.end()) {
83
6.54k
        auto& task = it->second;
84
6.54k
        task.status = CompactionTaskStatus::RUNNING;
85
6.54k
        task.start_time_ms = stats.start_time_ms;
86
6.54k
        task.is_vertical = stats.is_vertical;
87
6.54k
        task.permits = stats.permits;
88
6.54k
    }
89
6.54k
}
90
91
void CompactionTaskTracker::update_progress(int64_t compaction_id, int64_t total_groups,
92
26.0k
                                            int64_t completed_groups) {
93
26.0k
    if (!config::enable_compaction_task_tracker) {
94
0
        return;
95
0
    }
96
26.0k
    std::unique_lock wlock(_mutex);
97
26.0k
    auto it = _active_tasks.find(compaction_id);
98
26.0k
    if (it != _active_tasks.end()) {
99
23.6k
        auto& task = it->second;
100
23.6k
        task.vertical_total_groups = total_groups;
101
23.6k
        task.vertical_completed_groups = completed_groups;
102
23.6k
    }
103
26.0k
}
104
105
6.35k
void CompactionTaskTracker::complete(int64_t compaction_id, const CompletionStats& stats) {
106
6.35k
    if (!config::enable_compaction_task_tracker) {
107
0
        return;
108
0
    }
109
6.35k
    std::unique_lock wlock(_mutex);
110
6.35k
    auto it = _active_tasks.find(compaction_id);
111
6.35k
    if (it == _active_tasks.end()) {
112
1
        LOG(WARNING) << "compaction_id " << compaction_id << " not found in active_tasks, skip";
113
1
        return;
114
1
    }
115
116
    // Extract the task from active map.
117
6.35k
    auto node = _active_tasks.extract(it);
118
6.35k
    CompactionTaskInfo& info = node.mapped();
119
6.35k
    info.status = CompactionTaskStatus::FINISHED;
120
6.35k
    _apply_completion(info, stats);
121
122
6.36k
    if (config::compaction_task_tracker_max_records > 0) {
123
6.36k
        _completed_tasks.push_back(std::move(info));
124
6.36k
        _trim_completed_locked();
125
6.36k
    }
126
6.35k
}
127
128
void CompactionTaskTracker::fail(int64_t compaction_id, const CompletionStats& stats,
129
186
                                 const std::string& msg) {
130
186
    if (!config::enable_compaction_task_tracker) {
131
0
        return;
132
0
    }
133
186
    std::unique_lock wlock(_mutex);
134
186
    auto it = _active_tasks.find(compaction_id);
135
186
    if (it == _active_tasks.end()) {
136
1
        LOG(WARNING) << "compaction_id " << compaction_id << " not found in active_tasks, skip";
137
1
        return;
138
1
    }
139
140
    // Extract the task from active map.
141
185
    auto node = _active_tasks.extract(it);
142
185
    CompactionTaskInfo& info = node.mapped();
143
185
    info.status = CompactionTaskStatus::FAILED;
144
185
    info.status_msg = msg;
145
185
    _apply_completion(info, stats);
146
147
185
    if (config::compaction_task_tracker_max_records > 0) {
148
185
        _completed_tasks.push_back(std::move(info));
149
185
        _trim_completed_locked();
150
185
    }
151
185
}
152
153
6.86k
void CompactionTaskTracker::remove_task(int64_t compaction_id) {
154
6.86k
    if (!config::enable_compaction_task_tracker) {
155
0
        return;
156
0
    }
157
6.86k
    std::unique_lock wlock(_mutex);
158
6.86k
    _active_tasks.erase(compaction_id); // idempotent: no-op if already removed
159
6.86k
}
160
161
void CompactionTaskTracker::_apply_completion(CompactionTaskInfo& info,
162
6.55k
                                              const CompletionStats& stats) {
163
6.55k
    info.end_time_ms = stats.end_time_ms;
164
6.55k
    info.merged_rows = stats.merged_rows;
165
6.55k
    info.filtered_rows = stats.filtered_rows;
166
6.55k
    info.output_rows = stats.output_rows;
167
6.55k
    info.output_row_num = stats.output_row_num;
168
6.55k
    info.output_data_size = stats.output_data_size;
169
6.55k
    info.output_index_size = stats.output_index_size;
170
6.55k
    info.output_total_size = stats.output_total_size;
171
6.55k
    info.output_segments_num = stats.output_segments_num;
172
6.55k
    info.output_version = stats.output_version;
173
6.55k
    info.merge_latency_ms = stats.merge_latency_ms;
174
6.55k
    info.bytes_read_from_local = stats.bytes_read_from_local;
175
6.55k
    info.bytes_read_from_remote = stats.bytes_read_from_remote;
176
6.55k
    info.peak_memory_bytes = stats.peak_memory_bytes;
177
    // Backfill input stats if they were 0 at register time.
178
    // Local compaction populates _input_rowsets_data_size etc. in build_basic_info()
179
    // which runs inside execute_compact_impl(), after register_task().
180
6.55k
    if (info.input_version_range.empty() && !stats.input_version_range.empty()) {
181
0
        info.input_version_range = stats.input_version_range;
182
0
    }
183
6.55k
    if (info.input_rowsets_count == 0 && stats.input_rowsets_count > 0) {
184
0
        info.input_rowsets_count = stats.input_rowsets_count;
185
0
    }
186
6.55k
    if (info.input_row_num == 0 && stats.input_row_num > 0) {
187
24
        info.input_row_num = stats.input_row_num;
188
24
    }
189
6.55k
    if (info.input_data_size == 0 && stats.input_data_size > 0) {
190
24
        info.input_data_size = stats.input_data_size;
191
24
    }
192
6.55k
    if (info.input_index_size == 0 && stats.input_index_size > 0) {
193
0
        info.input_index_size = stats.input_index_size;
194
0
    }
195
6.55k
    if (info.input_total_size == 0 && stats.input_total_size > 0) {
196
24
        info.input_total_size = stats.input_total_size;
197
24
    }
198
6.55k
    if (info.input_segments_num == 0 && stats.input_segments_num > 0) {
199
24
        info.input_segments_num = stats.input_segments_num;
200
24
    }
201
6.55k
}
202
203
6.55k
void CompactionTaskTracker::_trim_completed_locked() {
204
6.55k
    int32_t max = config::compaction_task_tracker_max_records;
205
6.55k
    if (max <= 0) {
206
0
        _completed_tasks.clear();
207
0
        return;
208
0
    }
209
6.55k
    while (static_cast<int32_t>(_completed_tasks.size()) > max) {
210
5
        _completed_tasks.pop_front();
211
5
    }
212
6.55k
}
213
214
432
std::vector<CompactionTaskInfo> CompactionTaskTracker::get_all_tasks() const {
215
432
    std::shared_lock rlock(_mutex);
216
432
    std::vector<CompactionTaskInfo> result;
217
432
    result.reserve(_active_tasks.size() + _completed_tasks.size());
218
2.47k
    for (const auto& [id, info] : _active_tasks) {
219
2.47k
        result.push_back(info);
220
2.47k
    }
221
89.1k
    for (const auto& info : _completed_tasks) {
222
89.1k
        result.push_back(info);
223
89.1k
    }
224
432
    return result;
225
432
}
226
227
std::vector<CompactionTaskInfo> CompactionTaskTracker::get_completed_tasks(
228
        int64_t tablet_id, int64_t top_n, const std::string& compaction_type,
229
14
        int success_filter) const {
230
14
    int32_t max = config::compaction_task_tracker_max_records;
231
14
    if (max <= 0) {
232
0
        return {};
233
0
    }
234
235
14
    std::shared_lock rlock(_mutex);
236
14
    std::vector<CompactionTaskInfo> result;
237
14
    int32_t count = 0;
238
    // Iterate in reverse order (newest first).
239
1.79k
    for (auto it = _completed_tasks.rbegin(); it != _completed_tasks.rend(); ++it) {
240
1.77k
        if (count >= max) {
241
0
            break;
242
0
        }
243
1.77k
        count++;
244
1.77k
        const auto& record = *it;
245
1.77k
        if (tablet_id != 0 && record.tablet_id != tablet_id) {
246
7
            continue;
247
7
        }
248
1.77k
        if (!compaction_type.empty() && compaction_type != to_string(record.compaction_type)) {
249
11
            continue;
250
11
        }
251
1.76k
        if (success_filter == 1 && record.status != CompactionTaskStatus::FINISHED) {
252
1
            continue;
253
1
        }
254
1.75k
        if (success_filter == 0 && record.status != CompactionTaskStatus::FAILED) {
255
4
            continue;
256
4
        }
257
1.75k
        result.push_back(record);
258
1.75k
        if (top_n > 0 && static_cast<int64_t>(result.size()) >= top_n) {
259
2
            break;
260
2
        }
261
1.75k
    }
262
14
    return result;
263
14
}
264
265
15
void CompactionTaskTracker::clear_for_test() {
266
15
    std::unique_lock wlock(_mutex);
267
15
    _active_tasks.clear();
268
15
    _completed_tasks.clear();
269
15
}
270
271
} // namespace doris