Skip to main content

Keen [ARCHIVED]

Overview

The Airbyte Keen destination allows you to stream data from any Airbyte Source into Keen for storage, analysis, and visualization. Keen is a flexible, fully managed event streaming and analytics platform that empowers anyone to ship custom, embeddable dashboards in minutes, not months.

Prerequisites

  • For Airbyte Open Source users using the Postgres source connector, upgrade your Airbyte platform to version v0.40.0-alpha or newer and upgrade your Keen connector to version 0.2.4 or newer

Sync overview

Output schema

Each replicated stream from Airbyte will output data into a corresponding event collection in Keen. Event collections store data in JSON format. Each collection will inherit the name from the stream with all non-alphanumeric characters removed, except for .’, ‘-’, ‘_’, and whitespace characters. When possible, the connector will try to infer the timestamp value for the record and override the special field keen.timestamp with it.

Features

FeatureSupported?(Yes/No)Notes
Full Refresh SyncYes
Incremental - Append SyncYes
Incremental - Append + DedupedNo
NamespacesNo

Getting started

Requirements

To use the Keen destination, you'll first need to create a Keen account (if you don’t already have one).

Once you have a Keen account, you can use the following credentials to set up the connector

  • A Keen Project ID
  • A Keen Master API key associated with the project

See the setup guide for more information about how to get started.

Setup guide

Keen Project

If you haven’t set up a project to stream your data to:

Login to the Keen application and add a new project. To do this, click the ‘Add New’ link next to the Projects label on the left-hand, side ribbon. Then, give the project a name.

You can think of a project as a data silo. The data in a project is completely separate from data in other projects. We recommend that you create separate projects for each of your applications and separate projects for Dev and Prod environments.

Now, head to the ‘Access’ section and grab your Project ID and Master API Key.

If you already have a project set up:

Head to the ‘Access’ tab and grab your Project ID and Master API Key

API Key and Project ID

The Keen Connector uses the Keen Kafka Inbound Cluster to stream data. It requires your Project ID and Master Key for authentication. To get them, navigate to the Access tab from the left-hand, side panel and check the Project Details section. Important: This destination requires the Project's Master Key.

Timestamp Inference

The Infer Timestamp field lets you specify if you want the connector to infer the keen.timestamp field based on the data from the event that occurred in the source application. This feature allows for historical data synchronization enabling you to fully leverage the power of Keen's time series analytics. By default, this property is set to true. If toggled off, keen.timestamp will be set to the datetime when the data was recorded by Keen.

Setup the Keen destination in Airbyte

Now, you should have all the parameters needed to configure Keen destination.

  • Project ID
  • Master API Key
  • Infer Timestamp

Connect your first source and then head to the Keen application. You can seamlessly run custom analysis on your data and build interactive dashboards for key stakeholders.

If you have any questions, please reach out to us at team@keen.io and we’ll be happy to help!

CHANGELOG

VersionDatePull RequestSubject
0.2.42022-08-0415291Update Keen destination to use outputRecordCollector to properly store state
0.2.32022-06-1713864Updated stacktrace format for any trace message errors
0.2.12021-12-308809Update connector fields title/description
0.2.02021-09-105973Fix timestamp inference for complex schemas
0.1.02021-08-185339Keen Destination Release!