PostHog · corywatilo · May 13, 2022 · Mar 30, 2022 · Mar 30, 2022 · Mar 30, 2022
diff --git a/contents/apps/airbyte-export/docs.md b/contents/apps/airbyte-export/docs.md
@@ -0,0 +1,48 @@
+---
+title: Airbyte Exporter documentation
+showTitle: true
+topics:
+    - airbyte
+---
+
+### What does the Airbyte Export app do?
+
+This Airbyte Export app sends data from PostHog, to Airbyte. It supports both Full Refresh and Incremental syncs. You can choose if this app will copy only the new or updated event data, or all rows in the tables and columns you set up for replication, every time a sync is run.
+
+###### What are the requirements for this app?
+
+Using the Airbyte Export app requires either PostHog Cloud, or a self-hosted PostHog instance running [version 1.30.0](https://posthog.com/blog/the-posthog-array-1-30-0) or later. 
+
+Not running 1.30.0? Find out [how to update your self-hosted PostHog deployment](https://posthog.com/docs/self-host/configure/upgrading-posthog)! 
+
+##### How do I get started with the Airbyte Export app?
+
+The Airbyte app is an API integration. You will need to get a [PostHog Personal API key](https://posthog.com/docs/api) in order to [connect Airbyte as a data destination](https://docs.airbyte.com/integrations/sources/posthog/).
+
+#### What output schema is available?
+
+This app is capable of syncing the following streams: 
+
+- Annotations
+- Cohorts
+- Events
+- FeatureFlags
+- Insights
+- InsightsPath
+- InsightsSessions
+- Persons
+- Trends
+
+For more information, please check [Airbyte's integration documentation](https://docs.airbyte.com/integrations/sources/posthog/).
+
+### Where can I find out more?
+
+Check [PostHog's API documentation](https://posthog.com/docs/api) for more information on pulling and pushing data from/to our API. Further information about Airbyte's connector is available in [Airbyte's integration documentation](https://docs.airbyte.com/integrations/sources/posthog/).
+
+### What if I have feedback on this app?
+
+We love feature requests and feedback! Please [create an issue](https://github.com/PostHog/posthog/issues/new?assignees=&labels=enhancement%2C+feature&template=feature_request.md) to tell us what you think. 
+
+### What if my question isn't answered above?
+
+You can [join the PostHog Community Slack group](/slack) to ask more questions, or get advice on developing your own PostHog apps.
diff --git a/contents/apps/airbyte-export/index.mdx b/contents/apps/airbyte-export/index.mdx
@@ -0,0 +1,30 @@
+---
+title: Airbyte Exporter
+featuredImage: 
+documentation: /apps/airbyte-export/docs
+thumbnail: ../thumbnails/airbyte.png
+filters: {
+    type: ["data-out"],
+    maintainer: community
+}
+---
+
+<Section
+    divider={false}
+    title="Sync PostHog events to Airbyte and build open-source ELT pipelines to move transformed data anywhere."
+    size="full"
+    cols={2}
+>
+    <div>
+        <h5>Send data anywhere, for anything</h5>
+        <p>Export events to Airbyte, then use any of over 300 connectors to send it anywhere - from Azure to Kafka, MongoDB to Oracle.</p>
+    </div>
+    <div>
+        <h5>An open-source ELT pipeline</h5>
+        <p>Open-source analytics and open-source ELT are a match made in heaven. Edit Airbyte's pre-built connectors, or build your own in just a few hours.</p>
+    </div>
+</Section>
+
+<TutorialsSlider topic="airbyte" />
+
+<Documentation />
diff --git a/contents/apps/amazon-kinesis/docs.md b/contents/apps/amazon-kinesis/docs.md
@@ -0,0 +1,104 @@
+---
+title: Amazon Kinesis Import app documentation
+showTitle: true
+topics:
+    - amazon-kinesis
+---
+
+### What does the Amazon Kinesis Import app do?
+
+This app imports event data into PostHog from an Amazon Kinesis stream. Kinesis Records must be delivered in a JSON schema in order to be imported. 
+
+### What are the requirements for this app?
+
+Using the Amazon Kinesis Import app requires either PostHog Cloud, or a self-hosted PostHog instance running [version 1.30.0](https://posthog.com/blog/the-posthog-array-1-30-0) or later. 
+
+Not running 1.30.0? Find out [how to update your self-hosted PostHog deployment](https://posthog.com/docs/self-host/configure/upgrading-posthog)! 
+
+### How should I configure the Kinesis Record schema?
+
+Kinesis Records must be delivered in a JSON schema.
+
+You need to configure an `eventKey` that maps to the event name in Posthog. The `eventKey` can refer to a nested key. 
+
+You can optionally configure a comma-separated list of `additionalPropertyMappings`, that will map Kinesis Record keys to Posthog Event properties. The Kinesis Record keys can be nested keys, while the corresponding Posthog mapped keys cannot be nested.
+
+For example, take the following Kinesis Record
+
+```
+// Kinesis Record
+{
+    ...
+    "properties: {
+        "eventName": "my posthog event",
+        "userId": "$userId",
+        "foo": "bar"
+    }
+}
+```
+
+And the following configuration:
+
+```
+eventKey = properties.eventName
+additionalPropertyMappings = properties.userId:distinct_id,properties.foo:foo
+```
+
+Will be parsed as:
+
+```
+// Posthog Event
+{
+    "event": "my posthog event",
+    "properties: {
+        "distinct_id": "$userId",
+        "foo": "bar"
+    }
+}
+```
+
+### What is the correct IAM policy?
+
+You need to provide an AccessKeyID and a SecretAccessKey for a AWS IAM user with at least the following Kinesis Action rights:
+
+```
+DescribeStream
+GetShardIterator
+GetRecords
+```
+
+### What app parameters are available?
+
+- `Kinesis Stream Name` (required): the name of the Kinesis stream you want to read from
+- `IAM Access Key ID` (required): IAM Access Key ID with Kinesis access
+- `IAM Secret Access Key` (required): IAM Secret Access Key with Kinesis access
+- `AWS Region` (required): AWS region where your Kinesis stream is deployed
+- `Event Key (required): The Kinesis Record key to be mapped to the PostHog event name. Can be nested (e.g. `properties.eventName`)
+- `Additional Property Mappings`: A comma-separated mapping of additional Kinesis Record keys to map to Posthog event properties. Can be nested (e.g. `properties.kinesisPropertyKey:posthogPropertyKey`)
+
+### How do I install the Amazon Kinesis Import app for PostHog?
+
+1. Visit the 'Apps' page in your instance of PostHog.
+2. Search for 'Amazon Kinesis' and select the app, press Install.
+3. Follow the steps to configure the app.
+3. Watch events roll in to PostHog. 
+
+### 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 Amazon Kinesis Import app](https://github.com/posthog/posthog-kinesis-plugin) is available on GitHub. 
+
+### Where can I find out more?
+
+Check [Amazon's Kinesis documentation](https://docs.aws.amazon.com/kinesis/index.html) for more information on using Amazon Kinesis. 
+
+### Who created this app?
+
+We'd like to thank community member [Emanuele Capparelli](https://github.com/kappa90) for his work creating this app. Thank you, Emanuele!
+
+### What if I have feedback on this app?
+
+We love feature requests and feedback! Please [create an issue](https://github.com/PostHog/posthog/issues/new?assignees=&labels=enhancement%2C+feature&template=feature_request.md) to tell us what you think. 
+
+### What if my question isn't answered above?
+
+You can [join the PostHog Community Slack group](/slack) to ask more questions, or get advice on developing your own PostHog apps.
diff --git a/contents/apps/amazon-kinesis/index.mdx b/contents/apps/amazon-kinesis/index.mdx
@@ -0,0 +1,30 @@
+---
+title: Amazon Kinesis Importer
+thumbnail: ../thumbnails/kinesis.png
+featuredImage: 
+documentation: /apps/amazon-kinesis/docs
+filters: {
+    type: ["data-in"],
+    maintainer: official
+}
+---
+
+<Section
+    divider={false}
+    title="Stream events from an Amazon Kinesis stream directly into PostHog, at any scale."
+    size="full"
+    cols={2}
+>
+    <div>
+        <h5>Integrate PostHog into your pipeline</h5>
+        <p>Use Kinesis to collect data? PostHog's Amazon Kinesis Importer integrates PostHog into your existing stack, so you don't need to setup a new data pipeline.</p>
+    </div>
+    <div>
+        <h5>Ingest at any scale, from anywhere</h5>
+        <p>Pull data from hundreds of thousands of sources into Amazon Kinesis, then feed it all into PostHog to analyze all your data at any scale.</p>
+    </div>
+</Section>
+
+<TutorialsSlider topic="amazon-kinesis" />
+
+<Documentation />
diff --git a/contents/apps/automatic-cohort-creator/docs.md b/contents/apps/automatic-cohort-creator/docs.md
@@ -0,0 +1,37 @@
+---
+title: Automatic Cohort Creator documentation
+showTitle: true
+topics:
+    - auto-cohort
+---
+
+### What does the Automatic Cohort Creator app do?
+The Automatic Cohort Creator app enables you to specify a list of user properties which will be used to automatically assign new users to a cohort.
+
+### What are the requirements for this app?
+
+The Automatic Cohort Creator app requires either PostHog Cloud, or a self-hosted PostHog instance running [version 1.30.0](https://posthog.com/blog/the-posthog-array-1-30-0) or later. 
+
+Not running 1.30.0? Find out [how to update your self-hosted PostHog deployment](https://posthog.com/docs/self-host/configure/upgrading-posthog)! 
+
+### How do I install the Automatic Cohort Creator app?
+
+1. Visit the 'Apps' page in your instance of PostHog.
+2. Search for 'Automatic Cohort Creator' and select the app, press Install.
+3. Follow the on-screen steps to configure the app.ß
+
+### 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 Automatic Cohort Creator](https://github.com/PostHog/posthog-automatic-cohorts-plugin) is available on GitHub. 
+
+### Who created this app?
+
+This app was created by PostHog team member [Yakko Majuri](https://github.com/yakkomajuri). Thanks, Yakko!
+
+### What if I have feedback on this app?
+
+We love feature requests and feedback! Please [create an issue](https://github.com/PostHog/posthog/issues/new?assignees=&labels=enhancement%2C+feature&template=feature_request.md) to tell us what you think. 
+
+### What if my question isn't answered above?
+
+You can [join the PostHog Community Slack group](/slack) to ask more questions, or get advice on developing your own PostHog apps.
diff --git a/contents/apps/automatic-cohort-creator/index.mdx b/contents/apps/automatic-cohort-creator/index.mdx
@@ -0,0 +1,34 @@
+---
+title: Automatic Cohort Creator
+featuredImage: 
+documentation: /apps/automatic-cohort-creator/docs
+thumbnail: ../thumbnails/automatic-cohort-creator.png
+filters: {
+    type: ["data-in"],
+    maintainer: official
+}
+---
+
+<Section
+    divider={false}
+    title="Find new ways to group users together and analyze their behaviour by automatically assigning similar users to a cohort based on their properties."
+    size="full"
+    cols={3}
+>
+    <div>
+        <h5>Cohort by organization</h5>
+        <p>Need to group users from a particular organization? Create cohorts based on industry, company name or department.</p>
+    </div>
+    <div>
+        <h5>Cohort by demographic</h5>
+        <p>Trying to understand users individually? Automatically assign cohorts based on age, location and more.</p>
+    </div>
+    <div>
+        <h5>Cohort by user persona</h5>
+        <p>Trying to define different user personas? Analyze cohorts based on individual properties, like job title or education.</p>
+    </div>
+</Section>
+
+<TutorialsSlider topic="auto-cohorts" />
+
+<Documentation />
diff --git a/contents/apps/bigquery-export/docs.md b/contents/apps/bigquery-export/docs.md
@@ -0,0 +1,79 @@
+---
+title: BigQuery Export documentation
+showTitle: true
+topics:
+    - bigquery-export
+---
+
+### What does the BigQuery Export app do?
+
+This app streams events from PostHog directly into a BigQuery service account, as they are ingested. This is especially useful if you have an existing data warehouse or data lake running in BigQuery. 
+
+### What are the requirements for this app?
+
+The BigQuery Export app requires either PostHog Cloud, or a self-hosted PostHog instance running [version 1.30.0](https://posthog.com/blog/the-posthog-array-1-30-0) or later. 
+
+Not running 1.30.0? Find out [how to update your self-hosted PostHog deployment](https://posthog.com/docs/self-host/configure/upgrading-posthog)! 
+
+You'll also need access to the BigQuery instance you want to export to. 
+
+### How do I install the BigQuery export app for PostHog?
+
+1. Visit the 'Apps' page in your instance of PostHog.
+2. Search for 'BigQuery' and select the app, press Install.
+3. Follow the configuration steps:
+   1. Upload your Google Cloud key `.json` file. (See below for permissions and how to retrieve this.)
+   2. Enter your Dataset ID
+   3. Enter your Table ID 
+3. Watch events roll into BigQuery
+
+### How do I setup BigQuery permissions for PostHog?
+
+To set the right permissions up for the BigQuery plugin, you'll need:
+1. A service account.
+2. A dataset which has permissions allowing the service account to access it.
+
+Here's how to set these up so that the app has access only to the table it needs:
+
+1. [Create a service account](https://cloud.google.com/bigquery/docs/reference/libraries#setting_up_authentication). Keep hold of the JSON file at the end of these steps for setting up the app, and remember the name too.
+
+2. Create a role which has only the specific permissions the PostHog BigQuery app requires (listed below), or use the built in `BigQuery DataOwner` permission. If you create a custom role, you will need:
+   * bigquery.datasets.get
+   * bigquery.tables.create
+   * bigquery.tables.get
+   * bigquery.tables.list
+   * bigquery.tables.updateData
+
+3. Create a dataset within a BigQuery project (ours is called `posthog`, but any name will do).
+
+4. Follow the instructions [on granting access to a dataset in BigQuery](https://cloud.google.com/bigquery/docs/dataset-access-controls#granting_access_to_a_dataset) to ensure your new service account has been granted either the role you created or the "BigQuery Data Owner" permission. 
+
+![SQL_workspace_–_BigQuery_–_Data_Warehouse_Exp_–_Google_Cloud_Platform](https://user-images.githubusercontent.com/1108173/130323561-444cbbf6-a994-455e-97b6-8db6df69e274.png)
+
+Use the Share Dataset button to share your dataset with your new service account and either the `BigQuery DataOwner` role, or your custom role created above. In the below, we've used a custom role `PostHog Ingest`.
+
+![SQL_workspace_–_BigQuery_–_Data_Warehouse_Exp_–_Google_Cloud_Platform](https://user-images.githubusercontent.com/1108173/130323602-50f13200-6fde-4ee9-b507-1bce75fc75b2.png)
+
+That's it! Once you've done the steps above, your data should start flowing from PostHog to BigQuery.
+
+### Why am I seeing duplicate PostHog events in BigQuery?
+
+There's a very rare case when duplicate events appear in BigQuery. This happens due to network errors, where the export seems to have failed, yet it actually reaches BigQuery.
+
+While this shouldn't happen, if you find duplicate events in BigQuery, follow these [Google Cloud docs](https://cloud.google.com/bigquery/streaming-data-into-bigquery#manually_removing_duplicates) to manually remove the them.
+
+### 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 BigQuery Export app](https://github.com/PostHog/bigquery-plugin) is available on GitHub. 
+
+### Who created this app?
+
+We'd like to thank PostHog team members [Yakko Majuri](https://github.com/yakkomajuri), [Marius Andra](https://github.com/mariusandra), [Neil Kakkar](https://github.com/neilkakkar), [Michael Matloka](https://github.com/Twixes) and community member [Edward Hartwell Goose](https://github.com/edhgoose) for creating this BigQuery Export app. 
+
+### What if I have feedback on this app?
+
+We love feature requests and feedback! Please [create an issue](https://github.com/PostHog/posthog/issues/new?assignees=&labels=enhancement%2C+feature&template=feature_request.md) to tell us what you think. 
+
+### What if my question isn't answered above?
+
+You can [join the PostHog Community Slack group](/slack) to ask more questions, or get advice on developing your own PostHog apps.