This is a Signal K Server plugin that writes Signal K data into one or several InfluxDB v2 databases.
This is a total rewrite of signalk-to-influxdb that works with InfluxDB v1.x databases.
Once the data is in InfluxDb you can use for example Grafana to draw pretty graphs of your data.
Main features:
- writes
navigation.position
shaped to work with InfluxDB's geo features - supports multiple InfluxDb connections
See backlog for planned features and Releases for published features.
For discussions and support visit the Signal K Website.
- data for Signal K "self" vessel is tagged with tag
self
with valuet
The plugin implements the Signal K History API, allowing retrieval of historical data with HTTP GET requests.
To retrieve logged data from the database, send a request to the values
endpoint, specifying at least the time interval and SignalK path(s).
http://localhost:3000/signalk/v1/history/values?from=2023-04-23T18:53:20Z&to=2023-04-23T18:55:00Z&paths=environment.wind.speedApparent
The data returned is in SI units, e.g. vessel and wind speeds in meters/s, angles in radian.
For further refinement of the queries, you can use the following request parameters.
The following request parameters are supported in queries:
-
from
/to
(mandatory)Start and end timestamp, GMT based, e.g. 2023-11-12T21:34:00Z
-
paths
(mandatory)SignalK paths to retrieve, comma-separated. By default the mean value is returned, but a path can be appended with :min or :max to select the minimum or maximum value.
-
resolution
(optional)The time interval in seconds between each point returned. For example
http://localhost:3000/signalk/v1/history/values?paths=navigation.position&from=2023-11-06T17:30:47Z&to=2023-11-12T21:34:00Z&resolution=60
will return the data with one position per minute. The data is simply sampled with InfluxDB'sfirst()
function. -
format
(optional)Position data ('navigation.position') can be exported as JSON (default) or in GPX format. Set
format=gpx
to receive a GPX track.
Get minimum apparent wind angles:
http://localhost:3000/signalk/v1/history/values?from=2023-04-23T18:51:26Z&to=2023-04-23T19:58:43Z&paths=environment.wind.angleApparent:min
Get wind angle and boat speed:
http://localhost:3000/signalk/v1/history/values?from=2023-04-23T18:53:20Z&to=2023-04-23T18:55:00Z&paths=environment.wind.angleApparent,navigation.speedThroughWater&resolution=60
Get the track with positions at intervals of 5 minutes in GPX format:
http://localhost:3000/signalk/v1/history/values?from=2023-11-04T10:00:00Z&to=2023-11-12T18:00:00Z&paths=navigation.position&resolution=300
To retrieve a list of available paths, send a request to the paths
endpoint with from and to timestamps:
http://localhost:3000/signalk/v1/history/paths?from=2023-11-04T00:00:00Z&to=2029-11-25T23:59:59Z
To retrieve a list of available contexts, send a request to the contexts
endpoint with from and to timestamps:
http://localhost:3000/signalk/v1/history/contexts?from=2023-11-04T00:00:00Z&to=2029-11-25T23:59:59Z