Skip to content

docs: point the first-traces quickstart at auto-instrumentation and APM #427

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Circadian-agent wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: point the first-traces quickstart at auto-instrumentation and APM #427

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions docs/starlight-docs/src/content/docs/get-started/quickstart/first-traces.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,13 @@ description: Instrument your application to send traces to the Observability Sta
pip install opentelemetry-api opentelemetry-sdk opentelemetry-exporter-otlp
```

:::tip[Most applications do not need this code]

@kylehounslow kylehounslow Aug 19, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
:::tip[Most applications do not need this code]
:::tip[OpenTelemetry auto-instrumentation]

The example below instruments a span by hand so you can see what a trace is made
of. For a real service, [auto-instrumentation](/docs/send-data/opentelemetry/auto-instrumentation/)
is usually the faster path: it emits HTTP, database and framework spans with no
code changes, and is available for Python, Java, Node.js, Go, .NET and Ruby.
:::

## 2. Send traces

```python
Expand Down Expand Up @@ -46,4 +53,5 @@ For other languages, see [Send Data](/docs/send-data/).

- [Create Your First Dashboard](/docs/get-started/quickstart/first-dashboard/) - build custom visualizations
- [Agent Tracing](/docs/ai-observability/agent-tracing/) - trace AI agent workflows with GenAI semantic conventions
- [Application Monitoring](/docs/apm/) - service maps and RED metrics built from the traces you just sent
- [Send Data](/docs/send-data/) - more instrumentation options
Loading