telemetrygen

README

Telemetry generator for OpenTelemetry

Status
Stability	traces alpha
	metrics development
Supported signal types	traces, metrics

This utility simulates a client generating traces and metrics, useful for testing and demonstration purposes.

Installing

To install the latest version run the following command:

$ go install github.com/open-telemetry/opentelemetry-collector-contrib/cmd/telemetrygen@latest

Check the go install reference to install specific versions.

Running

First, you'll need an OpenTelemetry Collector to receive the telemetry data. Follow the project's instructions for a detailed setting up guide. The following configuration file should be sufficient:

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: localhost:4317

processors:

exporters:
  logging:

service:
  pipelines:
    traces:
      receivers:
      - otlp
      processors: []
      exporters:
      - logging

Once the OpenTelemetry Collector instance is up and running, run telemetrygen for your desired telemetry:

Traces

$ telemetrygen traces --otlp-insecure --duration 5s

Or, to generate a specific number of traces:

$ telemetrygen traces --otlp-insecure --traces 1

Check telemetrygen traces --help for all the options.