Not ready to instrument and deploy components?
We’ve got you covered with an app that can send demo traces to your Distributed Tracing.
Using the HotROD app is so easy, and so fast, that you’ll be searching for traces in Logz.io within a few minutes of setting up the app!
About the HotROD demo application
HotROD (Rides on Demand) is a demo application that consists of several microservices that send requests to each other. The application is used to illustrate the use of the OpenTracing API. It can be run standalone, but requires a Jaeger backend to view the traces.
The HotROD (Rides on Demand) application generates a web page with four customer buttons to order a car to the customer’s business to pick up passengers or merchandise for delivery to a desired location.
Clicking a button sends a request to the backend, which generates a trace. The app responds with the car license number and estimated time of arrival (ETA).
In this example, the web client ID is 1465. All the ride requests generated in the session include this ID in a unique request ID. For each button click, you’ll see the following information:
- Car license number
- Driver ETA
- Unique request ID, built from the session ID and a sequence number.
And once you open the Distributed Tracing tab, select a service, and Find Traces:
For more background information, visit the HotROD in Github project .
Getting started with HotROD demo traces
This topic explains how to set up the Logz.io sample application to send demo traces to your Logz.io Distributed Tracing account. You’ll use a simple yaml configuration file to deploy the following components in a Docker environment:
- A modified HotROD sample application, based on the original project developed to demonstrate distributed tracing.
- The Jaeger agent
- The Logz.io Jaeger collector
The Logz.io tracing-demo project repository includes modified configuration paramaters to create the HotROD web app. The app sends data to a Logz.io Jaeger collector that you configure to work with your Distributed Tracing account. Click to open the README for the tracing demo project
To run the demo configuration and deploy the components, you must have the following software installed:
Update the .env file from the Logz.io tracing-demo repository
We’ve streamlined the process: Use the .env file to add your Logz.io credentials to the demo config.
Updating the .env file in the Logz.io tracing demo repo with your tracing account token and region code
jaeger-logzio-collector definition parameters to the yaml file, in the
To update your parameters, in the .env file:
- Use a terminal to grab the repo code using the git command:
git clone https://github.com/logzio/tracing-demo.gitand change directories:
- Open the .env file and update the parameters with your preferred text editor.
Enter your Distributed Tracing account token in the first line:
ACCOUNT_TOKEN=Enter your account token here. You must have admin permissions for the Logz.io account to view the Manage tokens page. If you’re not an admin user for the account, consult with an account admin to get the Distributed Tracing token information.
When you’re logged into your main account, from the Settings menu, go to the Manage tokens page, open the Data shipping tokens tab, and select the Tracing option.
Find the Distributed Tracing account you want to ship to in the table, and copy the token. For information about how to manage your tracing data sources, see Manage a Distributed Tracing account.
For more details on locating the token, see Distributed Tracing shipping token.
Enter the correct 2-letter code for your region in the second line:
REGION_CODE=Enter your region code here
Look up the 2-letter code for your region in the Regions and Listener Hosts table.
You can find your the region code for your account in the General settings page, here: >Settings > General.
- Save and close the updated .env file.
Deploy the demo app
To run the demo:
- To start the HotROD demo app, in the terminal, run:
- To open the application, navigate to the main HotROD service at http://127.0.0.1:18080.
- To send traces, click the buttons. You can view the logs in the foreground in the terminal.
- To stop the demo, run:
- To remove the docker container, run:
||Starts the demo app|
||Interrupts the demo process|
||Removes the demo container|
Viewing demo traces
After you send traces with the tracing demo app, navigate to the Distributed Tracing tab in Logz.io , select a service and click Find Traces to view your generated trace data.
Visit the docs to learn more about Logz.io Distributed Tracing.