Dynamic Log Levels
A dynamic log level is a Quonfig config of type log_level that decides how verbose your loggers
are. You change it in Quonfig, and running processes pick up the change over their live connection.
You don't redeploy or restart.
This page shows how to write the rules. To wire a logger to the config, see your SDK's Dynamic Log Levels section: Node, Go, Java, .NET, Ruby, Python.
How it works
- Use one
log_levelconfig per app. The key must start withlog-level., for examplelog-level.my-app. - The value is one of
TRACE,DEBUG,INFO,WARN,ERRORorFATAL. - Give the SDK the key with its logger-key option (for example
loggerKeyin Node orWithLoggerKeyin Go). When your logger asks whether to write a message, the SDK puts the logger's name into the context asquonfig-sdk-logging.keyand evaluates the config. - Rules are evaluated top to bottom, and the first rule that matches wins. A rule on
quonfig-sdk-logging.keycan set the level for one logger, or for every logger under a prefix. - The evaluation also sees the rest of your context, so a rule can match on
user.emailor any other property, just like a flag rule.
Per-logger rules on quonfig-sdk-logging.key work in the backend SDKs listed above. The browser SDK
doesn't send the logger name, so in the browser write rules on the context you pass to init()
instead; see JavaScript.
Example
Create the config with a default of INFO for every logger in the app:
qfg log-level log-level.my-app --value=INFO
Turn on DEBUG for every logger whose name starts with com.example.auth:
qfg log-level log-level.my-app --target=com.example.auth --value=DEBUG
Use the prefix your logger names actually have, for example MyApp.Services.Auth in .NET,
MyApp::Services::Auth in Ruby or my_app.auth in Python. The match is a plain string prefix on
the logger name the SDK receives.
--target adds a rule above the existing rules, so it wins over the default. Run it again with the
same target to change that rule's level. Pass --target more than once to match any of several
prefixes in one rule. Add --environment=<env> to write the rule to one environment only:
qfg log-level log-level.my-app --target=org.apache.kafka --value=ERROR --environment=production
After the first two commands, the config's default rules look like this (other fields left out):
{
"key": "log-level.my-app",
"type": "log_level",
"valueType": "log_level",
"default": {
"rules": [
{
"criteria": [
{
"operator": "PROP_STARTS_WITH_ONE_OF",
"propertyName": "quonfig-sdk-logging.key",
"valueToMatch": { "type": "string_list", "value": ["com.example.auth"] }
}
],
"value": { "type": "log_level", "value": "DEBUG" }
},
{
"criteria": [{ "operator": "ALWAYS_TRUE" }],
"value": { "type": "log_level", "value": "INFO" }
}
]
}
}
To change the catch-all level in one environment, use set-default:
qfg set-default log-level.my-app --value=DEBUG --environment=production
Rules on other properties
qfg log-level --target only writes rules on quonfig-sdk-logging.key. For any other rule, such as
turning on DEBUG for one developer by user.email, open the log level under Log Levels in the
Quonfig app and add the rule there. Log-level rules use the same operators as flag and config rules;
see Rules and Segmentation.
You can also edit the config's JSON in your workspace repo. Log levels live in the log-levels/
directory, one file per key.
See the CLI reference for every qfg log-level option.