Wiki: Fields/Utilities / gadgetbridge_to_influxdb

This page details the fields/series created in InfluxDB by the script.

---

Common Tags

There are some tags which will be present against all entries

• device: the human readable name used for the device in Gadgetbridge

---

Data Collection Stats

Stats related to the operation of the script as well as monitoring the age of synced data

Tags:

• sample_type: sync_check

Fields:

• last_seen: a nanosecond timestamp of the most recent point observed in the GB database
• last_seen_age: the time (in NS) between that and the sync being run

---

Activity Sample

These are used for the periodic sampling of heart rate (if enabled) as well as step counts.

See #5 for an overview of the intensity meaning.

Tags:

• sample_type: periodic_samples

Fields:

• intensity: an integer indicating the intensity level, adjusted for age
• steps: number of steps in this activity (note, not a cumulative counter)
• heart_rate: beats per minute
• raw_kind: the activity kind (currently not well understood/defined)
• raw_intensity: the non-adjusted intensity score

---

Battery

Tags:

• battery: an integer identifying which battery (will almost always just be 0)

Fields:

• battery_level: A percentage indicator providing battery charge level

---

Blood Oxygen (SpO2)

Note: SpO2 support is experimental in Gadgetbridge and will need to be enabled

Tags:

• type_num: An integer defining what type of sample was taken (0 appears to be a manual sample)

Fields:

• spo2: The SpO2 reading (a percentage of blood oxygen saturation)

---

Heart Rate Samples

Daily stats and manual heart-rate samples.

Tags:

• sample_type: one of manual, max or resting

Fields:

• heart_rate: a value indicating beats per minute

---

Extended Activity Samples

Activity samples taken by the watch.

Tags:

• sample_type: activity
• activity_kind: An integer indicator of the type of activity (the meaning of these is not well understood/documented)

Fields:

• intensity: an integer indicating the intensity level, adjusted for age
• steps: number of steps in this activity (note, not a cumulative counter)
• heart_rate: beats per minute
• sleep: Time asleep
• deep_sleep: Time in deep sleep
• rem_sleep: Time in REM

---

Personal Activity Intelligence (PAI) score

The watch tracks PAI over a rolling 7 day period.

Fields:

• pai_low: The threshold used for low PAI
• pai_moderate: The threshold used for moderate PAI
• pai_high: The threshold used for high PAI
• time_low: The time spent at a low PAI
• time_moderate: The time spent at a moderate PAI
• time_high: The time spent at a high PAI
• pai_today: The PAI score achieved today
• pai_total: Current PAI score

---

Sleep Respiratory Rate

Note: at time of writing, there isn't a way to enable this from Gadgetbridge. If the watch exposes the option (the Bip 3 appears not to), it needs enabling there

Fields:

• sleep_respiratory_rate: The measured respiratory rate

---

Stress

Tags:

• type_num: An integer defining what type of sample was taken (1 appears to indicate that it's the periodic sample)

Fields:

• stress: an integer value indicating the stress level. lower is less stressed stress_exc_sleep: Only added for values that don't fall within the hours defined in env varSLEEP_HOURS`, an integer value indicating the stress level

---

Stress Point-in-Time

The script generates points to fill the gaps between the points written for Stress above.

Tags:

• type_num: An integer defining what type of sample was taken (1 appears to indicate that it's the periodic sample)
• stress : point_in_time

Fields:

• current_stress_level: An integer value representing the stress level
• stress_level_counter_unknown: Where present, the value will be 1
• stress_level_counter_relaxed: Where present, the value will be 1
• stress_level_counter_normal: Where present, the value will be 1
• stress_level_counter_medium: Where present, the value will be 1
• stress_level_counter_high: Where present, the value will be 1
• stress_level_counter_unknown_exc_sleep: Where present, the value will be 1
• stress_level_counter_relaxed_exc_sleep: Where present, the value will be 1
• stress_level_counter_normal_exc_sleep: Where present, the value will be 1
• stress_level_counter_medium_exc_sleep: Where present, the value will be 1
• stress_level_counter_high_exc_sleep: Where present, the value will be 1

The stress_level_counter_* fields are intended to make it easy to chart out what proportion of time is spent at each stress level. An example of doing this can be found in #13