Everything you need to instrument applications with OpenTelemetry and send telemetry to Sematext Cloud Apps (Tracing App, Monitoring App, Logs App): per-language reference examples, an end-to-end multi-service demo, and an AI-powered onboarding skill.
This repository covers both sides of the OpenTelemetry onboarding story — runnable code you can copy from, and an AI skill that walks you through the setup conversationally. Two flows are demonstrated:
- Sematext Agent — the service ships OTLP locally to a running Sematext Agent which forwards to Sematext Cloud. Covered by the per-language examples below. See Sematext Agent OpenTelemetry docs.
- Managed OTLP endpoint — the service ships OTLP directly to Sematext's hosted receiver. Used by the end-to-end multi-service example, where it's the natural fit for browser-side telemetry.
- Pick a language from the table below (click the link)
- Read the language README - it contains all auto/manual instrumentation options and deployment environments
- Follow the instructions in your chosen example
Or, for distributed-tracing across multiple services, jump to the end-to-end example.
| Language | Framework | Flow |
|---|---|---|
| Node.js | Express | Sematext Agent |
| Java | Spring Boot | Sematext Agent |
| Python | Flask | Sematext Agent |
| .NET | ASP.NET Core | Sematext Agent |
| PHP | Laravel | Sematext Agent |
| Go | Gin | Sematext Agent, Managed OTLP endpoint |
| Ruby | Rails, Sinatra | Sematext Agent |
Note: Node.js, Java, Python, .NET, PHP, and Go examples are currently implemented. Go currently covers Docker only; other languages and environments will follow the same structure (baremetal/docker/kubernetes with auto and manual instrumentation).
Multi-service examples showing W3C trace context propagation across the full request path (frontend → backend → "database") with a single distributed trace per user action.
| Stack | Path | Flow |
|---|---|---|
| React + Express | e2e/react-express/ |
Managed OTLP endpoint |
For an AI-driven walkthrough of the instrumentation choices (region, App type, flow, language, env, auto vs manual), invoke the sematext-otel skill in Claude Code or any agent that can read markdown.
- Traces - Distributed tracing shows request flow across services
- Metrics - Application and infrastructure metrics (latency, throughput, errors)
- Logs - Application logs correlated with traces
These examples send telemetry to Sematext Cloud Apps:
- Sematext Tracing App - Distributed tracing and application performance monitoring
- Sematext Monitoring App - Metrics and infrastructure monitoring
- Sematext Logs App - Log management and analysis
Sign up for free to get started.
- Sematext Documentation
- Sematext Agent OpenTelemetry
- Sematext Tracing
- OpenTelemetry Documentation
- OpenTelemetry Zero-code Instrumentation
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.