OpenTelemetry Demo and New Relic

note

Check out the source code on GitHub here.

Tracetest is a testing tool based on OpenTelemetry that allows you to test your distributed application. It allows you to use data from distributed traces generated by OpenTelemetry to validate and assert if your application has the desired behavior defined by your test definitions.

New Relic is an observability platform that helps you build better software. You can bring in data from any digital source so that you can fully understand your system, analyze that data efficiently and respond to incidents before they become problems.

OpenTelemetry Demo `v0.3.4-alpha` with New Relic, OpenTelemetry and Tracetest

This is a simple sample app on how to configure the OpenTelemetry Demo v0.3.4-alpha to use Tracetest for enhancing your E2E and integration tests with trace-based testing and New Relic as a trace data store.

Prerequisites

Tracetest Account:

Sign up to app.tracetest.io or follow the get started docs.
Have access to the environment's agent API key.

Docker: Have Docker and Docker Compose installed on your machine.

Run This Quckstart Example

The example below is provided as part of the Tracetest project. You can download and run the example by following these steps:

Clone the Tracetest project and go to the example folder:

git clone https://github.com/kubeshop/tracetest
cd tracetest/examples/tracetest-new-relic

Follow these instructions to run the quick start:

Copy the .env.template file to .env.
Fill out the TRACETEST_TOKEN and ENVIRONMENT_ID details by editing your .env file.
Fill out the NEW_RELIC_INGEST_LICENSE details by editing your .env file.
Run docker compose run tracetest-run.
Follow the links in the output to view the test results.

Follow the sections below for a detailed breakdown of what the example you just ran did and how it works.

Project Structure

The project is built with Docker Compose. It contains two distinct docker-compose.yaml files.

1. OpenTelemetry Demo

The docker-compose.yaml file and .env file in the root directory are for the OpenTelemetry Demo.

Docker Compose Network

All services in the docker-compose.yaml are on the same network and will be reachable by hostname from within other services. E.g. tracetest-agent:4317 in the collector.config.yaml will map to the tracetest-agent service, where the port 4317 is the port where Tracetest Agent accepts traces.

OpenTelemetry Demo

The OpenDelemetry Demo is a sample microservice-based app with the purpose to demo how to correctly set up OpenTelemetry distributed tracing.

Read more about the OpenTelemetry Demo here.

The docker-compose.yaml contains 12 services.

To start the OpenTelemetry Demo by itself, run this command:

docker compose build # optional if you haven't already built the images
docker compose up

This will start the OpenTelemetry Demo. Open up http://localhost:8084 to make sure it's working. But, you're not sending the traces anywhere.

Let's fix this by configuring Tracetest and OpenTelemetry Collector to forward trace data to both New Relic and Tracetest.

Here's how to configure the OpenTelemetry Collector.

# collector.config.yaml
receivers:
  otlp:
    protocols:
      grpc:
      http:

processors:
  batch:
    timeout: 100ms

exporters:
  # OTLP for Tracetest
  otlp/tracetest:
    endpoint: tracetest-agent:4317 # Send traces to Tracetest. Read more in docs here:  https://docs.tracetest.io/configuration/connecting-to-data-stores/opentelemetry-collector
    tls:
      insecure: true
  # OTLP for New Relic
  otlp/newrelic:
    endpoint: otlp.nr-data.net:443
    headers:
      api-key: ${NEW_RELIC_INGEST_LICENSE} # Send traces to New Relic.
      # Read more in docs here: https://docs.newrelic.com/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/opentelemetry-setup/#collector-export
      # And here: https://docs.newrelic.com/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/collector/opentelemetry-collector-basic/

service:
  pipelines:
    traces/tracetest:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlp/tracetest]
    traces/newrelic:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlp/newrelic]

Important! Take a closer look at the sampling configs in both the collector.config.yaml. It has set sampling to 100%. This is crucial when running trace-based e2e and integration tests.

Running the Tests

The Test File

Check out the resources/test.yaml file.

# resources/test.yaml

