Sources

Add a source in RudderStack Cloud.

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:

success
You can configure a source for every unique source of data. You can also create multiple sources for each website or application from where you want to track the data.

Add a source

  1. Log in to your RudderStack dashboard.
  2. Click Add Source and select the source.
  3. Assign a name to the source.
  4. Click Continue to finish the setup.
warning
Setting up Reverse ETL sources require some additional configuration. See the source-specific documentation for detailed steps.

Source details

Once your source is set up, you will see the following options:

  • Rename: Lets you rename the source by clicking the edit icon next to the source name.
Rename source
  • Live Events: Lets you view the source live events.
  • Setup: Includes the installation snippet and write key to set up your source.
Setup tab
info

A write key is required to send data from your source. For example, you can load the RudderStack JavaScript SDK on your website to track and collect the events by running the following snippet:

  rudderanalytics.load(WRITE_KEY, DATA_PLANE_URL, options);
  • Overview: Gives you a quick overview of the source, including metrics like the number of events ingested in the last 24 hours. You can also see the connected destinations and add a new destination.

  • Events: Displays the event delivery metrics like number of ingested events and filter them by time period (past 1 day, 7 days, or 30 days).

    • 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.
  • Settings: Displays general source-specific settings like:

    • Enabled: Lets you enable or disable syncing data from the source.
    • Temporarily store data in staging area: If enabled, this setting allows RudderStack to resend your events in case of failure.
    • Source ID: Unique identifier for your source.
    • Permanently delete source: Lets you delete a source by clicking on the Delete button. Before deleting a source, make sure there are no destinations connected to it.
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.
  • Audit Log: Lets you view the audit logs for the source.
  • Tracking Plans: Lets you link or unlink a tracking plan with the source.
  • Permissions: Lets you 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? Contact us by email or on Slack