Git-based Tracking Plans and Data Catalog Management Alpha

This feature is in alpha as part of RudderStack’s Early Access Program, where we work with early users and customers to test new features and get feedback before making them generally available. Note that these features are functional but can change as we improve them.

Make sure to contact the RudderStack team before using them in production.

RudderStack’s Git-based tracking plans management feature helps you manage tracking plans and data catalog as code by leveraging the new Git-based workflow. It helps you bring data governance into your existing development workflows through code-first management of data catalog and tracking plans.

With this feature, you can bring the same rigor and process to your tracking plans that you apply to your application code, ensuring consistency and quality in your data collection strategy.

Key features

With RudderStack’s Git-based tracking plan management, you get the following features:

Declarative YAML configuration

• Define and manage events, properties, and tracking plans directly in your codebase using simple YAML files.
• Create reusable property definitions with advanced validation rules like minimum/maximum length, patterns, enums, etc. across multiple events.
• Leverage a structured referencing system to associate events and properties to a tracking plan.

Powerful Rudder CLI tool

This feature comes with a powerful Rudder CLI utility that lets you:

• Create, update, and delete tracking plan resources via command line.
• Verify your YAML configurations locally before pushing changes to production.
• Sync the local configuration files with your RudderStack workspace.

Git integration and CI/CD support

• Leverage GitHub Actions to automatically validate and deploy tracking plans from your repository.
• Use the standard Git workflows to track changes, implement version control, manage branches, and make any other modifications.

Who can use this feature?

The Git-based tracking plans management feature is helpful for data teams who need to:

• Manage their tracking plans and data catalog programmatically with consistent tracking standards.
• Integrate their tracking plan changes into their existing development workflows.
• Validate their tracking plan changes before deployment.

Get started

1. Install the Rudder CLI tool in your preferred environment.
2. Authenticate the tool and configure access to your RudderStack workspace by creating a workspace-level Service Access Token.
3. Initialize a new tracking plan project with YAML definitions. Then, sync the changes to your workspace.
4. Automate tracking plan management using GitHub Actions.

Limitations

Currently, the Git-based tracking plans management feature does not support the following capabilities that are available in the RudderStack dashboard:

• Setting an event category.
• Defining nested event properties in tracking plans.
• Setting custom data types for event properties.

Questions? Contact us by email or on Slack