3.2 KiB
title, description, ha_category, ha_release, ha_domain
| title | description | ha_category | ha_release | ha_domain | |
|---|---|---|---|---|---|
| Google Pub/Sub | Setup for Google Pub/Sub integration |
|
0.88 | google_pubsub |
The google_pubsub integration allows you to hook into the Home Assistant event bus and send events to Google Cloud Pub/Sub. The current free tier of GCP should allow you to sync about 1 event every 2 seconds on average (2 million invocations per month).
First time setup
This assumes you already have a Google Cloud project. If you don't, please create one in the Google Cloud Console
You need to create a Service Account key in the Google Cloud API Console
- Choose a new "New Service Account", give it a name and leave the key type as JSON
- Select the role: Pub/Sub Publisher
This will download the Service Account JSON key to your machine. Do NOT share this with anyone. Place this file in your Home Assistant configuration folder.
Next, create a Google Pub/Sub topic in the Google Cloud API Console. The topic name will become something like projects/project-198373/topics/topic-name. Note the last part only (the name you chose): topic-name.
Configuration
Add the following lines to your configuration.yaml file:
# Example configuration.yaml entry
google_pubsub:
project_id: YOUR_PROJECT_ID
topic_name: YOUR_TOPIC_NAME
credentials_json: CREDENTIALS_FILENAME
{% configuration %}
project_id:
description: Project ID from the Google console (looks like words-2ab12).
required: true
type: string
topic_name:
description: The Pub/Sub relative topic name (looks like hass).
required: true
type: string
credentials_json:
description: The filename of the Google Service Account JSON file.
required: true
type: string
filter:
description: Filter domains and entities for Google Cloud Pub/Sub.
required: true
type: map
keys:
include_domains:
description: List of domains to include (e.g., light).
required: false
type: list
exclude_domains:
description: List of domains to exclude (e.g., light).
required: false
type: list
include_entities:
description: List of entities to include (e.g., light.attic).
required: false
type: list
exclude_entities:
description: List of entities to include (e.g., light.attic).
required: false
type: list
{% endconfiguration %}
Saving the data using a Google Cloud Function
To save your data automatically to BigQuery, follow the instructions here. The current free tier of GCP should allow to store up to 10GB of data.