General information about this repository, including legal information and known issues/limitations, are given in README.md in the repository root.

The diagnostic_remote_logging package

This package provides the influxdb_connector node, which listens to diagnostic messages and integrates with InfluxDB v2 for monitoring and visualization. Specifically, it subscribes to the diagnostic_msgs/DiagnosticArray messages on the /diagnostics_agg topic and the diagnostic_msgs/DiagnosticStatus messages on the /diagnostics_toplevel_state topic. The node processes these messages, sending their statistics and levels to an InfluxDB database, enabling use with tools like Grafana.

As of now we only support InfluxDB v2, for support with older versions please use a proxy like Telegraf. See section Telegraf for an example on how to setup.

Node Configuration

You can send data to InfluxDB in two ways: directly to the database or via a proxy like Telegraf. While both methods are valid, using a proxy is generally recommended due to the following benefits:

• Efficient Data Transmission: Telegraf aggregates multiple measurements and sends them in a single request, reducing bandwidth usage and minimizing database load.
• Enhanced Reliability: Provides buffering in case of connection issues, ensuring no data is lost.
• Comprehensive Metric Collection: Telegraf can send additional system metrics (e.g., RAM, CPU, network usage) with minimal configuration.
• Data Filtering and Transformation: Supports preprocessing, such as filtering or transforming data, before sending it to InfluxDB.

To use either method, ensure you have a running instance of InfluxDB. The simplest way to set this up is through InfluxDB Cloud.

Parameters

The influxdb_connector node supports several parameters. Below is an example configuration:

/influxdb_connector:
  ros__parameters:
    connection:
      url: http://localhost:8086/api/v2/write
      token: ""
      bucket: ""
      organization: ""
    send:
      diagnostics: true
      period: 1.0
      top_level_state: true

• send.diagnostics: Enables or disables subscription to the /diagnostics topic.
• send.period: Specifies the interval in seconds for sending diagnostic data to InfluxDB. During each period, all incoming /diagnostics messages are collected and transmitted as a batch to InfluxDB.
• send.top_level_state: Enables or disables subscription to the /diagnostics_toplevel_state topic.

InfluxDB Configuration

Set the following parameters in your configuration to match your InfluxDB instance:

• connection.url: The URL of your InfluxDB write API endpoint.
• connection.token: Your InfluxDB authentication token.
• connection.bucket: The target bucket in InfluxDB.
• connection.organization: The name of your InfluxDB organization.

Starting the node

Afterward all configurations are set run the node with the following command:

ros2 run diagnostic_remote_logging influxdb_connector --ros-args --params-file <path_to_yaml_file>

Using a Telegraf Proxy

To configure Telegraf as a proxy for InfluxDB:

1. Ensure Telegraf is set up to send data to your InfluxDB instance via its configuration file (/etc/telegraf/telegraf.conf). Check this link for an example.
2. Add the following to the telegraf configuration file to enable the InfluxDB v2 listener:

    [[inputs.influxdb_v2_listener]]
      service_address = ":8187" # different port than the default 8086
    

1. Update the influxdb_connector node configuration to point to the appropriate URL. For example, if Telegraf is running on the same host as the influxdb_connector node, then http://localhost:8187/api/v2/write should work.

2. Leave the following parameters empty in the influxdb_connector node configuration when using Telegraf as a proxy:

   • connection.token
   • connection.bucket
   • connection.organization

3. Afterwards run the node with the following command:

    ros2 run diagnostic_remote_logging influxdb_connector --ros-args --params-file <path_to_yaml_file>
    

Changelog for package diagnostic_remote_logging

4.0.7 (2026-05-26)

• Updating package.xml s (#616)
• Stop flooding the terminal by default with matches of aggregators (#364) Co-authored-by: Tim Clephas <<tim.clephas@nobleo.nl>>
• Some fixes that came apparent when building for lyrical / resolute (#609)
• Option [publish_values]{.title-ref} to control whether aggregated state should contain values (#597) Co-authored-by: Denis Draca <<denis.draca@greenroomrobotics.com>> Co-authored-by: David Revay <<daverevay@gmail.com>> Co-authored-by: David Revay <<MrBlenny@users.noreply.github.com>>
• Aggregate to stale if one underlying is stale (#593) Co-authored-by: Ferry Schoenmakers <<ferry.schoenmakers@nobleo.nl>> Co-authored-by: Tim Clephas <<tim.clephas@nobleo.nl>>
• Implement onParametersSet for handling only analyzers node parameters (#551) Co-authored-by: Christian Henkel <<christian.henkel2@de.bosch.com>>
• Adding analyzer tests again (#555)
• Adding aggregator tests again (#467)
• Contributors: Christian Henkel, Ferry Schoenmakers, Noel Jiménez García

4.0.6 (2025-05-26)

• C++17 and cmake 3.20 everywhere (#510)
• Contributors: Christian Henkel

4.0.4 (2025-05-12)

4.0.3 (2025-04-03)

• cleanup (#450 <<https://github.com/ros/diagnostics/issues/450>>)

• Grafana Integration (#425 <<https://github.com/ros/diagnostics/issues/425>>)

  • First working version of remote_logging
  • Added more error handling, and skipping values when new line is present in stat
  • Changed default telegraf url to reflect the change to influxdb_v2_listener
  • Made node composable and changed name to influx to better reflect use cases

  * Added README ---------Co-authored-by: Daan Wijffels <mailto:dwijffels@lely.com> Co-authored-by: Thiever Base <mailto:thiever@lely.com> Co-authored-by: Christian Henkel <mailto:6976069+ct2034@users.noreply.github.com>

• Contributors: Christian Henkel, Daan Wijffels

4.0.2 (2025-02-10)

4.0.0 (2024-06-27)

3.2.0 (2024-03-22)

3.1.2 (2023-03-24)

3.1.1 (2023-03-16)

3.1.0 (2023-01-30)

3.0.0 (2022-06-10)

2.1.3 (2021-08-03)

2.1.2 (2021-03-03)

2.1.1 (2021-01-28)

2.1.0 (2021-01-12)

2.0.2 (2020-06-03)

2.0.0 (2019-09-03)

1.9.3 (2018-05-02)

1.9.2 (2017-07-15 20:34)

1.9.1 (2017-07-15 16:38)

1.9.0 (2017-04-25)

1.8.10 (2016-06-14)

File truncated at 100 lines see the full file