Fix wind speed mapping for awn

TODO.md

@@ -1,11 +1,18 @@
 # TODO
-- [ ] Fix shutdown
 - [ ] Configuration for app
+- [ ] Configurable metric prefix
 - [ ] Helm Chart
 - [ ] Update README
-- [ ] Add new fields from WS-2192
+- [ ] Add Grafana dashboard
+- [ ] Add device name field with ID/Key mappings
+- [ ] Add device type field with ID/Key mappings
+- [ ] Move EVERYTHING to pointers to support nil
+- [ ] Add proxy to upstream support
 
 ## Done
+- [x] Consolidate battery status into one metric with device label
+- [x] Fix shutdown
+- [x] Add new fields from WS-2192
 - [x] Gitea CI
 - [x] Version flag
 - [x] Makefile

go.mod

@@ -3,7 +3,7 @@ module gitea.libretechconsulting.com/rmcguire/ambient-weather-local-exporter
 go 1.23.4
 
 require (
-	gitea.libretechconsulting.com/rmcguire/go-app v0.2.0
+	gitea.libretechconsulting.com/rmcguire/go-app v0.3.0
 	github.com/gorilla/schema v1.4.1
 	github.com/rs/zerolog v1.33.0
 	go.opentelemetry.io/otel v1.33.0

go.sum

@@ -2,6 +2,8 @@ gitea.libretechconsulting.com/rmcguire/go-app v0.1.3 h1:EwmEJLpN+rQjJ5stGEkZsqED
 gitea.libretechconsulting.com/rmcguire/go-app v0.1.3/go.mod h1:wHOWh4O4AMDATQ3WEUYjq5a5bnICPBpu5G6BsNxqN38=
 gitea.libretechconsulting.com/rmcguire/go-app v0.2.0 h1:pOm/PysC0IWPuEbmEjNSHHa8Qc5OhuoksYExcuJMFE4=
 gitea.libretechconsulting.com/rmcguire/go-app v0.2.0/go.mod h1:wHOWh4O4AMDATQ3WEUYjq5a5bnICPBpu5G6BsNxqN38=
+gitea.libretechconsulting.com/rmcguire/go-app v0.3.0 h1:TSR6oEDBX+83975gmgGgU/cTFgfG999+9N/1h4RAXq0=
+gitea.libretechconsulting.com/rmcguire/go-app v0.3.0/go.mod h1:wHOWh4O4AMDATQ3WEUYjq5a5bnICPBpu5G6BsNxqN38=
 github.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM=
 github.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw=
 github.com/caarlos0/env/v11 v11.3.1 h1:cArPWC15hWmEt+gWk7YBi7lEXTXCvpaSdCiZE2X5mCA=

main.go

@@ -16,10 +16,10 @@ func main() {
 	ctx, cncl := signal.NotifyContext(context.Background(), os.Kill, unix.SIGTERM)
 	defer cncl()
 
+	// Read config and environment, set up logging, load up
+	// an appCtx, and prepare ambient weather local exporter
 	ctx = app.MustSetupConfigAndLogging(ctx)
-
+	aw := ambient.New(ctx).Init()
-	aw := ambient.New(ctx)
-	aw.MustInit()
 
 	awApp := app.App{
 		AppContext: ctx,

pkg/ambient/ambient.go

@@ -37,10 +37,12 @@ func New(appCtx context.Context) *AmbientWeather {
 	}
 }
 
-func (aw *AmbientWeather) MustInit() {
+// Initialize with defaults, set logger from context
+func (aw *AmbientWeather) Init() *AmbientWeather {
 	aw.awnProvider = &awn.AWNProvider{}
 	aw.wuProvider = &wunderground.WUProvider{}
 	aw.l = zerolog.Ctx(aw.appCtx)
+	return aw
 }
 
 func (aw *AmbientWeather) GetAWNHandlerFunc(appCtx context.Context) func(http.ResponseWriter, *http.Request) {
@@ -55,7 +57,7 @@ func (aw *AmbientWeather) GetWundergroundHandlerFunc(appCtx context.Context) fun
 	}
 }
 
-// Takes an HTTP requests and convers it to a
+// Takes an HTTP requests and converts it to a
 // stable type. Enrich is called on the type to complete
 // any missing fields as the two providers supported by Ambient
 // devices (awn/wunderground) produce different fields
@@ -85,6 +87,7 @@ func (aw *AmbientWeather) handleProviderRequest(
 
 		w.WriteHeader(http.StatusInternalServerError)
 		w.Write([]byte(err.Error()))
+		return
 	}
 
 	// Calculate any fields that may be missing

pkg/provider/awn/provider.go

@@ -39,31 +39,46 @@ func MapAwnUpdate(awnUpdate *AmbientWeatherUpdate) *weather.WeatherUpdate {
 	}
 
 	return &weather.WeatherUpdate{
-		StationType:       awnUpdate.StationType,
+		StationType:    awnUpdate.StationType,
-		DateUTC:           &updateTime,
+		DateUTC:        &updateTime,
-		TempOutdoorF:             awnUpdate.TempF,
+		TempOutdoorF:   awnUpdate.TempF,
-		HumidityOudoor:          awnUpdate.Humidity,
+		HumidityOudoor: awnUpdate.Humidity,
-		WindSpeedMPH:      awnUpdate.WindGustMPH,
+		WindSpeedMPH:   awnUpdate.WindSpeedMPH,
-		WindGustMPH:       awnUpdate.WindGustMPH,
+		WindGustMPH:    awnUpdate.WindGustMPH,
-		MaxDailyGust:      awnUpdate.MaxDailyGust,
+		MaxDailyGust:   awnUpdate.MaxDailyGust,
-		WindDir:           awnUpdate.WindDir,
+		WindDir:        awnUpdate.WindDir,
-		WindDirAvg10m:     awnUpdate.WindDirAVG10m,
+		WindDirAvg10m:  awnUpdate.WindDirAVG10m,
-		UV:                awnUpdate.UV,
+		UV:             awnUpdate.UV,
-		SolarRadiation:    awnUpdate.SolarRadiation,
+		SolarRadiation: awnUpdate.SolarRadiation,
-		HourlyRainIn:      awnUpdate.HourlyRainIn,
+		HourlyRainIn:   awnUpdate.HourlyRainIn,
-		EventRainIn:       awnUpdate.EventRainIn,
+		EventRainIn:    awnUpdate.EventRainIn,
-		DailyRainIn:       awnUpdate.DailyRainIn,
+		DailyRainIn:    awnUpdate.DailyRainIn,
-		WeeklyRainIn:      awnUpdate.WeeklyRainIn,
+		WeeklyRainIn:   awnUpdate.WeeklyRainIn,
-		MonthlyRainIn:     awnUpdate.MonthlyRainIn,
+		MonthlyRainIn:  awnUpdate.MonthlyRainIn,
-		YearlyRainIn:      awnUpdate.YearlyRainIn,
+		YearlyRainIn:   awnUpdate.YearlyRainIn,
-		TotalRainIn:       awnUpdate.TotalRainIn,
+		TotalRainIn:    awnUpdate.TotalRainIn,
-		BattOutdoorSensor: awnUpdate.BattOut,
+		Batteries: []weather.BatteryStatus{
-		BattIndoorSensor:  awnUpdate.BattIn,
+			{
-		BattRainSensor:    awnUpdate.BattRain,
+				Component: "OutdoorSensor",
-		TempIndoorF:       awnUpdate.TempInF,
+				Status:    awnUpdate.BattOut,
-		HumidityIndoor:    awnUpdate.HumidityIn,
+			},
-		BaromRelativeIn:   awnUpdate.BaromRelIn,
+			{
-		BaromAbsoluteIn:   awnUpdate.BaromAbsIn,
+				Component: "IndoorSensor",
+				Status:    awnUpdate.BattIn,
+			},
+			{
+				Component: "RainSensor",
+				Status:    awnUpdate.BattRain,
+			},
+			{
+				Component: "CO2Sensor",
+				Status:    awnUpdate.BattCO2,
+			},
+		},
+		TempIndoorF:     awnUpdate.TempInF,
+		HumidityIndoor:  awnUpdate.HumidityIn,
+		BaromRelativeIn: awnUpdate.BaromRelIn,
+		BaromAbsoluteIn: awnUpdate.BaromAbsIn,
 	}
 }
 

pkg/provider/awn/types.go

@@ -27,4 +27,5 @@ type AmbientWeatherUpdate struct {
 	BaromRelIn     float64 `json:"baromrelin,omitempty" schema:"baromrelin"`
 	BaromAbsIn     float64 `json:"baromabsin,omitempty" schema:"baromabsin"`
 	BattIn         int     `json:"battin,omitempty" schema:"battin"`
+	BattCO2        int     `json:"batt_co2,omitempty" schema:"batt_co2"`
 }

pkg/weather/enrich.go

@@ -5,11 +5,15 @@ import "math"
 // Attempts to complete missing fields that may not
 // be set by a specific provider, such as DewPoint and WindChill
 func (u *WeatherUpdate) Enrich() {
+	if u == nil {
+		return
+	}
+
 	if u.WindChillF == 0 {
 		u.WindChillF = CalculateWindChill(u.TempOutdoorF, u.WindSpeedMPH)
 	}
 
-	if u.DewPointF == 0 {
+	if u.DewPointF == 0 && (u.TempOutdoorF != 0 && u.HumidityOudoor != 0) {
 		u.DewPointF = CalculateDewPoint(u.TempOutdoorF, float64(u.HumidityOudoor))
 	}
 

pkg/weather/metrics.go

@@ -12,31 +12,29 @@ import (
 
 type WeatherMetrics struct {
 	// Weather Metrics
-	TempOutdoorF      metric.Float64Gauge
+	TempOutdoorF    metric.Float64Gauge
-	TempIndoorF       metric.Float64Gauge
+	TempIndoorF     metric.Float64Gauge
-	HumidityOudoor    metric.Int64Gauge
+	HumidityOudoor  metric.Int64Gauge
-	HumidityIndoor    metric.Int64Gauge
+	HumidityIndoor  metric.Int64Gauge
-	WindSpeedMPH      metric.Float64Gauge
+	WindSpeedMPH    metric.Float64Gauge
-	WindGustMPH       metric.Float64Gauge
+	WindGustMPH     metric.Float64Gauge
-	MaxDailyGust      metric.Float64Gauge
+	MaxDailyGust    metric.Float64Gauge
-	WindDir           metric.Int64Gauge
+	WindDir         metric.Int64Gauge
-	WindDirAvg10m     metric.Int64Gauge
+	WindDirAvg10m   metric.Int64Gauge
-	UV                metric.Int64Gauge
+	UV              metric.Int64Gauge
-	SolarRadiation    metric.Float64Gauge
+	SolarRadiation  metric.Float64Gauge
-	HourlyRainIn      metric.Float64Gauge
+	HourlyRainIn    metric.Float64Gauge
-	EventRainIn       metric.Float64Gauge
+	EventRainIn     metric.Float64Gauge
-	DailyRainIn       metric.Float64Gauge
+	DailyRainIn     metric.Float64Gauge
-	WeeklyRainIn      metric.Float64Gauge
+	WeeklyRainIn    metric.Float64Gauge
-	MonthlyRainIn     metric.Float64Gauge
+	MonthlyRainIn   metric.Float64Gauge
-	YearlyRainIn      metric.Float64Gauge
+	YearlyRainIn    metric.Float64Gauge
-	TotalRainIn       metric.Float64Gauge
+	TotalRainIn     metric.Float64Gauge
-	BattOutdoorSensor metric.Int64Gauge
+	BatteryStatus   metric.Int64Gauge
-	BattIndoorSensor  metric.Int64Gauge
+	BaromRelativeIn metric.Float64Gauge
-	BattRainSensor    metric.Int64Gauge
+	BaromAbsoluteIn metric.Float64Gauge
-	BaromRelativeIn   metric.Float64Gauge
+	DewPointF       metric.Float64Gauge
-	BaromAbsoluteIn   metric.Float64Gauge
+	WindChillF      metric.Float64Gauge
-	DewPointF         metric.Float64Gauge
-	WindChillF        metric.Float64Gauge
 
 	// Internal Telemetry
 	UpdatesReceived metric.Int64Counter
@@ -45,6 +43,8 @@ type WeatherMetrics struct {
 	meter           metric.Meter
 }
 
+var MetricPrefix = "weather"
+
 func MustInitMetrics(appCtx context.Context) *WeatherMetrics {
 	wm := &WeatherMetrics{
 		appCtx: appCtx,
@@ -54,59 +54,55 @@ func MustInitMetrics(appCtx context.Context) *WeatherMetrics {
 	wm.meter = otel.GetMeter(appCtx, "weather", "metrics")
 
 	// Weather Metrics
-	wm.TempOutdoorF, _ = wm.meter.Float64Gauge("weather_temp_outdoor_f",
+	wm.TempOutdoorF, _ = wm.meter.Float64Gauge(MetricPrefix+"_temp_outdoor_f",
 		metric.WithDescription("Outdoor Temperature in Faherenheit"))
-	wm.TempIndoorF, _ = wm.meter.Float64Gauge("weather_temp_indoor_f",
+	wm.TempIndoorF, _ = wm.meter.Float64Gauge(MetricPrefix+"_temp_indoor_f",
 		metric.WithDescription("Indoor Temperature in Faherenheit"))
-	wm.HumidityOudoor, _ = wm.meter.Int64Gauge("weather_humidity_oudoor",
+	wm.HumidityOudoor, _ = wm.meter.Int64Gauge(MetricPrefix+"_humidity_outdoor",
 		metric.WithDescription("Outdoor Humidity %"))
-	wm.HumidityIndoor, _ = wm.meter.Int64Gauge("weather_humidity_indoor",
+	wm.HumidityIndoor, _ = wm.meter.Int64Gauge(MetricPrefix+"_humidity_indoor",
 		metric.WithDescription("Indoor Humidity %"))
-	wm.WindSpeedMPH, _ = wm.meter.Float64Gauge("weather_wind_speed_mph",
+	wm.WindSpeedMPH, _ = wm.meter.Float64Gauge(MetricPrefix+"_wind_speed_mph",
 		metric.WithDescription("Wind Speed in MPH"))
-	wm.WindGustMPH, _ = wm.meter.Float64Gauge("weather_wind_gust_mph",
+	wm.WindGustMPH, _ = wm.meter.Float64Gauge(MetricPrefix+"_wind_gust_mph",
 		metric.WithDescription("Wind Gust in MPH"))
-	wm.MaxDailyGust, _ = wm.meter.Float64Gauge("weather_max_daily_gust",
+	wm.MaxDailyGust, _ = wm.meter.Float64Gauge(MetricPrefix+"_max_daily_gust",
 		metric.WithDescription("Max Daily Wind Gust"))
-	wm.WindDir, _ = wm.meter.Int64Gauge("weather_wind_dir",
+	wm.WindDir, _ = wm.meter.Int64Gauge(MetricPrefix+"_wind_dir",
 		metric.WithDescription("Wind Direction in Degrees"))
-	wm.WindDirAvg10m, _ = wm.meter.Int64Gauge("weather_wind_dir_avg_10m",
+	wm.WindDirAvg10m, _ = wm.meter.Int64Gauge(MetricPrefix+"_wind_dir_avg_10m",
 		metric.WithDescription("Wind Direction 10m Average"))
-	wm.UV, _ = wm.meter.Int64Gauge("weather_uv",
+	wm.UV, _ = wm.meter.Int64Gauge(MetricPrefix+"_uv",
 		metric.WithDescription("UV Index"))
-	wm.SolarRadiation, _ = wm.meter.Float64Gauge("weather_solar_radiation",
+	wm.SolarRadiation, _ = wm.meter.Float64Gauge(MetricPrefix+"_solar_radiation",
 		metric.WithDescription("Solar Radiation in W/㎡"))
-	wm.HourlyRainIn, _ = wm.meter.Float64Gauge("weather_hourly_rain_in",
+	wm.HourlyRainIn, _ = wm.meter.Float64Gauge(MetricPrefix+"_hourly_rain_in",
 		metric.WithDescription("Hourly Rain in Inches"))
-	wm.EventRainIn, _ = wm.meter.Float64Gauge("weather_event_rain_in",
+	wm.EventRainIn, _ = wm.meter.Float64Gauge(MetricPrefix+"_event_rain_in",
 		metric.WithDescription("Event Rain in Inches"))
-	wm.DailyRainIn, _ = wm.meter.Float64Gauge("weather_daily_rain_in",
+	wm.DailyRainIn, _ = wm.meter.Float64Gauge(MetricPrefix+"_daily_rain_in",
 		metric.WithDescription("Daily Rain in Inches"))
-	wm.WeeklyRainIn, _ = wm.meter.Float64Gauge("weather_weekly_rain_in",
+	wm.WeeklyRainIn, _ = wm.meter.Float64Gauge(MetricPrefix+"_weekly_rain_in",
 		metric.WithDescription("Weekly Rain in Inches"))
-	wm.MonthlyRainIn, _ = wm.meter.Float64Gauge("weather_monthly_rain_in",
+	wm.MonthlyRainIn, _ = wm.meter.Float64Gauge(MetricPrefix+"_monthly_rain_in",
 		metric.WithDescription("Monthly Rain in Inches"))
-	wm.YearlyRainIn, _ = wm.meter.Float64Gauge("weather_yearly_rain_in",
+	wm.YearlyRainIn, _ = wm.meter.Float64Gauge(MetricPrefix+"_yearly_rain_in",
 		metric.WithDescription("Yearly Rain in Inches"))
-	wm.TotalRainIn, _ = wm.meter.Float64Gauge("weather_total_rain_in",
+	wm.TotalRainIn, _ = wm.meter.Float64Gauge(MetricPrefix+"_total_rain_in",
 		metric.WithDescription("Total Rain in Inches"))
-	wm.BattOutdoorSensor, _ = wm.meter.Int64Gauge("weather_batt_outdoor_sensor",
+	wm.BatteryStatus, _ = wm.meter.Int64Gauge(MetricPrefix+"_battery_status",
-		metric.WithDescription("Outdoor Equipment Battery"))
+		metric.WithDescription("Per-component battery status"))
-	wm.BattIndoorSensor, _ = wm.meter.Int64Gauge("weather_batt_indoor_sensor",
+	wm.BaromRelativeIn, _ = wm.meter.Float64Gauge(MetricPrefix+"_barometric_pressure_relative_in",
-		metric.WithDescription("Indoor Equipmenet Battery"))
-	wm.BattRainSensor, _ = wm.meter.Int64Gauge("weather_batt_rain_sensor",
-		metric.WithDescription("Rain Sensor Battery"))
-	wm.BaromRelativeIn, _ = wm.meter.Float64Gauge("weather_barometric_pressure_relative_in",
 		metric.WithDescription("Relative Pressure in Inches of Mercury"))
-	wm.BaromAbsoluteIn, _ = wm.meter.Float64Gauge("weather_barometric_pressure_absolute_in",
+	wm.BaromAbsoluteIn, _ = wm.meter.Float64Gauge(MetricPrefix+"_barometric_pressure_absolute_in",
 		metric.WithDescription("Absolute Pressure in Inches of Mercury"))
-	wm.DewPointF, _ = wm.meter.Float64Gauge("weather_dew_point_f",
+	wm.DewPointF, _ = wm.meter.Float64Gauge(MetricPrefix+"_dew_point_f",
 		metric.WithDescription("Dew Point in Faherenheit"))
-	wm.WindChillF, _ = wm.meter.Float64Gauge("weather_wind_chill_f",
+	wm.WindChillF, _ = wm.meter.Float64Gauge(MetricPrefix+"_wind_chill_f",
 		metric.WithDescription("Wind Chill in Faherenheit"))
 
 	// Internal Telemetry
-	wm.UpdatesReceived, _ = wm.meter.Int64Counter("weather_updates_received",
+	wm.UpdatesReceived, _ = wm.meter.Int64Counter(MetricPrefix+"_updates_received",
 		metric.WithDescription("Metric Updates Processed by Exporter"))
 
 	return wm
@@ -136,13 +132,18 @@ func (wm *WeatherMetrics) Update(u *WeatherUpdate) {
 	wm.MonthlyRainIn.Record(wm.appCtx, u.MonthlyRainIn, metric.WithAttributeSet(attributes))
 	wm.YearlyRainIn.Record(wm.appCtx, u.YearlyRainIn, metric.WithAttributeSet(attributes))
 	wm.TotalRainIn.Record(wm.appCtx, u.TotalRainIn, metric.WithAttributeSet(attributes))
-	wm.BattOutdoorSensor.Record(wm.appCtx, int64(u.BattOutdoorSensor), metric.WithAttributeSet(attributes))
-	wm.BattIndoorSensor.Record(wm.appCtx, int64(u.BattIndoorSensor), metric.WithAttributeSet(attributes))
-	wm.BattRainSensor.Record(wm.appCtx, int64(u.BattRainSensor), metric.WithAttributeSet(attributes))
 	wm.BaromRelativeIn.Record(wm.appCtx, u.BaromRelativeIn, metric.WithAttributeSet(attributes))
 	wm.BaromAbsoluteIn.Record(wm.appCtx, u.BaromAbsoluteIn, metric.WithAttributeSet(attributes))
 	wm.DewPointF.Record(wm.appCtx, u.DewPointF, metric.WithAttributeSet(attributes))
 	wm.WindChillF.Record(wm.appCtx, u.WindChillF, metric.WithAttributeSet(attributes))
 
+	// Batteries
+	for _, battery := range u.Batteries {
+		wm.BatteryStatus.Record(wm.appCtx, int64(battery.Status),
+			metric.WithAttributeSet(attributes),
+			metric.WithAttributes(attribute.String("component", battery.Component)),
+		)
+	}
+
 	wm.UpdatesReceived.Add(wm.appCtx, 1)
 }

pkg/weather/types.go

@@ -7,33 +7,40 @@ import (
 // Stable intermediate struct containing superset of fields
 // between AWN and Wunderground style updates from Ambient devices
 type WeatherUpdate struct {
-	DateUTC           *time.Time
+	DateUTC        *time.Time
-	StationType       string
+	StationType    string
-	TempOutdoorF      float64
+	TempOutdoorF   float64
-	TempIndoorF       float64
+	TempIndoorF    float64
-	HumidityOudoor    int
+	HumidityOudoor int
-	HumidityIndoor    int
+	HumidityIndoor int
-	WindSpeedMPH      float64
+	WindSpeedMPH   float64
-	WindGustMPH       float64
+	WindGustMPH    float64
-	MaxDailyGust      float64
+	MaxDailyGust   float64
-	WindDir           int
+	WindDir        int
-	WindDirAvg10m     int
+	WindDirAvg10m  int
-	UV                int
+	UV             int
-	SolarRadiation    float64
+	SolarRadiation float64
-	HourlyRainIn      float64
+	HourlyRainIn   float64
-	EventRainIn       float64
+	EventRainIn    float64
-	DailyRainIn       float64
+	DailyRainIn    float64
-	WeeklyRainIn      float64
+	WeeklyRainIn   float64
-	MonthlyRainIn     float64
+	MonthlyRainIn  float64
-	YearlyRainIn      float64
+	YearlyRainIn   float64
-	TotalRainIn       float64
+	TotalRainIn    float64
-	BattOutdoorSensor int
+	Batteries      []BatteryStatus
-	BattIndoorSensor  int
+	// BattOutdoorSensor int
-	BattRainSensor    int
+	// BattIndoorSensor  int
-	BaromRelativeIn   float64
+	// BattRainSensor    int
-	BaromAbsoluteIn   float64
+	// BattCO2Sensor     int
+	BaromRelativeIn float64
+	BaromAbsoluteIn float64
 	// These fields may be calculated
 	// if not otherwise set
 	DewPointF  float64
 	WindChillF float64
 }
+
+type BatteryStatus struct {
+	Component string
+	Status    int
+}