{"id":46140343,"url":"https://github.com/gunnjr/ha-logger-manager","last_synced_at":"2026-03-02T06:01:01.080Z","repository":{"id":322016892,"uuid":"1087930424","full_name":"gunnjr/ha-logger-manager","owner":"gunnjr","description":"A Home Assistant custom integration that makes it easier/faster to manager logger levels. It provide a user interface (Dashboard Card) that makes it easy to discover, select, and configure loggers. With it, users can quickly dial in logging specific to their task or challenge.","archived":false,"fork":false,"pushed_at":"2025-11-14T00:37:13.000Z","size":868,"stargazers_count":2,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-14T02:27:52.141Z","etag":null,"topics":["hacs","home-assistant","home-assistant-integration","logger","logging"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gunnjr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-01T23:50:46.000Z","updated_at":"2025-11-14T00:28:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gunnjr/ha-logger-manager","commit_stats":null,"previous_names":["gunnjr/ha-logger-manager"],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/gunnjr/ha-logger-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gunnjr%2Fha-logger-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gunnjr%2Fha-logger-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gunnjr%2Fha-logger-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gunnjr%2Fha-logger-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gunnjr","download_url":"https://codeload.github.com/gunnjr/ha-logger-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gunnjr%2Fha-logger-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29993532,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-02T01:47:34.672Z","status":"online","status_checked_at":"2026-03-02T02:00:07.342Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacs","home-assistant","home-assistant-integration","logger","logging"],"created_at":"2026-03-02T06:01:00.477Z","updated_at":"2026-03-02T06:01:01.075Z","avatar_url":"https://github.com/gunnjr.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"logo.png\" alt=\"Logger Manager Logo\" width=\"200\"/\u003e\n\n# Logger Manager\n\nA Home Assistant integration for managing logging levels\n\n[![HACS](https://img.shields.io/badge/HACS-Default-41BDF5.svg)](https://github.com/hacs/integration)\n[![GitHub Release](https://img.shields.io/github/release/gunnjr/ha-logger-manager.svg)](https://github.com/gunnjr/ha-logger-manager/releases)\n[![License](https://img.shields.io/github/license/gunnjr/ha-logger-manager.svg)](LICENSE)\n\n\u003c/div\u003e\n\n---\n\n\u003e **Note**: This is my first published Home Assistant integration. While it works and is useful, it may need improvements and hardening as more people use it. Feedback, issues, and contributions are welcome!\n\n---\n\n## Version 1.1.1\n\n### What's New\n\n1. **Bug Fix:**  \n   - Fixed issue where pressing return on the config screen submitted the form instead of allowing multiple lines. You can now enter multiple patterns as a YAML list.\n\n2. **Documentation:**  \n   - Refreshed README file for clarity and accuracy.\n\n3. **Usability:**  \n   - Logger names in the selection bin are now right-justified, making it easier to see the most relevant part of long logger names.\n\n---\n\n## Overview\n\nLogger Manager aims to solve a common frustration for Home Assistant developers and power users: **managing logging levels is tedious**.\n\n## Target Users\n**Power Home Assistant users** who need to leverage HA debug logging for:\n- Custom integration development\n- Issue diagnosis and troubleshooting\n- System optimization and monitoring\n- Integration debugging and testing\n\n## The Problem\n\u003e **Power HA users need precise, discoverable, and fast logger control for debugging/development, but current methods are either too slow (configuration.yaml + reboot), imprecise (setting default logger level), too obscure (non-discoverable loggers), or too time consuming (writing use-case specific logger control scripts), forcing users to miss out on otherwise helpful debug logging or deal with unmanageably verbose default debug logging.**\n\n## The Solution\n\nLogger Manager aims to solve this with a **power user targeted** user interface that makes it easy to discover, select, and configure loggers. Using the provided lovelace card, users can quickly dial in logging specific to their task or challenge.\n\n## Installation\n\n### HACS Custom Repository (Current Method)\n1. Open HACS → Integrations\n2. Click the three dots (⋮) in the top-right corner\n3. Select \"Custom repositories\"\n4. Add repository URL: `https://github.com/gunnjr/ha-logger-manager`\n5. Category: `Integration`\n6. Click \"Add\"\n7. Find \"Logger Manager\" in the list and click \"Download\"\n8. Restart Home Assistant\n9. Continue to [Setup](#setup) below\n\n### HACS Default Repository (planned)\n\n## Setup\n\n### Step 1: Add the Integration\n\nAfter installation and restart:\n\n1. Go to **Settings** → **Devices \u0026 Services**\n2. Click **\"+ Add Integration\"** (bottom-right)\n3. Search for **\"Logger Manager\"**\n4. Click on it to add\n5. Click **\"Submit\"** (no configuration needed)\n\nThe integration will automatically:\n- Create `sensor.logger_levels` entity\n- Register `logger_manager.apply_levels` and `logger_manager.refresh_logger_cache` services\n- Register the frontend card resource (storage mode only)\n\n### Step 2: Add the UI Card to any Dashboard\n\nThe card resource is automatically registered when you add the integration. To use it:\n\n1. Navigate to any dashboard\n2. Click **Edit Dashboard** (top-right)\n3. Click **\"+ Add Card\"**\n4. Search for **\"Logger Manager Card\"** or scroll to find it\n5. Click to add it to your dashboard\n6. Click **\"Done\"** to save\n\n**If the card doesn't appear in the card picker:**\n- Hard refresh your browser: `Ctrl+F5` (Windows/Linux) or `Cmd+Shift+R` (Mac)\n- Check Settings → Dashboards → Resources to verify the card is listed\n- For YAML mode dashboards, see [YAML Configuration](#yaml-configuration) below\n\n## Solution Components\n### How the components work together\nThe UI is the primarily intended value of this integration, supported by the underlying sensor and services.  However, the unterlying componts are availible for direct access and can be useful on a stand-alone basis (especially for automations), **the UI card is the primary reason to use Logger Manager**.\n### 1. Interactive Lovelace Card\n- Deployable to any lovelace dashboard\n- Searchable multi-select dropdown of available loggers\n- Easy logger level changes with visual feedback (Critical, Error, Warning, Info, Debug, Notset)\n- Bulk operations - modify multiple loggers at once\n- **Logger names in the selection bin are now right-justified for better readability**\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cimg src=\"screenshots/logger-card-overview.png\" width=\"100%\" alt=\"Logger Manager Card Overview\"/\u003e\n\u003cp align=\"center\"\u003e\u003cem\u003eLogger Manager Card\u003c/em\u003e\u003c/p\u003e\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cimg src=\"screenshots/logger-dropdown-search.png\" width=\"100%\" alt=\"Logger Dropdown Search\"/\u003e\n\u003cp align=\"center\"\u003e\u003cem\u003eFiltered by search string\u003c/em\u003e\u003c/p\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### 2. Persistent State Sensor (`sensor.logger_levels`)\n- Tracks which loggers you've customized and their current levels\n- Shows default log level and count of managed loggers\n- Powers the UI card and enables automations\n\n![Logger Sensor State](screenshots/logger-sensor-state.png)\n\n### 3. Management Services\n- `logger_manager.apply_levels` - Programmatically change and track logger levels\n- Services maintain managed logger state across HA restarts\n- Enable automation-based logging control\n- Similar to HA's built-in `logger.set_level` but maintains the list of managed loggers on the sensor for use by the UI and otherwise.\n\n```yaml\nservice: logger_manager.apply_levels\ndata:\n  level: debug\n  loggers:\n    - homeassistant.components.zha\n    - custom_components.logger_manager\n```\n\n### Availible loggers: Common Logger Names\nThe list of availible loggers is currenly contrained to those for envisioned usecases. The critera is currently hardcoded as follows. The developer intends to make this configurable.\n### 1. Core integrations\nLoggers with names of containing: `homeassistant`\nExamples: `homeassistant.components.zha`, `homeassistant.components.mqtt`\n\n### 2. Custom integrations\nLoggers with names containing: `custom_components`\nExamples: `custom_components.logger_manager`, `custom_components.hacs`\n\n### 3. Commonly used system loggers\nLoggers with names containing: `asyncio`, `aiohttp`, `urllib3`, `requests`, `aiodns`, `aiofiles`, and `websockets`\n\n## Anticipated Enhancements\nAs time permits, future versions will be enhanced to provide:\n\n### Logger Management UI\n- View all managed loggers in a dedicated card\n- Edit or remove managed logger levels\n\n### Default Log Level Control\n- UI to change Home Assistant's default log level\n- Currently can only be changed via configuration.yaml\n\n### Integrated Dashboard\n- Pre-built dashboard combining all Logger Manager features\n- One-stop shop for all logging needs\n\n## Limitations\n\n- Loggers must exist for level changes to take effect\n- Some third-party libraries may not follow HA logging conventions\n- The sensor updates every 10 seconds, not instantly\n- WebSocket API for logger discovery caches results for 30 minutes\n- Logger discovery patterns are currently hardcoded\n\n## Requirements\n\n- Home Assistant ≥ 2024.6.0\n\n## Troubleshooting\n\n**UI Card Not Appearing in Card Picker:**\n- Hard refresh your browser: `Ctrl+F5` (Windows/Linux) or `Cmd+Shift+R` (Mac)\n- Check Settings → Dashboards → Resources - you should see `/hacsfiles/logger_manager/ha-logger-multiselect-card.js`\n- If using YAML mode dashboards, you must manually add the resource (see [YAML Configuration](#yaml-configuration))\n- Check browser console (F12) for JavaScript errors\n- Verify the integration is installed and loaded in Settings → Devices \u0026 Services\n\n**Card Resource Not Auto-Registered:**\n- Automatic registration only works in storage mode (default for most users)\n- Check your Lovelace mode: if dashboards are defined in `configuration.yaml`, you're using YAML mode\n- For YAML mode, manually add the resource as described in [YAML Configuration](#yaml-configuration)\n- Check Home Assistant logs for any frontend registration errors\n\n**Logger Not in Dropdown:**\n- Use the `logger_manager.refresh_logger_cache` service to force a refresh\n- Verify the integration/component is actually loaded in Home Assistant\n- Some third-party libraries may not appear if they don't follow standard naming conventions\n- The cache refreshes automatically every 30 minutes\n\n**Log Levels Not Persisting After Restart:**\n- Logger Manager stores managed loggers in `.storage/logger_manager`\n- Check file permissions if levels disappear after restart\n- Verify the integration is properly loaded on startup\n- Check Home Assistant logs for any storage-related errors\n\n## Contributing\n\nThis is a learning project and my first HA integration. Contributions, suggestions, and constructive feedback are very welcome:\n- Report issues\n- Suggest improvements\n- Submit pull requests\n- Share usage patterns\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**[⬆ Back to Top](#logger-manager)**\n\nBuilt for Home Assistant developers and power users\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgunnjr%2Fha-logger-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgunnjr%2Fha-logger-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgunnjr%2Fha-logger-manager/lists"}