Coverage Report

Created: 2026-04-07 14:13

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.9k
const char* to_string(CompactionProfileType type) {
26
13.9k
    switch (type) {
27
54
    case CompactionProfileType::BASE:
28
54
        return "base";
29
13.8k
    case CompactionProfileType::CUMULATIVE:
30
13.8k
        return "cumulative";
31
42
    case CompactionProfileType::FULL:
32
42
        return "full";
33
13.9k
    }
34
0
    return "unknown";
35
13.9k
}
36
37
12.1k
const char* to_string(CompactionTaskStatus status) {
38
12.1k
    switch (status) {
39
0
    case CompactionTaskStatus::PENDING:
40
0
        return "PENDING";
41
20
    case CompactionTaskStatus::RUNNING:
42
20
        return "RUNNING";
43
12.0k
    case CompactionTaskStatus::FINISHED:
44
12.0k
        return "FINISHED";
45
112
    case CompactionTaskStatus::FAILED:
46
112
        return "FAILED";
47
12.1k
    }
48
0
    return "UNKNOWN";
49
12.1k
}
50
51
13.9k
const char* to_string(TriggerMethod method) {
52
13.9k
    switch (method) {
53
12.1k
    case TriggerMethod::AUTO:
54
12.1k
        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.9k
    }
60
0
    return "UNKNOWN";
61
13.9k
}
62
63
382k
CompactionTaskTracker* CompactionTaskTracker::instance() {
64
382k
    static CompactionTaskTracker s_instance;
65
382k
    return &s_instance;
66
382k
}
67
68
8.55k
void CompactionTaskTracker::register_task(CompactionTaskInfo info) {
69
8.55k
    if (!config::enable_compaction_task_tracker) {
70
1
        return;
71
1
    }
72
8.55k
    std::unique_lock wlock(_mutex);
73
8.55k
    _active_tasks[info.compaction_id] = std::move(info);
74
8.55k
}
75
76
8.08k
void CompactionTaskTracker::update_to_running(int64_t compaction_id, const RunningStats& stats) {
77
8.08k
    if (!config::enable_compaction_task_tracker) {
78
0
        return;
79
0
    }
80
8.08k
    std::unique_lock wlock(_mutex);
81
8.08k
    auto it = _active_tasks.find(compaction_id);
82
8.08k
    if (it != _active_tasks.end()) {
83
8.08k
        auto& task = it->second;
84
8.08k
        task.status = CompactionTaskStatus::RUNNING;
85
8.08k
        task.start_time_ms = stats.start_time_ms;
86
8.08k
        task.is_vertical = stats.is_vertical;
87
8.08k
        task.permits = stats.permits;
88
8.08k
    }
89
8.08k
}
90
91
void CompactionTaskTracker::update_progress(int64_t compaction_id, int64_t total_groups,
92
30.5k
                                            int64_t completed_groups) {
93
30.5k
    if (!config::enable_compaction_task_tracker) {
94
0
        return;
95
0
    }
96
30.5k
    std::unique_lock wlock(_mutex);
97
30.5k
    auto it = _active_tasks.find(compaction_id);
98
30.5k
    if (it != _active_tasks.end()) {
99
28.0k
        auto& task = it->second;
100
28.0k
        task.vertical_total_groups = total_groups;
101
28.0k
        task.vertical_completed_groups = completed_groups;
102
28.0k
    }
103
30.5k
}
104
105
7.89k
void CompactionTaskTracker::complete(int64_t compaction_id, const CompletionStats& stats) {
106
7.89k
    if (!config::enable_compaction_task_tracker) {
107
0
        return;
108
0
    }
109
7.89k
    std::unique_lock wlock(_mutex);
110
7.89k
    auto it = _active_tasks.find(compaction_id);
111
7.89k
    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
7.89k
    auto node = _active_tasks.extract(it);
118
7.89k
    CompactionTaskInfo& info = node.mapped();
119
7.89k
    info.status = CompactionTaskStatus::FINISHED;
120
7.89k
    _apply_completion(info, stats);
121
122
7.90k
    if (config::compaction_task_tracker_max_records > 0) {
123
7.90k
        _completed_tasks.push_back(std::move(info));
124
7.90k
        _trim_completed_locked();
125
7.90k
    }
126
7.89k
}
127
128
void CompactionTaskTracker::fail(int64_t compaction_id, const CompletionStats& stats,
129
193
                                 const std::string& msg) {
130
193
    if (!config::enable_compaction_task_tracker) {
131
0
        return;
132
0
    }
133
193
    std::unique_lock wlock(_mutex);
134
193
    auto it = _active_tasks.find(compaction_id);
135
193
    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
192
    auto node = _active_tasks.extract(it);
142
192
    CompactionTaskInfo& info = node.mapped();
143
192
    info.status = CompactionTaskStatus::FAILED;
144
192
    info.status_msg = msg;
145
192
    _apply_completion(info, stats);
146
147
193
    if (config::compaction_task_tracker_max_records > 0) {
148
193
        _completed_tasks.push_back(std::move(info));
149
193
        _trim_completed_locked();
150
193
    }
151
192
}
152
153
8.51k
void CompactionTaskTracker::remove_task(int64_t compaction_id) {
154
8.51k
    if (!config::enable_compaction_task_tracker) {
155
0
        return;
156
0
    }
157
8.51k
    std::unique_lock wlock(_mutex);
158
8.51k
    _active_tasks.erase(compaction_id); // idempotent: no-op if already removed
159
8.51k
}
160
161
void CompactionTaskTracker::_apply_completion(CompactionTaskInfo& info,
162
8.09k
                                              const CompletionStats& stats) {
163
8.09k
    info.end_time_ms = stats.end_time_ms;
164
8.09k
    info.merged_rows = stats.merged_rows;
165
8.09k
    info.filtered_rows = stats.filtered_rows;
166
8.09k
    info.output_rows = stats.output_rows;
167
8.09k
    info.output_row_num = stats.output_row_num;
168
8.09k
    info.output_data_size = stats.output_data_size;
169
8.09k
    info.output_index_size = stats.output_index_size;
170
8.09k
    info.output_total_size = stats.output_total_size;
171
8.09k
    info.output_segments_num = stats.output_segments_num;
172
8.09k
    info.output_version = stats.output_version;
173
8.09k
    info.merge_latency_ms = stats.merge_latency_ms;
174
8.09k
    info.bytes_read_from_local = stats.bytes_read_from_local;
175
8.09k
    info.bytes_read_from_remote = stats.bytes_read_from_remote;
176
8.09k
    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
8.09k
    if (info.input_version_range.empty() && !stats.input_version_range.empty()) {
181
0
        info.input_version_range = stats.input_version_range;
182
0
    }
183
8.09k
    if (info.input_rowsets_count == 0 && stats.input_rowsets_count > 0) {
184
0
        info.input_rowsets_count = stats.input_rowsets_count;
185
0
    }
186
8.09k
    if (info.input_row_num == 0 && stats.input_row_num > 0) {
187
834
        info.input_row_num = stats.input_row_num;
188
834
    }
189
8.09k
    if (info.input_data_size == 0 && stats.input_data_size > 0) {
190
834
        info.input_data_size = stats.input_data_size;
191
834
    }
192
8.09k
    if (info.input_index_size == 0 && stats.input_index_size > 0) {
193
0
        info.input_index_size = stats.input_index_size;
194
0
    }
195
8.09k
    if (info.input_total_size == 0 && stats.input_total_size > 0) {
196
834
        info.input_total_size = stats.input_total_size;
197
834
    }
198
8.09k
    if (info.input_segments_num == 0 && stats.input_segments_num > 0) {
199
834
        info.input_segments_num = stats.input_segments_num;
200
834
    }
201
8.09k
}
202
203
8.09k
void CompactionTaskTracker::_trim_completed_locked() {
204
8.09k
    int32_t max = config::compaction_task_tracker_max_records;
205
8.09k
    if (max <= 0) {
206
0
        _completed_tasks.clear();
207
0
        return;
208
0
    }
209
8.09k
    while (static_cast<int32_t>(_completed_tasks.size()) > max) {
210
5
        _completed_tasks.pop_front();
211
5
    }
212
8.09k
}
213
214
433
std::vector<CompactionTaskInfo> CompactionTaskTracker::get_all_tasks() const {
215
433
    std::shared_lock rlock(_mutex);
216
433
    std::vector<CompactionTaskInfo> result;
217
433
    result.reserve(_active_tasks.size() + _completed_tasks.size());
218
2.51k
    for (const auto& [id, info] : _active_tasks) {
219
2.51k
        result.push_back(info);
220
2.51k
    }
221
89.0k
    for (const auto& info : _completed_tasks) {
222
89.0k
        result.push_back(info);
223
89.0k
    }
224
433
    return result;
225
433
}
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.82k
    for (auto it = _completed_tasks.rbegin(); it != _completed_tasks.rend(); ++it) {
240
1.81k
        if (count >= max) {
241
0
            break;
242
0
        }
243
1.81k
        count++;
244
1.81k
        const auto& record = *it;
245
1.81k
        if (tablet_id != 0 && record.tablet_id != tablet_id) {
246
7
            continue;
247
7
        }
248
1.80k
        if (!compaction_type.empty() && compaction_type != to_string(record.compaction_type)) {
249
11
            continue;
250
11
        }
251
1.79k
        if (success_filter == 1 && record.status != CompactionTaskStatus::FINISHED) {
252
1
            continue;
253
1
        }
254
1.79k
        if (success_filter == 0 && record.status != CompactionTaskStatus::FAILED) {
255
4
            continue;
256
4
        }
257
1.78k
        result.push_back(record);
258
1.78k
        if (top_n > 0 && static_cast<int64_t>(result.size()) >= top_n) {
259
2
            break;
260
2
        }
261
1.78k
    }
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