Export from LaunchDarkly to GCS

CloudQuery is an open-source data integration platform that allows you to export data from any source to any destination.

The CloudQuery LaunchDarkly plugin allows you to sync data from LaunchDarkly to any destination, including GCS. It's free, open source, requires no account, and takes only minutes to get started.

Ready? Let's dive right in!

Step 1. Install the CloudQuery CLI

The CloudQuery CLI is a command-line tool that runs the sync. It supports MacOS, Linux and Windows.

brew install cloudquery/tap/cloudquery

Step 2. Configure the LaunchDarkly source plugin

Create a configuration file for the LaunchDarkly plugin and set up authentication.

Configuration

Create a file called launchdarkly.yaml and add the following contents:

kind: source
# Common source-plugin configuration
spec:
  name: launchdarkly
  path: cloudquery/launchdarkly
  version: "v1.2.1"
  tables: ["*"]
  destinations: ["gcs"]
  backend: local
  # LaunchDarkly specific configuration
  spec:
    access_token: "<YOUR_ACCESS_TOKEN_HERE>"

The LaunchDarkly plugin supports incremental syncing for audit log data. This means that only new audit log entries will be fetched from LaunchDarkly and loaded into your destination. This is done by keeping track of the entry fetched and only fetching entries that has been created since then. To enable this, backend option must be set in the spec (as shown in the example). This is documented in the Managing Incremental Tables section.

Fine-tune this configuration to match your needs. For more information, see the LaunchDarkly Plugin ↗ page in the docs.

Authentication

In order to fetch information from LaunchDarkly, cloudquery needs to be authenticated using an Access Token from your LaunchDarkly account. You can view and manage your access tokens in LaunchDarkly Account settings > Authorization. Refer to REST API Authentication (opens in a new tab) for more information.

Access Token API Version

Creating the access token you should select at least 20220603 as the API version. This is the minimum API version supported by the LaunchDarkly plugin. Refer to API version changelog (opens in a new tab) for more information.

Step 3. Configure the GCS destination plugin

Create a configuration file for the GCS plugin and set up authentication.

Configuration

Create a file called gcs.yaml and add the following contents:

This example configures a GCS destination, to create CSV files in gcs://bucket_name/path/to/files.

kind: destination
spec:
  name: "gcs"
  path: "cloudquery/gcs"
  version: "v3.2.0"
  write_mode: "append" # gcs only supports 'append' mode
  # batch_size: 10000 # optional
  # batch_size_bytes: 5242880 # optional
  spec:
    bucket: "bucket_name"
    path: "path/to/files"
    format: "csv"
    format_spec:
      delimiter: ","

Note that the GCS plugin only supports append write-mode. The (top level) spec section is described in the Destination Spec Reference.

Fine-tune this configuration to match your needs. For more information, see the GCS Plugin ↗ page in the docs.

Authentication

The GCS plugin authenticates using your Application Default Credentials (opens in a new tab). Available options are all the same options described here (opens in a new tab) in detail:

Local Environment:

gcloud auth application-default login (recommended when running locally)

Google Cloud cloud-based development environment:

When you run on Cloud Shell or Cloud Code credentials are already available.

Google Cloud containerized environment:

When running on GKE use workload identity (opens in a new tab).

Google Cloud services that support attaching a service account (opens in a new tab):

Services such as Compute Engine, App Engine and functions supporting attaching a user-managed service account which will CloudQuery will be able to utilize.

On-premises or another cloud provider

The suggested way is to use Workload identity federation (opens in a new tab)
If not available you can always use service account keys and export the location of the key via GOOGLE_APPLICATION_CREDENTIALS. (Not recommended as long-lived keys are a security risk)

Step 4. Start the Sync

Run the following command in your terminal to start the sync

cloudquery sync launchdarkly.yaml gcs.yaml

And away we go! 🚀 The sync will run until completion, fetching all selected tables from LaunchDarkly. Any errors will be logged to a file called cloudquery.log.

Export from LaunchDarkly to GCS

Step 1. Install the CloudQuery CLI

Step 2. Configure the LaunchDarkly source plugin

Configuration

Authentication

Access Token API Version

Step 3. Configure the GCS destination plugin

Configuration

Authentication

Step 4. Start the Sync

Further Reading

Access Token API Version