2021-06-03 14:40:52 +08:00
|
|
|
/*
|
|
|
|
* IKnobCollection.h
|
|
|
|
*
|
|
|
|
* This source file is part of the FoundationDB open source project
|
|
|
|
*
|
2022-03-22 04:36:23 +08:00
|
|
|
* Copyright 2013-2022 Apple Inc. and the FoundationDB project authors
|
2021-06-03 14:40:52 +08:00
|
|
|
*
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
* you may not use this file except in compliance with the License.
|
|
|
|
* You may obtain a copy of the License at
|
|
|
|
*
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
*
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include "fdbclient/IKnobCollection.h"
|
|
|
|
#include "fdbclient/ClientKnobCollection.h"
|
|
|
|
#include "fdbclient/ServerKnobCollection.h"
|
2021-06-10 11:50:00 +08:00
|
|
|
#include "fdbclient/TestKnobCollection.h"
|
2021-06-03 14:40:52 +08:00
|
|
|
|
2021-06-10 11:50:00 +08:00
|
|
|
std::unique_ptr<IKnobCollection> IKnobCollection::create(Type type, Randomize randomize, IsSimulated isSimulated) {
|
|
|
|
if (type == Type::CLIENT) {
|
|
|
|
return std::make_unique<ClientKnobCollection>(randomize, isSimulated);
|
|
|
|
} else if (type == Type::SERVER) {
|
|
|
|
return std::make_unique<ServerKnobCollection>(randomize, isSimulated);
|
|
|
|
} else if (type == Type::TEST) {
|
|
|
|
return std::make_unique<TestKnobCollection>(randomize, isSimulated);
|
|
|
|
}
|
|
|
|
UNSTOPPABLE_ASSERT(false);
|
2021-06-03 14:40:52 +08:00
|
|
|
}
|
|
|
|
|
2021-06-10 11:50:00 +08:00
|
|
|
KnobValue IKnobCollection::parseKnobValue(std::string const& knobName, std::string const& knobValue) const {
|
|
|
|
auto result = tryParseKnobValue(knobName, knobValue);
|
|
|
|
if (!result.present()) {
|
|
|
|
throw invalid_option();
|
|
|
|
}
|
|
|
|
return result.get();
|
2021-06-03 14:40:52 +08:00
|
|
|
}
|
|
|
|
|
2021-06-10 11:50:00 +08:00
|
|
|
void IKnobCollection::setKnob(std::string const& knobName, KnobValueRef const& knobValue) {
|
|
|
|
if (!trySetKnob(knobName, knobValue)) {
|
2021-06-18 13:05:28 +08:00
|
|
|
TraceEvent(SevWarnAlways, "FailedToSetKnob")
|
|
|
|
.detail("KnobName", knobName)
|
|
|
|
.detail("KnobValue", knobValue.toString());
|
2021-06-17 04:10:14 +08:00
|
|
|
throw invalid_option_value();
|
2021-06-10 11:50:00 +08:00
|
|
|
}
|
2021-06-03 14:40:52 +08:00
|
|
|
}
|
|
|
|
|
2021-06-10 11:50:00 +08:00
|
|
|
KnobValue IKnobCollection::parseKnobValue(std::string const& knobName, std::string const& knobValue, Type type) {
|
2021-06-03 14:40:52 +08:00
|
|
|
// TODO: Ideally it should not be necessary to create a template object to parse knobs
|
2021-06-10 11:50:00 +08:00
|
|
|
static std::unique_ptr<IKnobCollection> clientKnobCollection, serverKnobCollection, testKnobCollection;
|
|
|
|
if (type == Type::CLIENT) {
|
|
|
|
if (!clientKnobCollection) {
|
2021-07-17 15:11:40 +08:00
|
|
|
clientKnobCollection = create(type, Randomize::False, IsSimulated::False);
|
2021-06-10 11:50:00 +08:00
|
|
|
}
|
|
|
|
return clientKnobCollection->parseKnobValue(knobName, knobValue);
|
|
|
|
} else if (type == Type::SERVER) {
|
2021-06-03 14:40:52 +08:00
|
|
|
if (!serverKnobCollection) {
|
2021-07-17 15:11:40 +08:00
|
|
|
serverKnobCollection = create(type, Randomize::False, IsSimulated::False);
|
2021-06-03 14:40:52 +08:00
|
|
|
}
|
|
|
|
return serverKnobCollection->parseKnobValue(knobName, knobValue);
|
2021-06-10 11:50:00 +08:00
|
|
|
} else if (type == Type::TEST) {
|
|
|
|
if (!testKnobCollection) {
|
2021-07-17 15:11:40 +08:00
|
|
|
testKnobCollection = create(type, Randomize::False, IsSimulated::False);
|
2021-06-03 14:40:52 +08:00
|
|
|
}
|
2021-06-10 11:50:00 +08:00
|
|
|
return testKnobCollection->parseKnobValue(knobName, knobValue);
|
2021-06-03 14:40:52 +08:00
|
|
|
}
|
2021-06-10 11:50:00 +08:00
|
|
|
UNSTOPPABLE_ASSERT(false);
|
2021-06-03 14:40:52 +08:00
|
|
|
}
|
|
|
|
|
2021-11-11 11:05:38 +08:00
|
|
|
std::unique_ptr<IKnobCollection>& IKnobCollection::globalKnobCollection() {
|
|
|
|
static std::unique_ptr<IKnobCollection> res;
|
|
|
|
if (!res) {
|
|
|
|
res = IKnobCollection::create(IKnobCollection::Type::CLIENT, Randomize::False, IsSimulated::False);
|
|
|
|
}
|
|
|
|
return res;
|
|
|
|
}
|
2021-06-10 13:33:00 +08:00
|
|
|
|
|
|
|
void IKnobCollection::setGlobalKnobCollection(Type type, Randomize randomize, IsSimulated isSimulated) {
|
2021-11-11 11:05:38 +08:00
|
|
|
globalKnobCollection() = create(type, randomize, isSimulated);
|
2021-11-16 17:28:16 +08:00
|
|
|
ASSERT(FLOW_KNOBS == &bootstrapGlobalFlowKnobs);
|
2021-11-11 11:05:38 +08:00
|
|
|
FLOW_KNOBS = &globalKnobCollection()->getFlowKnobs();
|
2021-06-10 13:33:00 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
IKnobCollection const& IKnobCollection::getGlobalKnobCollection() {
|
2021-11-11 11:05:38 +08:00
|
|
|
return *globalKnobCollection();
|
2021-06-10 13:33:00 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
IKnobCollection& IKnobCollection::getMutableGlobalKnobCollection() {
|
2021-11-11 11:05:38 +08:00
|
|
|
return *globalKnobCollection();
|
2021-06-10 13:33:00 +08:00
|
|
|
}
|
2021-08-26 06:21:36 +08:00
|
|
|
|
2022-03-25 06:17:02 +08:00
|
|
|
void IKnobCollection::setupKnobs(const std::vector<std::pair<std::string, std::string>>& knobs) {
|
|
|
|
auto& g_knobs = IKnobCollection::getMutableGlobalKnobCollection();
|
|
|
|
for (const auto& [knobName, knobValueString] : knobs) {
|
|
|
|
try {
|
|
|
|
auto knobValue = g_knobs.parseKnobValue(knobName, knobValueString);
|
|
|
|
g_knobs.setKnob(knobName, knobValue);
|
|
|
|
} catch (Error& e) {
|
|
|
|
if (e.code() == error_code_invalid_option_value) {
|
|
|
|
std::cerr << "WARNING: Invalid value '" << knobValueString << "' for knob option '" << knobName
|
|
|
|
<< "'\n";
|
|
|
|
TraceEvent(SevWarnAlways, "InvalidKnobValue")
|
|
|
|
.detail("Knob", printable(knobName))
|
|
|
|
.detail("Value", printable(knobValueString));
|
2022-05-19 01:45:13 +08:00
|
|
|
} else if (e.code() == error_code_invalid_option) {
|
|
|
|
std::cerr << "WARNING: Invalid knob option '" << knobName << "'\n'";
|
|
|
|
TraceEvent(SevWarnAlways, "InvalidKnobName")
|
|
|
|
.detail("Knob", printable(knobName))
|
|
|
|
.detail("Value", printable(knobValueString));
|
2022-03-25 06:17:02 +08:00
|
|
|
} else {
|
|
|
|
std::cerr << "ERROR: Failed to set knob option '" << knobName << "': " << e.what() << "\n";
|
|
|
|
TraceEvent(SevError, "FailedToSetKnob")
|
|
|
|
.errorUnsuppressed(e)
|
|
|
|
.detail("Knob", printable(knobName))
|
|
|
|
.detail("Value", printable(knobValueString));
|
|
|
|
throw e;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-08-26 06:21:36 +08:00
|
|
|
ConfigMutationRef IKnobCollection::createSetMutation(Arena arena, KeyRef key, ValueRef value) {
|
|
|
|
ConfigKey configKey = ConfigKeyRef::decodeKey(key);
|
|
|
|
auto knobValue =
|
|
|
|
IKnobCollection::parseKnobValue(configKey.knobName.toString(), value.toString(), IKnobCollection::Type::TEST);
|
|
|
|
return ConfigMutationRef(arena, configKey, knobValue.contents());
|
|
|
|
}
|
|
|
|
|
|
|
|
ConfigMutationRef IKnobCollection::createClearMutation(Arena arena, KeyRef key) {
|
|
|
|
return ConfigMutationRef(arena, ConfigKeyRef::decodeKey(key), {});
|
|
|
|
}
|