Verify installation

Verify your RudderStack installation by sending test events.

Before using RudderStack, it is highly recommended to verify that your installation works as expected by sending some test events. You can use any of the following approaches:

info
This guide assumes that you have already installed and set up RudderStack in your preferred environment.

Bundled shell script

The rudder-server GitHub repository contains a bundled shell script that generates test events. Clone the repository by running the following command:

git clone https://github.com/rudderlabs/rudder-server.git

Then, follow the steps below to send test events.

Step 1: Get source write key

RudderStack Open Source dashboard

If you have signed up for RudderStack open source, follow these steps:

  1. Log in to your RudderStack Open Source dashboard.
  2. Set up a source and connect it to a destination.
  3. You can find the write key in the Setup tab of your source.
RudderStack source write key

Self-hosted control plane

If you are self-hosting the control plane using Control Plane Lite, follow these steps:

  1. Set up a source and connect it to a destination.
  2. Note the write key for the source:
Control plane lite source write Key

Step 2: Send test events

To send test events, follow the steps in the sections below depending on your preferred setup:

Local setup

  1. Navigate to the folder where RudderStack is installed.
  2. Run the following command:
./scripts/generate-event <WRITE_KEY> <DATA_PLANE_URL>/v1/batch
info
Replace <WRITE_KEY> and <DATA_PLANE_URL> with your source write key and data plane URL.
  1. Go to your source in the RudderStack Open Source dashboard and check the Live Events tab to verify if the events are delivered.
Source live events

An example is shown below:

Test Event

Docker setup

  1. Run the following command:
docker exec -ti \
    <rudder-server-running-container-id> \
    ./scripts/generate-event <WRITE_KEY> <DATA_PLANE_URL>/v1/batch
info
Replace <WRITE_KEY> and <DATA_PLANE_URL> with your source write key and data plane URL.
  1. Go to your source in the RudderStack Open Source dashboard and check the Live Events tab to verify if the events are delivered.
warning
Unlike RudderStack Open Source, the control plane set up using Control Plane Lite does not support the Live Events feature.

If you supply an invalid source write key or data plane URL, you will get the following error:

Test Event error

RudderStack HTTP API

To send test events using the RudderStack HTTP API, follow these steps:

  1. Import this Postman collection.
  2. Edit the variables source_write_key and data_plane_url in this collection with your source write key and data plane URL.

RudderStack uses Basic Authentication for authenticating all HTTP requests. The HTTP Basic Authentication requires a user name and password, where:

  • Username is the source_write_key.
  • Password is an empty string ("").
  1. Send the test API requests.
  2. Go to your source in the RudderStack Open Source dashboard and check the Live Events tab to verify if the events are delivered.

Questions? Contact us by email or on Slack