v2.0.07 - Manual Devices and Authentication Updates

Release Notes - Version 2.0.07

Key Updates

1. Upgrade to Python 3.12.6:

   • Updated the base image from python:3.12.3-slim to python:3.12.6-slim to incorporate the latest bug fixes and performance improvements.

2. Updated python-kasa to Version 0.7.4:

   • Enhanced device support and improved stability for interacting with Kasa devices using the python-kasa library.

3. Updated influxdb_client to Version 1.46.0:

   • Upgraded from influxdb_client==1.40.0 to influxdb_client==1.46.0 to ensure compatibility and take advantage of new features, optimizations, and bug fixes provided in the latest version.

4. Manually Defined Device Hosts:

   • Introduced the ability to specify manual device hosts using the KASA_COLLECTOR_DEVICE_HOSTS environment variable. This allows users to define specific IP addresses or hostnames of devices they want to monitor, regardless of auto-discovery settings.
   • Updated initialization and discovery processes to respect manually defined hosts and avoid conflicts or reinitialization of devices.

5. Enhanced Device Discovery and Initialization:

   • Refactored the discovery process to prevent conflicts between manually added and auto-discovered devices.
   • Improved handling and logging for scenarios where devices are already initialized manually, avoiding duplicate entries and repetitive logs.
   • Added KASA_COLLECTOR_ENABLE_AUTO_DISCOVERY for configurable discovery, allowing users to disable auto-discovery when manually managing devices.

6. Improved SysInfo Handling:

   • Added normalization for fw_ver and sw_ver fields to sw_ver for consistent logging and data representation across devices with differing field names for software versions.
   • Refined the sysinfo processing function to handle new field formats and avoid missing data in InfluxDB storage.

7. Expanded Authentication Support:

   • Introduced support for KASA_COLLECTOR_TPLINK_USERNAME and KASA_COLLECTOR_TPLINK_PASSWORD to enable authentication for devices associated with a TP-Link account, expanding compatibility with newer devices.

8. New Environment Variables:

   • Added several new optional environment variables to enhance configurability:
     • KASA_COLLECTOR_DEVICE_HOSTS: Allows manual configuration of device IPs/hostnames for monitoring.
     • KASA_COLLECTOR_ENABLE_AUTO_DISCOVERY: Toggle for enabling/disabling automatic device discovery.
     • KASA_COLLECTOR_TPLINK_USERNAME and KASA_COLLECTOR_TPLINK_PASSWORD: For authenticating with TP-Link accounts.

9. Documentation Updates:

   • Updated documentation to reflect new environment variables and enhanced configuration options.
   • Clarified instructions for setting up manual devices and configuring account-based authentication.
   • Added detailed explanations for all supported environment variables, distinguishing between required and optional settings.

Migration Notes

• Environment Variable Changes:

  • Update your environment configuration to include any new variables, especially KASA_COLLECTOR_DEVICE_HOSTS if you need to define specific devices manually and KASA_COLLECTOR_TPLINK_USERNAME/KASA_COLLECTOR_TPLINK_PASSWORD for account-based authentication.

• Docker Image Update:

  • Pull the latest image lux4rd0/kasa-collector:2.0.07 to ensure you are running the updated collector with the latest Python and python-kasa versions.

These release notes summarize the significant changes, new features, and bug fixes introduced in version 2.0.07, compared to version 2.0.06, ensuring users have the latest functionalities and enhancements for managing their Kasa devices.