Show EOL distros:
Package Summary
System-wide logging mechanism for messages sent to the /rosout topic.
- Author: Josh Faust/jfaust@willowgarage.com
- License: BSD
- Repository: ros
- Source: svn https://code.ros.org/svn/ros/stacks/ros_comm/tags/ros_comm-1.4.8
Package Summary
System-wide logging mechanism for messages sent to the /rosout topic.
- Author: Josh Faust/jfaust@willowgarage.com
- License: BSD
- Source: git https://github.com/ros/ros_comm.git (branch: ros_comm-1.6)
Package Summary
System-wide logging mechanism for messages sent to the /rosout topic.
- Author: Josh Faust/jfaust@willowgarage.com
- License: BSD
- Source: git https://github.com/ros/ros_comm.git (branch: fuerte-devel)
Package Summary
System-wide logging mechanism for messages sent to the /rosout topic.
- Maintainer status: maintained
- Maintainer: Dirk Thomas <dthomas AT osrfoundation DOT org>
- Author: Josh Faust
- License: BSD
- Source: git https://github.com/ros/ros_comm.git (branch: groovy-devel)
Package Summary
System-wide logging mechanism for messages sent to the /rosout topic.
- Maintainer status: maintained
- Maintainer: Dirk Thomas <dthomas AT osrfoundation DOT org>
- Author: Josh Faust
- License: BSD
- Source: git https://github.com/ros/ros_comm.git (branch: hydro-devel)
Package Summary
System-wide logging mechanism for messages sent to the /rosout topic.
- Maintainer status: maintained
- Maintainer: Dirk Thomas <dthomas AT osrfoundation DOT org>
- Author: Josh Faust
- License: BSD
- Source: git https://github.com/ros/ros_comm.git (branch: indigo-devel)
Package Summary
System-wide logging mechanism for messages sent to the /rosout topic.
- Maintainer status: maintained
- Maintainer: Dirk Thomas <dthomas AT osrfoundation DOT org>
- Author: Josh Faust
- License: BSD
- Source: git https://github.com/ros/ros_comm.git (branch: indigo-devel)
Package Summary
System-wide logging mechanism for messages sent to the /rosout topic.
- Maintainer status: maintained
- Maintainer: Jacob Perron <jacob AT openrobotics DOT org>, Michael Carroll <michael AT openrobotics DOT org>, Shane Loretz <sloretz AT openrobotics DOT org>
- Author: Josh Faust, Dirk Thomas <dthomas AT osrfoundation DOT org>
- License: BSD
- Source: git https://github.com/ros/ros_comm.git (branch: kinetic-devel)
Package Summary
System-wide logging mechanism for messages sent to the /rosout topic.
- Maintainer status: maintained
- Maintainer: Dirk Thomas <dthomas AT osrfoundation DOT org>
- Author: Josh Faust
- License: BSD
- Source: git https://github.com/ros/ros_comm.git (branch: lunar-devel)
Package Summary
System-wide logging mechanism for messages sent to the /rosout topic.
- Maintainer status: maintained
- Maintainer: Jacob Perron <jacob AT openrobotics DOT org>, Michael Carroll <michael AT openrobotics DOT org>, Shane Loretz <sloretz AT openrobotics DOT org>
- Author: Josh Faust, Dirk Thomas <dthomas AT osrfoundation DOT org>
- License: BSD
- Source: git https://github.com/ros/ros_comm.git (branch: melodic-devel)
Package Summary
System-wide logging mechanism for messages sent to the /rosout topic.
- Maintainer status: maintained
- Maintainer: Michael Carroll <michael AT openrobotics DOT org>, Shane Loretz <sloretz AT openrobotics DOT org>
- Author: Josh Faust, Dirk Thomas <dthomas AT osrfoundation DOT org>, Jacob Perron <jacob AT openrobotics DOT org>
- License: BSD
- Source: git https://github.com/ros/ros_comm.git (branch: noetic-devel)
Contents
Overview
rosout is the name of the console log reporting mechanism in ROS. It can be thought as comprising several components:
The `rosout` node for subscribing, logging, and republishing the messages.
The /rosout topic
The /rosout_agg topic for subscribing to an aggregated feed
rosgraph_msgs/Log message type, which defines standard fields as well as verbosity levels.
client APIs to facilitate easy use of the rosout reporting mechanism
GUI tools, like rqt_console, for viewing the console log messages.
The rosout package only provides the rosout node.
Client APIs
Individual client APIs provide different ways of broadcasting to rosout:
roscpp uses rosconsole, which is described in the roscpp logging overview.
rospy's implementation is detailed in the rospy logging overview.
Verbosity Levels
Please see Verbosity Level Best Practices.
ROS API/Nodes
The /rosout node is part of roscore and has preferential startup order.
rosout
rosout subscribes to the standard /rosout topic, records these messages in a textual log file, and rebroadcasts the messages on /rosout_agg.Subscribed Topics
/rosout (rosgraph_msgs/Log)- Standard ROS topic for publishing logging messages.
Published Topics
/rosout_agg (rosgraph_msgs/Log)- Aggregated feed of messages published to /rosout.
/rosout
ROS client libraries are required to publish console logging messages to the /rosout topic as a standard interface.
/rosout_agg
/rosout_agg is an aggregated feed for subscribing to console logging messages. This aggregated topic is offered as a performance improvement: instead of connecting to individual ROS nodes to receive their console messages, the aggregated message feed can instead be received directly from the rosout node.
rosout.log
rosout node by default logs all messages into rosout.log in the ROS log directory.
New in Melodic This can be disabled by setting environment variable ROSOUT_DISABLE_FILE_LOGGING to True when launching roscore.
By default, rosout.log prints topic name for every message.
New in Melodic This behavior can be changed by setting boolean ROS parameter /rosout/omit_topics at any time.
Roadmap/Stability
No future development on rosout is currently planned.
