home-assistant.io/source/components/logbook.markdown

layout	title	description	date	sidebar	comments	sharing	footer
page	Logbook support	Instructions how to enable the logbook component for Home Assistant.	2015-04-25 9:23	false	false	true	true

The logbook component provides a different perspective on the history of your house by showing all the changes that happened to your house in reverse chronological order. [See the demo for a live example](/demo/).

To enable the logbook in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
logbook:

It is possible to add custom entries to the logbook by using the script component to fire an event.

# Example configuration.yaml entry
script:
  add_logbook_entry:
    alias: Add Logbook
    sequence:
      - event: LOGBOOK_ENTRY
        event_data:
          name: Kitchen
          message: is being used
          # Optional
          entity_id: light.kitchen
          domain: light