Start here
How Anectico connects the story
Understand what the SDK sends, how customer identity links signals, and where to begin in the product.
Anectico brings the evidence for one customer into one timeline. You still use familiar signals such as errors, traces, logs, metrics, events, and replay; the difference is that a stable customer identity connects them so you can move through the story without searching each tool separately.
The short version
- An SDK or OpenTelemetry exporter sends telemetry to one Anectico project.
- Your application identifies a customer with a stable
distinct_id. - Anectico resolves that ID across errors, traces, logs, events, replay, and AI activity.
- Customers shows the evidence in time order. Issues groups failures by cause and impact.
- Investigate can explain the evidence, with links back to the underlying records.
Metrics remain service-level measurements. Do not add customer IDs as metric labels. When a metric changes, use the same service, environment, and time window to find the traces, logs, Issues, and customers that explain it.
What each signal answers
| Signal | Question it answers | Typical example |
|---|---|---|
| Error / Issue | What failed, and who was affected? | Payment exception grouped across occurrences |
| Trace | What happened during one request or job? | Checkout request across API and payment services |
| Log | What detail did the application record? | Provider response or retry decision |
| Metric | When and where did system behavior change? | Error rate, queue depth, or latency distribution |
| Event | What meaningful action did the customer take? | Checkout started or onboarding completed |
| Replay | What did the customer see and do in the browser? | Clicks and UI state around a failure |
| AI call / agent run | How did an AI workflow behave and what did it cost? | Model call, tool use, tokens, and outcome |
No single signal is expected to explain the whole incident. Start from the customer or Issue, keep the time window fixed, and follow the links between them.
What the SDK does
The server SDKs configure OpenTelemetry export, add service and environment information, batch telemetry, and provide helpers for errors, identity, and diagnostic events. Framework integrations can create request spans and capture unhandled failures. Browser and mobile capabilities differ, so check Choose an integration before assuming feature parity.
Your application still owns four decisions:
- call
identifyonly after authentication, using a durable ID; - call
reseton logout in stateful clients; - propagate trace and identity headers only to trusted application services; and
- flush or stop the SDK during graceful shutdown, especially in short-lived processes.
Anectico instrumentation should not replace your application’s error handling. Capture the error, then preserve the application’s normal return, throw, retry, or crash behavior.
The three scopes to check
When evidence looks missing or disconnected, confirm these before changing instrumentation:
- Project — the key and dashboard must point to the same project.
- Environment and service — use stable names such as
productionandcheckout-api. - Customer identity — the same stable
distinct_idmust reach every trusted service involved.
API-key permissions are separate from those scopes. Ingestion, diagnostic events, replay, reads, and operational actions use different permissions so application keys can remain narrow.
A safe first rollout
Start with one customer-facing journey and prove this path: identify a test customer, create one trace and captured error, verify the customer timeline, then inspect the Issue. Add metrics, replay, more services, and automation only after that path works.