{
  "markdown": "# Sematext OTel Onboarding\n\nEverything 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.\n\n## Overview\n\nThis 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:\n\n- **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](https://sematext.com/docs/agents/sematext-agent/opentelemetry/).\n- **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.\n\n## Quick Start\n\n1. **Pick a language** from the table below (click the link)\n2. **Read the language README** - it contains all auto/manual instrumentation options and deployment environments\n3. **Follow the instructions** in your chosen example\n\nOr, for distributed-tracing across multiple services, jump to the [end-to-end example](e2e/).\n\n## Examples by Language\n\n| Language | Framework | Flow |\n|----------|-----------|------|\n| **[Node.js](nodejs/)** | Express | Sematext Agent |\n| **[Java](java/)** | Spring Boot | Sematext Agent |\n| **[Python](python/)** | Flask | Sematext Agent |\n| **[.NET](dotnet/)** | ASP.NET Core | Sematext Agent |\n| **[PHP](php/)** | Laravel | Sematext Agent |\n| **[Go](go/)** | Gin | Sematext Agent, Managed OTLP endpoint |\n| **[Ruby](https://sematext.com/docs/tracing/sdks/ruby/)** | Rails, Sinatra | Sematext Agent |\n\n**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).\n\n## End-to-End Examples\n\nMulti-service examples showing W3C trace context propagation across the full request path (frontend → backend → \"database\") with a single distributed trace per user action.\n\n| Stack | Path | Flow |\n|---|---|---|\n| React + Express | [`e2e/react-express/`](e2e/react-express/) | Managed OTLP endpoint |\n\n## AI-powered onboarding\n\nFor an AI-driven walkthrough of the instrumentation choices (region, App type, flow, language, env, auto vs manual), invoke the [`sematext-otel` skill](skills/SKILL.md) in Claude Code or any agent that can read markdown.\n\n## Telemetry Data\n\n- **Traces** - Distributed tracing shows request flow across services\n- **Metrics** - Application and infrastructure metrics (latency, throughput, errors)\n- **Logs** - Application logs correlated with traces\n\n## Sematext Cloud\n\nThese examples send telemetry to Sematext Cloud Apps:\n\n- **Sematext Tracing App** - Distributed tracing and application performance monitoring\n- **Sematext Monitoring App** - Metrics and infrastructure monitoring\n- **Sematext Logs App** - Log management and analysis\n\n[Sign up for free](https://sematext.com/cloud/) to get started.\n\n## Resources\n\n- [Sematext Documentation](https://sematext.com/docs/)\n- [Sematext Agent OpenTelemetry](https://sematext.com/docs/agents/sematext-agent/opentelemetry/)\n- [Sematext Tracing](https://sematext.com/docs/tracing/)\n- [OpenTelemetry Documentation](https://opentelemetry.io/docs/)\n- [OpenTelemetry Zero-code Instrumentation](https://opentelemetry.io/docs/zero-code/)\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n",
  "bytes": 3790,
  "sha": "37520f9bfba1dec8c7f7762f469b91e4e3f4e70cb56fc347a84491d2466b15d0",
  "repo_slug": "sematext/sematext-otel-onboarding",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_sematext_sematext_otel_onboarding_skills_5a219669/readme"
}