Skip to main content

​
Overview

Now that you understand the different methods available for live-streaming data into Sift, let’s explore how to observe live-streamed data in Sift. For this tutorial, we’ll simulate live-streaming by running a Python script that sends robotic vehicle telemetry (such as velocity and internal temperature) to Sift via the sift_client. This data is generated every 0.5 seconds and is used to demonstrate how streaming data can be observed in Sift.

​
Live-streamed data

Follow the steps below to live-stream robotic vehicle telemetry data.
  1. Clone the Sift repository and navigate to the ingestion tutorial directory: 
    git clone https://github.com/sift-stack/sift.git
cd sift/python/examples/ingestion-tutorial
  2. Create and activate a Python virtual environment, then install the required packages: 
    python3.11 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
  3. Create a .env file and provide your Sift instance URLs and API key: 
    touch .env

    SIFT_API_KEY=your_api_key_here
SIFT_GRPC_URL=https://your-grpc-url
SIFT_REST_URL=https://your-rest-url
    To obtain your instance URLs and an API key:
    1. In Sift, click your profile icon, which shows the first initial of your account name.
    2. Select Manage.
    3. In the Manage navigation menu, click API Keys.
    4. Click + Create API Key.
    5. In the Name box, enter a name for the API key.
    6. In the User list, select your email to link to the API key.
    7. Click Create.
    8. Click Copy.
    9. Click Close.
    10. In the REST API URL field, click Copy.
    11. In the gRPC API URL field, click Copy.
  4. Run the following command to live-stream data to Sift: 
    python stream.py
    • Check the terminal for the generated Run name
      • For example, robot_vehicle_…_run
      • You will use this Run name to access the live-streamed data shortly

​
Observe live-streamed data

Now that data is being streamed to Sift, let’s see how we can observe that data live.
  1. Open the Run that the data is being streamed to. In particular, open the Run using Explore.
  2. In Explore, click Live.
  3. In the Channels tab, select the following Channels:
    1. temperature
    2. velocity
  4. Before concluding this step, stop the streaming with the following command: 
    Ctrl+C