## The steps to instrument the subgraphs are as follows:

1. Instrument your application with [OpenTelemetry](https://opentelemetry.io/docs/instrumentation/).
2. Ensure you define a unique `serviceName.`
3. If you’re running on Cosmo Cloud, the OTEL endpoint is [`https://cosmo-otel.wundergraph.com`](https://cosmo-otel.wundergraph.com/)
4. Set the endpoint URL path to `/v1/traces` (Usually the default)
5. To authenticate against the collector, make your OpenTelemetry agent authenticate using your [federated graph token](https://cosmo-docs.wundergraph.com/cli/router/token/create) as a bearer token, by adding the following HTTP header: `Authorization: Bearer <your token>`

## Examples

### Go

```go
client := otlptracehttp.NewClient(
    otlptracehttp.WithEndpoint("https://cosmo-otel.wundergraph.com"),
    otlptracehttp.WithHeaders(map[string]string{
        "Authorization": "Bearer <secret>",
    }),
)

tp := sdktrace.NewTracerProvider(
    sdktrace.WithResource(resource.NewSchemaless(semconv.ServiceNameKey.String(otelOpts.ServiceName))),
    sdktrace.WithSampler(
	    sdktrace.ParentBased(
		    sdktrace.TraceIDRatioBased(c.Sampler),
		    // When the parent span is sampled, the child span will be sampled.
		),
    ),
)
```

### TypeScript

```typescript
import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";

// Set OTEL_HTTP_ENDPOINT to https://cosmo-otel.wundergraph.com
// Set OTEL_AUTH_TOKEN to your graph authentication token
const otelAuthToken = process.env.OTEL_AUTH_TOKEN;
const otlpExporterHeaders = otelAuthToken
  ? { Authorization: `Bearer ${otelAuthToken}` }
  : undefined;

const otlpExporter = new OTLPTraceExporter({
  url: process.env.OTEL_HTTP_ENDPOINT,
  headers: otlpExporterHeaders,
});
```

## Sampling Rate

Ensure that your subgraphs use parent-based sampling to inherit the sampling rate.

## Example

Additionally, check our [TypeScript example with OTEL](https://github.com/wundergraph/graphql-federation-typescript-demo).

Custom OTEL Metrics are currently not exposed but stored. Please contact us if you have advanced use cases.