type: Test
spec:
  id: YJmFC7hVg
  name: Otel - List Products
  description: Otel - List Products
  trigger:
    type: http
    httpRequest:
      url: http://otel-frontend:8084/api/products
      method: GET
      headers:
        - key: Content-Type
          value: application/json
  specs:
    - selector:
        span[tracetest.span.type="http" name="API HTTP GET" http.target="/api/products"
        http.method="GET"]
      assertions:
        - attr:http.status_code   =   200
        - attr:tracetest.span.duration  <  50ms
    - selector: span[tracetest.span.type="rpc" name="grpc.hipstershop.ProductCatalogService/ListProducts"]
      assertions:
        - attr:rpc.grpc.status_code = 0
    - selector:
        span[tracetest.span.type="rpc" name="hipstershop.ProductCatalogService/ListProducts"
        rpc.system="grpc" rpc.method="ListProducts" rpc.service="hipstershop.ProductCatalogService"]
      assertions:
        - attr:rpc.grpc.status_code = 0

To run the test, run this command in the terminal:

docker compose run tracetest-run

Check out the test.yaml file.

# resurces/test.yaml
type: Test
spec:
  id: YJmFC7hVg
  name: Otel - List Products
  description: Otel - List Products
  trigger:
    type: http
    httpRequest:
      url: http://otel-frontend:8084/api/products
      method: GET
      headers:
        - key: Content-Type
          value: application/json
  specs:
    - selector:
        span[tracetest.span.type="http" name="API HTTP GET" http.target="/api/products"
        http.method="GET"]
      assertions:
        - attr:http.status_code   =   200
        - attr:tracetest.span.duration  <  50ms
    - selector: span[tracetest.span.type="rpc" name="grpc.hipstershop.ProductCatalogService/ListProducts"]
      assertions:
        - attr:rpc.grpc.status_code = 0
    - selector:
        span[tracetest.span.type="rpc" name="hipstershop.ProductCatalogService/ListProducts"
        rpc.system="grpc" rpc.method="ListProducts" rpc.service="hipstershop.ProductCatalogService"]
      assertions:
        - attr:rpc.grpc.status_code = 0

This file defines the a test the same way you would through the Web UI.

To run the test, run this command in the terminal:

docker compose run tracetest-run

This test will fail just like the sample above due to the attr:tracetest.span.duration < 50ms assertion.

✘ Otel - List Products (http://localhost:11633/test/YJmFC7hVg/run/9/test)
	✘ span[tracetest.span.type="http" name="API HTTP GET" http.target="/api/products" http.method="GET"]
		✘ #cb68ccf586956db7
			✔ attr:http.status_code   =   200 (200)
			✘ attr:tracetest.span.duration  <  50ms (72ms) (http://localhost:11633/test/YJmFC7hVg/run/9/test?selectedAssertion=0&selectedSpan=cb68ccf586956db7)
	✔ span[tracetest.span.type="rpc" name="grpc.hipstershop.ProductCatalogService/ListProducts"]
		✔ #634f965d1b34c1fd
			✔ attr:rpc.grpc.status_code = 0 (0)
	✔ span[tracetest.span.type="rpc" name="hipstershop.ProductCatalogService/ListProducts" rpc.system="grpc" rpc.method="ListProducts" rpc.service="hipstershop.ProductCatalogService"]
		✔ #33a58e95448d8b22
			✔ attr:rpc.grpc.status_code = 0 (0)

If you edit the duration as in the Web UI example above, the test will pass!

View Trace Spans Over Time in New Relic

To access a historical overview of all the trace spans the OpenTelemetry Demo generates, jump over to your New Relic account.

You can also drill down into a partucular trace as well.

With New Relic and Tracetest, you get the best of both worlds. You can run trace-based tests and automate running E2E and integration tests against real trace data. And, use New Relic to get a historical overview of all traces your distributed application generates.

Learn More

Feel free to check out our examples in GitHub and join our Slack Community for more info!

OpenTelemetry Demo v0.3.4-alpha with New Relic, OpenTelemetry and Tracetest​

Prerequisites​

Run This Quckstart Example​

Project Structure​

1. OpenTelemetry Demo​

Docker Compose Network​

OpenTelemetry Demo​

Running the Tests​

The Test File​

View Trace Spans Over Time in New Relic​

Learn More​