Log Annotation

Client for the log-annotation service (DEPRECATED).

The log-annotation service is deprecated and will be removed in a later release. Instead, please use the data_buffer service going forward.

exception bosdyn.client.log_annotation.InvalidArgument[source]

Bases: Error

A given argument could not be used.

class bosdyn.client.log_annotation.LogAnnotationClient(*args, **kwargs)[source]

Bases: BaseClient

A client for adding annotations to robot logs.

Deprecated since version 2.1.0: The log-annotation client and service have been replaced by data_buffer.

default_service_name = 'log-annotation'
service_type = 'bosdyn.api.LogAnnotationService'
update_from(other)[source]

Adopt key objects like processors, logger, and wallet from other.

add_text_messages(text_messages, **kwargs)[source]

Log text messages to the robot.

Parameters:

text_messages – Sequence of LogAnnotationTextMessage protos.

Raises:

RpcError – Problem communicating with the robot.

add_text_messages_async(text_messages, **kwargs)[source]

Async version of add_text_messages.

add_operator_comment(msg, robot_timestamp=None, **kwargs)[source]

Add an operator comment to the robot log.

Parameters:
  • msg – Text of user comment to log.

  • robot_timestamp – Time (google.protobuf.Timestamp) of messages, in robot time. If not set, timestamp will be when the robot receives the message.

Raises:

RpcError – Problem communicating with the robot.

add_operator_comment_async(msg, robot_timestamp=None, **kwargs)[source]

Async version of add_operator_comment.

add_log_blob(data, type_id, channel=None, robot_timestamp=None, **kwargs)[source]

Log blob messages to the robot.

Parameters:
  • data – Binary data of one blob.

  • type_id – Type of binary data of blob.

  • robot_timestamp – Time (google.protobuf.Timestamp) of messages, in robot time. If not set, timestamp will be when the robot receives the message.

Raises:

RpcError – Problem communicating with the robot.

add_log_blob_async(data, type_id, channel=None, robot_timestamp=None, **kwargs)[source]

Async version of add_log_blob.

add_log_protobuf(proto, robot_timestamp=None)[source]
add_log_protobuf_async(proto, robot_timestamp=None)[source]
class bosdyn.client.log_annotation.LogAnnotationHandler(*args, **kwargs)[source]

Bases: Handler

A logging system Handler that publish to a bosdyn.api.LogAnnotationService (DEPRECATED).

LogAnnotationHandler is deprecated. Instead, use bosdyn.client.data_buffer.LoggingHandler.

Deprecated since version 2.1.0: The log-annotation client and service have been replaced by data_buffer.

emit(record)[source]

Do whatever it takes to actually log the specified logging record.

This version is intended to be implemented by subclasses and so raises a NotImplementedError.

flush()[source]

Ensure all logging output has been flushed.

This version does nothing and is intended to be implemented by subclasses.

close()[source]

Tidy up any resources used by the handler.

This version removes the handler from an internal map of handlers, _handlers, which is used for handler lookup by name. Subclasses should ensure that this gets called from overridden close() methods.

is_thread_alive()[source]
restart(log_client)[source]

Restart the send thread.

Raises:

AssertionError if send thread is still alive.

fallback_log(msg)[source]
record_to_msg(record)[source]
static record_level_to_proto_level(record_level)[source]