Add per node & component log level support
@penww ci sta già lavorando.
Dal 2/4/2026.
Valutazione
Questa issue non è ancora stata valutata.
Descrizione
Description
This issue tracks the addition of a log_level field to NodeOptions, allowing users to set the initial log severity for a node at construction time. This enables per-component log level customization, particularly useful in component container deployments.
Motivation
In ROS 2, all nodes loaded into a component container share the same process. Prior to this change, there was no way to specify a different initial log level for individual components at load time — the only option was to set a global log level or call set_level() programmatically after construction.
This is a common need in production deployments where:
- Different components have different verbosity requirements (e.g., a sensor driver at
WARN, a planner atDEBUG). - Operators want to configure log levels declaratively via launch files or
LoadNodeservice calls without modifying node source code. - Debugging a single component in a multi-component container should not require restarting the entire process with a global log level change.
We can see this feature has designed but not full implementation:
- LoadNode.srv defined
log_levelfield: https://github.com/ros2/rcl_interfaces/blob/79a773f9fb02dee0de23fb1b08ca4d187b313849/composition_interfaces/srv/LoadNode.srv#L17 - ros2component implement
log_levelargs but not parse: https://github.com/ros2/ros2cli/blob/401876461924b6bd4d4f9db95e22deb6243fce8b/ros2component/ros2component/api/__init__.py#L343 - component_manager not handle
log_levelin the LoadNode request: https://github.com/ros2/rclcpp/blob/f145c9ee04fbaa34f70b6f5cbbe095a6342f97c9/rclcpp_components/src/component_manager.cpp#L150
Expected Behavior:
- Set component log_level with CLI:
ros2 component load /ComponentManager <PKG> <PLUGIN> --log-level debug
- Set component log_level with launch:
def generate_launch_description():
return LaunchDescription([ComposableNodeContainer(
name='component_demo_container',
namespace='',
package='rclcpp_components',
executable='component_container',
composable_node_descriptions=[
ComposableNode(
package='<PKG>',
plugin='<PLUGIN>',
log_level='DEBUG', # component log level
),
],
arguments=['--ros-args', '--log-level', 'DEBUG'], # container log level
)])
Design / Implementation Considerations
NodeOptions API
A new log_level getter/setter pair is added to NodeOptions:
// Get the log level (RCUTILS_LOG_SEVERITY_* value; 0 = unset/default)
int log_level() const;
// Set the initial log level for this node
NodeOptions & log_level(int log_level);
The default value is RCUTILS_LOG_SEVERITY_UNSET (0), which preserves existing behavior — no level is applied at construction.
Node construction (node.cpp)
After the node is fully constructed, if log_level is not UNSET, the logger level is applied:
if (options.log_level() != RCUTILS_LOG_SEVERITY_UNSET) {
node_logging_->get_logger().set_level(
static_cast<rclcpp::Logger::Level>(options.log_level()));
}
This is intentionally applied after construction so the logger is fully initialized.
ComponentManager integration (component_manager.cpp)
When handling a LoadNode service request, the log_level field from the request is validated and forwarded to NodeOptions:
if (request->log_level != 0) {
// Validate against known RCUTILS severity values
options.log_level(request->log_level);
}
Invalid values (not one of DEBUG, INFO, WARN, ERROR, FATAL) throw a ComponentManagerException with a descriptive message.
Additional Information
No response
- Lingua principale
- C++
- Stelle
- 805
- Fork
- 564
- Merge medio
- 1g 22h
- PR unite (30g)
- 21
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di ros2/rclcpp
-
good first issue
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100
-
enhancement
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
-
bug
Difficoltà 3/5 1-2 giorni Idoneità per principianti 65/100
-
bug
Difficoltà 4/5 3-5 giorni Idoneità per principianti 48/100
-
enhancement
Difficoltà 5/5 Più di una settimana Idoneità per principianti 30/100
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
flutter-webrtc/flutter-webrtc#2206 ·
-
litertlm-android AAR ships no consumer ProGuard rules → "mid == null" SIGABRT in minified apps Aperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
google-ai-edge/LiteRT-LM#3739 ·
-
Component: GLib
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 65/100
brave/brave-browser#59300 ·
-
Mute ydb/tests/functional/dstool/test_canonical_requests.py.Test.test_group_take_snapshot in main Apertaai_reviewed
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
ydb-platform/ydb#53974 · 3 commenti ·