Schema Enforcer

The app enables you to enforce a schema on events in PostHog as they are ingested. It does this by preventing ingestion if the event:

Is missing a required property
Has a property with the wrong type
Is not included in the file and onlyIngestEventsFromFile is true

It also:

Removes all other properties from an event except selected ones if acceptOnlySchemaProps is true
Configuration is done via a JSON file uploaded as an attachment

Requirements

The Schema Enforcer 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!

Installation

Log in to your PostHog instance
Click "Data pipeline" in the left sidebar
Search for 'Schema Enforcer'
Select the app, press 'Install' and follow the on-screen instructions

Configuration

Below is an example configuration file:

{
    "onlyIngestEventsFromFile": true,
    "eventSchemas": {
        "testEvent": {
            "acceptOnlySchemaProps": true,
            "schema": {
                "foo": {
                    "type": "string",
                    "required": false
                },
                "bar": {
                    "type": "number",
                    "required": true
                },
                "baz": {
                    "type": "boolean",
                    "required": false
                }
            }
        }
    }
}

Additional configuration

Option	Description
`Event Schema JSON File` Type: attachment Required: True	A valid JSON file

FAQ

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 Schema Enforcer is available on NPM.

Who created this app?

A lot of people worked on this app! We'd like to thank the following PostHog team members...

For creating the Schema Enforcer. Thank you, all!

Who maintains this app?

This app is maintained by PostHog. If you have issues with the app not functioning as intended, please let us know!

What if I have feedback on this app?

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

What if my question isn't answered above?

We love answering questions. Ask us anything via our community forum, or drop us a message.