Skip to content

v2.0.8

Latest
Latest

Choose a tag to compare

View all tags
@andrejs2 andrejs2 released this 02 Apr 14:43
v2.0.8
90ac9b8

v2.0.8 — API Traffic Diagnostic Sensors

New Feature: API Request Monitoring

Added two diagnostic sensors per location that provide real-time visibility into the integration's HTTP traffic to ARSO servers. This helps users and developers monitor API usage, detect excessive requests, and diagnose rate limiting or connectivity issues (ref #36).

New sensors (entity category: diagnostic)

Sensor Description
API zahtevkov na uro Rolling 1-hour HTTP request count
API napak na uro Rolling 1-hour error count

Sensor attributes

The requests sensor includes:

  • total_requests — cumulative count since HA startup
  • total_errors — cumulative error count
  • errors_per_hour — rolling hourly error count
  • per_domain — hourly breakdown by domain (vreme.arso.gov.si, meteo.arso.gov.si, www.arso.gov.si, external)
  • total_per_domain — cumulative breakdown by domain
  • uptime_hours — hours since integration loaded

The errors sensor includes:

  • total_errors — cumulative error count
  • per_domain — error breakdown by domain

How it works

All HTTP requests from the integration now flow through a lightweight TrackedClientSession wrapper that counts requests per domain without adding overhead. The tracker maintains a rolling 1-hour window using efficient deque-based timestamps.

Where to find them

Settings → Devices & Services → ARSO Weather → [location device] → Diagnostic section

They can be added to dashboards (e.g., history-graph card) to visualize API traffic over time, or used in automations to alert on excessive request rates.

Request rates per update cycle (for reference)

Coordinator Interval Requests Domains
Weather 15 min 2-3 vreme.arso.gov.si + meteo.arso.gov.si
Webcam 15 min N×M (locations × directions) vreme.arso.gov.si
Warnings 5 min 1-15 meteo.arso.gov.si
Text forecast 60 min 1 vreme.arso.gov.si
Bio weather 60 min 1 vreme.arso.gov.si
Mountain 60 min 3-11 meteo.arso.gov.si
Ski 60 min 2 vreme.arso.gov.si
Agrometeo 60 min 2 meteo.arso.gov.si
Air quality 45 min 2 www.arso.gov.si
UTCI 60 min up to 13 meteo.arso.gov.si
Avalanche 60 min 1-3 static.lawinen-warnung.eu / static.avalanche.report
Assets 2
Loading