jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-26 02:37:03 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add disable and enable services for recorder (#16366)

Browse Source
This commit is contained in:
adrian-vlad 2021-02-24 15:34:35 +02:00 committed by GitHub
parent ea69f1080b
commit 258cfd99ac
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
source/_integrations/recorder.markdown
View File

@ -199,6 +199,8 @@ recorder:
- sensor.weather_*
```
## Services
### Service `purge`
Call the service `recorder.purge` to start a purge task which deletes events and states older than x days, according to `keep_days` service data.
@ -209,6 +211,14 @@ Note that purging will not immediately decrease disk space usage but it will sig
| `keep_days` | yes | The number of history days to keep in recorder database (defaults to the integration `purge_keep_days` configuration) |
| `repack` | yes | When using SQLite or PostgreSQL this will rewrite the entire database. When using MySQL or MariaDB it will optimize or recreate the events and states tables. This is a heavy operation that can cause slowdowns and increased disk space usage while it runs. Only supported by SQLite, PostgreSQL, MySQL and MariaDB. |
### Service `disable`
Call the service `recorder.disable` to stop saving events and states to the database.
### Service `enable`
Call the service `recorder.enable` to start again saving events and states to the database. This is the opposite of `recorder.disable`.
## Custom database engines
| Database engine | `db_url` |