GCP Pub/Sub Connector

Last updated:

What does the Google Cloud Pub/Sub Connector do?

This app sends events from PostHog to a Google Cloud Pub/Sub topic when they are ingested. It's used by teams such as Vendasta.

What are the requirements for this app?

The Pub/Sub Connector requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.30.0 or later.

Not running 1.30.0? Find out how to update your self-hosted PostHog deployment!

You'll also need a Google Cloud Pub/Sub account to connect to.

How do I install the Google Cloud Pub/Sub Connector?

  1. Visit the 'Apps' page in your instance of PostHog.
  2. Search for 'Pub/Sub' and select the app, press Install.
  3. Upload your Google Cloud key .json file. (How to get the file.)
  4. Enter your Topic ID.
  5. Watch events publish to Topic.

Where is my Google Cloud key .json file?

You'll need this file to configure the Pub/Sub app for PostHog. You can find out where to find it in Google's Pub/Sub client libraries documentation.

Configuration

OptionDescription
JSON file with your google cloud key
Type: attachment
Required: True
Topic ID
Type: string
Required: True
A topic will be created if it does not exist.
Events to ignore
Type: string
Required: False
Comma separated list of events to ignore
Maximum upload size in bytes
Type: string
Required: False
Default 1MB. Upload events after buffering this many of them. The value must be between 1 MB and 10 MB.
Export events at least every X seconds
Type: string
Required: False
Default 30 seconds. If there are events to upload and this many seconds has passed since the last upload, then upload the queued events. The value must be between 1 and 600 seconds.

Is the source code for this app available?

PostHog is open-source and so are all apps on the platform. The source code for the Google Cloud Pub/Sub Connector is available on GitHub.

Who created this app?

We'd like to thank PostHog community member Jesse Redl from Vendasta for creating the Pub/Sub Connector. Thanks, Jesse!

Who maintains this app?

This app is maintained by the community. If you have issues with the app not functioning as intended, please raise a bug report on the repo to let us know!

What if I have feedback on this app?

We love feature requests and feedback! Please create an issue to tell us what you think.

What if my question isn't answered above?

We love answering questions. Ask us anything via our Support page.

You can also join the PostHog Community Slack group to collaborate with others and get advice on developing your own PostHog apps.

Questions?

Was this page useful?

Next article

Google Cloud Export

What does the Google Cloud Storage Export app do? The Google Cloud Storage Export app enables you to send events from PostHog to a Google Cloud Storage bucket upon ingestion. What are the requirements for this app? The Google Cloud Storage Export app requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.30.0 or later. Not running 1.30.0? Find out how to update your self-hosted PostHog deployment ! You'll also need access to the Google Cloud Storage bucket you want…

Read next article