RudderStack Sources

Add and manage sources in the RudderStack dashboard.

A source is a platform or an application (web, mobile, server-side, or a third-party cloud app) from where RudderStack tracks and collects the data.

RudderStack supports the following source types:

Add a source

  1. Log in to your RudderStack dashboard.
  2. From the left sidebar, go to Collect > Sources.
  3. Click New source.
  4. Select the source from the list.
  5. Assign a name to the source and click Continue to complete the setup.
warning
Setting up Reverse ETL sources require some additional configuration. See the source-specific documentation for detailed steps.

Overview

Once you set up a source, you will see the following information on the source page:

Source information

Just below your source name, you will see the following options:

Option
Description
Resource IDUnique identifier for the RudderStack source — click to copy the ID to the clipboard.
Write keyThe source write key used to send events to the source.
Setup guideLink to the source-specific documentation
Live eventsLets you view the source live events
AlertsThe bell icon on the top right corner indicating the number of active alerts for the source.

tip
Tip: Click the icon to get an alert summary and take appropriate remedial actions immediately. See Alerts for more information on this feature.

Click the meatballs menu () to access the following options:

Setting
Description
RenameLets you rename the source
Enable / DisableLets you enable or disable the source
DeleteLets you delete the source

warning
You cannot delete a source that is connected to any destination.
info

Note that:

  • RudderStack does not accept any events if the source is disabled.
  • You will get a 404 error with the message Source is disabled if you send events to a disabled source.
  • RudderStack does not count events sent to a disabled source in the total event volume and does not charge for them.

Tab details

The following sections explain the various tabs available on the source page.

Setup

The Setup tab includes the installation snippet and write key to set up your source.

Overview

The Overview tab gives you a quick overview of the source, including:

  • List of the connected destinations
  • Option to connect to a new or existing destination via the Add destination button
Source overview tab

Events

The Events tab displays the event delivery metrics like total number of events, bot events, blocked events and number of ingested events.

If you have a Tracking Plan connected to the source, you can also see the event validation metrics like number of successfully validated events and events that violate Tracking Plan rules.

See Event Metrics for more information on this tab.

Settings

The Settings tab displays the following source-specific settings:

Setting
Description
Temporarily store data in staging areaIf enabled, lets RudderStack resend your events in case of failure.
Enable geolocation enrichmentIf enabled, lets you enrich your events with geolocation data. See Geolocation Enrichment at Source for more information.
Bot event managementLets you override the bot management settings set at the workspace level for this particular source. See Bot Management for more information.

Alerts

The Alerts tab lets you set specific alert overrides applicable to this source.

See Configurable Alerts for more information.

Audit Logs

info
Audit Logs are available only in the RudderStack Enterprise plan.

The Audit Logs tab lets you view the Audit Logs for the source.

Tracking Plans

The Tracking Plans tab lets you link or unlink a Tracking Plan with the source.

Permissions

warning
This setting is visible only to Org Admins in the legacy Permissions Management (RBAC) system in the RudderStack Enterprise plan.

You can use the Permissions tab to determine which members in your workspace can make changes to the source. This is useful when you want to set granular controls for the resources within your workspace.

See Permissions Management for more details.


Questions? We're here to help.

Join the RudderStack Slack community or email us for support