AI for OpenTelemetry
Instrument, collect, and troubleshoot OpenTelemetry traces, metrics, and logs with AI — SDKs and auto-instrumentation, the Collector, OTLP exporters, and sampling.
21 copy-paste prompts · 50 in-depth guides Jump to prompts Jump to guides
Prompts
- Advanced
OpenTelemetry Collector Gateway Scaling & HA Prompt
Design a horizontally scalable, highly available OpenTelemetry Collector gateway tier — autoscaling, load balancing, queue persistence, and zero-loss rolling upgrades — so telemetry survives replica churn and traffic spikes.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Collector Routing & Multi-Backend Fan-out Prompt
Design a routing-connector-based OpenTelemetry Collector topology that fans telemetry out to multiple backends or tenants by attribute — with per-route processors, failover, and cost tiers — without duplicating data or dropping unmatched signals.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry OTTL Transform & PII Redaction Prompt
Design OTTL-based transform, redaction, and filter processors in the OpenTelemetry Collector to scrub PII, drop noisy telemetry, and reshape attributes fleet-wide — safely, without breaking correlation or silently deleting signal.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Auto-Instrumentation Rollout Prompt
Plan a safe, incremental rollout of OpenTelemetry auto-instrumentation across polyglot services, including the Operator injection model, version pinning, and where manual spans must supplement the agents.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Baggage and Span Links Design Prompt
Design correct use of OpenTelemetry Baggage and span links: propagate business context (tenant, request class) across services, and link asynchronous or batched work back to originating traces without abusing baggage as a data bus.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Collector Batching & Memory Limiter Tuning Prompt
Tune the OpenTelemetry Collector's batch and memory_limiter processors plus exporter queues to maximize throughput and avoid OOMs, backpressure stalls, and dropped telemetry under bursty load.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Collector Kubernetes Deployment Prompt
Design a Kubernetes deployment topology for the OpenTelemetry Collector using the Operator: choose agent DaemonSet plus gateway Deployment, size resources, wire the target allocator for Prometheus scraping, and set up rollout without dropping telemetry.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Collector Pipeline Design Prompt
Design a production OpenTelemetry Collector configuration with well-ordered receiver, processor, and exporter pipelines for traces, metrics, and logs, tuned for reliability and backpressure.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Collector Security Hardening Prompt
Harden an OpenTelemetry Collector deployment: enable mTLS on OTLP receivers and exporters, add authentication, redact PII with the transform/redaction processors, and lock down the container so telemetry can't be spoofed, sniffed, or leaked.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Context Propagation Strategy Prompt
Fix broken distributed traces by designing correct context propagation across HTTP, gRPC, messaging queues, and async boundaries, standardizing on W3C tracecontext/baggage and handling gateways that strip headers.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Log Correlation and Trace Linking Prompt
Wire application logs into the OpenTelemetry logs signal and correlate them with traces by injecting trace_id and span_id, so a single click moves between a slow trace and its exact log lines across services.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Manual Instrumentation & Span Design Prompt
Design high-quality manual spans and attributes with the OpenTelemetry API where auto-instrumentation falls short, covering span granularity, status/error recording, span links, and cardinality control.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Metrics Cardinality Control Prompt
Diagnose and cut runaway metric cardinality in an OpenTelemetry pipeline: find the offending attributes, apply SDK views and Collector transform/filter processors to bound them, and enforce a per-metric series budget before the backend bill explodes.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Metrics Instrumentation Design Prompt
Design a metrics instrumentation plan with the OpenTelemetry SDK: pick the right instrument types, choose temporality and aggregation, define views to rename and bucket, and control cardinality before metrics reach the backend.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry OTLP Export & Protocol Choice Prompt
Choose and configure the OTLP export path (gRPC vs HTTP/protobuf vs HTTP/JSON), tune compression, TLS, retry, and queueing, and decide direct-to-backend vs through-Collector export.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Pipeline Self-Observability and Debugging Prompt
Make an OpenTelemetry Collector observable to itself: enable internal telemetry, expose queue and drop metrics, add the debug exporter and zpages, and build a diagnostic runbook to find where spans or metrics vanish between app and backend.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Prometheus Receiver Migration Prompt
Migrate existing Prometheus scraping into the OpenTelemetry Collector prometheus receiver: preserve relabeling and service discovery, map Prometheus semantics to OTLP metrics, and shard scraping across replicas without gaps or double-counting.
- Claude
- ChatGPT
- Cursor
Open prompt - Intermediate
OpenTelemetry SDK Configuration Standardization Prompt
Standardize OpenTelemetry SDK configuration across a polyglot fleet using OTEL_ environment variables and declarative config: consistent endpoints, resource attributes, samplers, and propagators so every service reports the same way with no per-language drift.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Semantic Conventions & Resource Attributes Prompt
Standardize span/metric/log attributes and resource attributes across a fleet using OpenTelemetry semantic conventions, so telemetry from many services correlates cleanly and survives convention version changes.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Tail Sampling Strategy Prompt
Design a tail-based sampling strategy in the OpenTelemetry Collector that keeps errors and slow traces while cutting cost, including decision-wait tuning and trace-ID-aware load balancing across Collector replicas.
- Claude
- ChatGPT
- Cursor
Open prompt - Advanced
OpenTelemetry Vendor Agent Migration Prompt
Plan a low-risk migration from a proprietary APM/vendor agent to OpenTelemetry, running both in parallel, mapping vendor concepts to OTel signals, and cutting over dashboards, SLOs, and alerts without observability gaps.
- Claude
- ChatGPT
- Cursor
Open prompt
Guides
- · 9 min read
OpenTelemetry Error Guide: '413 Request Entity Too Large' on OTLP/HTTP — Fix Oversized Payloads
Fix OTLP/HTTP '413 Request Entity Too Large': shrink batches with send_batch_max_size, enable gzip compression, and raise the proxy body-size limit.
Read guide - · 9 min read
OpenTelemetry Error Guide: '429 Too Many Requests' on OTLP export — Fix Backend Rate Limiting
Fix OTLP '429 Too Many Requests': honor Retry-After, add retry backoff, and cut volume with sampling and batch tuning to stop backend rate limiting.
Read guide - · 9 min read
OpenTelemetry Error Guide: '503 Service Unavailable' on OTLP export — Fix Backend Outages
Fix OTLP '503 Service Unavailable': add retry_on_failure with backoff, a persistent file-storage queue, and health checks to ride out backend outages.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'write: broken pipe' on OTLP export — Fix Dropped Connections
Fix 'write tcp 10.0.0.5:52344->10.0.0.9:4317: write: broken pipe' when an OTLP export dies mid-write: keepalive, retries, and LB idle timeouts.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'bind: cannot assign requested address' — Fix Collector Listen Address
Fix 'listen tcp 10.0.0.9:4317: bind: cannot assign requested address' when the OTel Collector receiver binds an IP not on the host: use 0.0.0.0.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'cannot merge config' — Fix Collector Config Merge Failures
Fix 'cannot merge config: '[processors]' expected a map, got 'string'' when the Collector merges multiple --config sources with conflicting types.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'x509: certificate has expired or is not yet valid' — Fix OTLP TLS Certs
Fix 'x509: certificate has expired or is not yet valid: current time ... is after ...' on OTLP: rotate certs or fix clock skew with NTP.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'x509: certificate is valid for ... not ...' — Fix OTLP TLS Hostname Mismatch
Fix 'x509: certificate is valid for collector.internal, not otel.example.com': SAN mismatch. Use the right DNS name or server_name_override.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'dial tcp: i/o timeout' on OTLP export — Fix Blocked Connections
Fix 'dial tcp 10.0.0.9:4317: i/o timeout' on OTLP export: firewall/security-group drops, wrong routable IP, and how it differs from refused or DNS errors.
Read guide - · 9 min read
OpenTelemetry Error Guide: ''exporters' has invalid keys' — Fix Collector Config Typos
Fix ''exporters' has invalid keys: endpont' — the OpenTelemetry Collector rejects unknown keys under a component, so correct the mistyped field name.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'failed to create trace exporter' — Fix SDK Exporter Initialization
Fix 'failed to create the OTLP trace exporter: ... first path segment in URL cannot contain colon' by setting a valid OTEL_EXPORTER_OTLP_ENDPOINT scheme.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'first record does not look like a TLS handshake' — Fix Plaintext vs TLS OTLP
Fix 'tls: first record does not look like a TLS handshake': a plaintext client hit a TLS OTLP receiver. Align gRPC insecure vs secure.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'rpc error: code = PermissionDenied' — Fix OTLP Authorization
Fix 'rpc error: code = PermissionDenied desc = permission denied' on OTLP export: an API key lacks scope for the dataset or project.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'rpc error: code = Unauthenticated' — Fix OTLP gRPC Auth
Fix 'rpc error: code = Unauthenticated desc = authentication failed' on OTLP gRPC: add a valid bearer token or API-key header.
Read guide - · 8 min read
OpenTelemetry Error Guide: 'server gave HTTP response to HTTPS client' — Fix OTLP TLS Mismatch
Fix 'http: server gave HTTP response to HTTPS client' on OTLP: the exporter uses TLS but the Collector is plaintext. Fix the scheme or tls.insecure.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'pods is forbidden' in k8sattributes — Fix Collector RBAC
Fix 'pods is forbidden' in the k8sattributes processor: grant the Collector ServiceAccount a ClusterRole to list and watch pods, replicasets, namespaces.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'unable to parse OTTL statement' — Fix Transform Processor Syntax
Fix 'transform: unable to parse OTTL statement "set(attributes["env"], )": statement has invalid syntax' in the transform processor.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'Permanent error: rpc error: code = InvalidArgument' — Fix Rejected OTLP Data
Fix 'Permanent error: rpc error: code = InvalidArgument desc = invalid ... : malformed data' when a backend rejects OTLP payloads as malformed and drops them.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'Scrape failed' in the Prometheus receiver — Fix Metric Collection
Fix 'Scrape failed' in the OpenTelemetry Prometheus receiver: correct the target, port, metrics_path, scheme, TLS, and auth in your scrape_config.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'references processor which is not configured' — Fix Pipeline Wiring
Fix 'service::pipelines::traces: references processor "batch/2" which is not configured' by wiring pipeline processors to real top-level processor IDs.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'rpc error: code = Unavailable' — Fix OTLP gRPC Connectivity
Fix 'rpc error: code = Unavailable desc = connection error: desc = "transport: Error while dialing: dial tcp 10.0.0.9:4317: connect: connection refused"'
Read guide - · 9 min read
OpenTelemetry Error Guide: 'stream terminated by RST_STREAM' — Fix OTLP gRPC/HTTP2 Resets
Fix OTLP HTTP/2 resets: 'rpc error: code = Unavailable desc = stream terminated by RST_STREAM with error code: ENHANCE_YOUR_CALM'.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'send_batch_max_size must be greater or equal to send_batch_size' — Fix Batch Processor Config
Fix 'send_batch_max_size must be greater or equal to send_batch_size' by setting the batch processor's max size to at least its send_batch_size.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'remote error: tls: handshake failure' — Fix OTLP TLS Negotiation
Fix 'remote error: tls: handshake failure' on OTLP export: resolve a TLS version/cipher mismatch or a required client cert (mTLS) not sent.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'too many open files' in the Collector — Fix File Descriptor Limits
Fix 'accept tcp [::]:4317: accept4: too many open files' in the OTel Collector: raise LimitNOFILE / ulimit for high connection and filelog fd counts.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'error reading from server: EOF' — Fix OTLP Dropped Streams
Fix 'rpc error: code = Unavailable desc = error reading from server: EOF': the server or proxy closed the OTLP stream. Tune keepalive.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'unknown compression type' — Fix OTLP Exporter Compression Config
Fix 'unknown compression type "gzp"' by setting the OTLP exporter compression to a valid value: none, gzip, zstd, snappy, zlib, or deflate.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'receivers: unknown type' — Fix Unrecognized Collector Components
Fix 'error decoding 'receivers': unknown type: "otlpp"' by correcting misspelled component types or using a Collector distro that includes the component.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'unsupported protocol scheme' on OTLP/HTTP — Fix Endpoint URLs
Fix 'Post "collector:4318/v1/traces": unsupported protocol scheme ""' on OTLP/HTTP: add http:// or https:// to the exporter endpoint.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'connection reset by peer' on OTLP export — Fix Dropped Streams
Fix 'connection reset by peer' when an OpenTelemetry exporter loses its OTLP connection: idle timeouts, proxy/LB limits, HTTP/2 GOAWAY, keepalive, and message-size resets.
Read guide - · 8 min read
OpenTelemetry Error Guide: 'context canceled' on OTLP export — Fix Cancelled Exports
Fix 'context canceled' when an OpenTelemetry SDK or Collector aborts an OTLP export: shutdown races, timeouts, cancelled request contexts, and gRPC stream resets.
Read guide - · 8 min read
OpenTelemetry Error Guide: 'permission denied' in the filelog receiver — Fix Log Access
Fix 'permission denied' when the OpenTelemetry Collector filelog receiver can't read log files: file ownership, hostPath mounts, storage extension paths, and container security context.
Read guide - · 9 min read
OpenTelemetry Error Guide: '401 Unauthorized' exporting traces — Fix OTLP Auth Headers
Fix 401/403 when exporting OpenTelemetry traces: set OTEL_EXPORTER_OTLP_HEADERS API keys, Collector headers_setter and bearer auth, correct endpoints, and TLS to restore telemetry.
Read guide - · 8 min read
OpenTelemetry Error Guide: 'listen tcp 0.0.0.0:4317: bind: address already in use' — Fix Collector Port Conflicts
Fix the Collector 'address already in use' error on OTLP ports 4317/4318: find the process holding the port and resolve duplicate or hostPort clashes.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'connection refused' to the Collector — Fix OTLP Endpoints
Fix 'connection refused' when an OpenTelemetry SDK cannot reach the Collector: correct OTLP endpoints, ports 4317/4318, receiver binding, protocol mismatch, and network policy.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'context deadline exceeded' — Fix Exporter Timeouts
Fix 'context deadline exceeded' when an OpenTelemetry exporter times out: tune OTLP timeouts, endpoints, TLS, retries, and Collector queues to stop dropped traces and metrics.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'data refused due to high memory usage' — Tune memory_limiter
Fix 'data refused due to high memory usage' in the OpenTelemetry Collector: tune the memory_limiter processor, GOMEMLIMIT, batch sizing, and pod limits to stop refused telemetry.
Read guide - · 8 min read
OpenTelemetry Error Guide: 'failed to parse config' — Fix Collector Startup
Fix 'failed to parse config' when the OpenTelemetry Collector won't start: correct YAML indentation, unknown keys, missing components in the service pipeline, and env var expansion.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'invalid traceparent header' — Fix Broken W3C Context Propagation
Fix the OpenTelemetry 'invalid traceparent header' error: correct the W3C format, align propagators across services, and restore trace continuity.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'instrument has exceeded the maximum allowed cardinality' — Fix Metric Overflow
Fix the OpenTelemetry SDK cardinality limit warning: find the unbounded attribute, apply Views to drop or bucket keys, and stop the metric overflow series.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'no more retries left; dropping data' — Stop Telemetry Loss
Fix 'no more retries left; dropping data' in the OpenTelemetry Collector: tune retry_on_failure, sending_queue, backend availability, and backpressure so exports stop being dropped.
Read guide - · 8 min read
OpenTelemetry Error Guide: 'dial tcp: lookup otel-collector: no such host' — Fix OTLP DNS Resolution
Fix the OTLP exporter 'no such host' DNS error: correct the endpoint name, namespace, and port, and verify Kubernetes Service DNS and CoreDNS.
Read guide - · 8 min read
OpenTelemetry Error Guide: 'partial success' spans dropped — Stop Silent Data Loss
Fix OTLP 'partial success' when the backend rejects some spans: read rejected_spans and error_message, fix bad attributes, timestamps, and limits so telemetry stops being dropped.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'duplicate metric with different label sets' — Fix Prometheus Receiver Conflicts
Fix the OpenTelemetry prometheus receiver 'duplicate metric' error: resolve conflicting label sets, metric type collisions, and overlapping scrape jobs.
Read guide - · 8 min read
OpenTelemetry Error Guide: 'references exporter which is not configured' — Fix Collector Pipeline Wiring
Fix the Collector 'references exporter which is not configured' startup error: align pipeline component IDs with defined exporters and validate the config.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'ResourceExhausted: received message larger than max' — Fix gRPC OTLP Size Limits
Fix the OTLP ResourceExhausted error when a gRPC batch exceeds the max message size: tune send_batch_max_size and raise max_recv_msg_size_mib.
Read guide - · 8 min read
OpenTelemetry Error Guide: missing 'service.name' resource — Fix 'unknown_service'
Fix a missing service.name resource in OpenTelemetry: set OTEL_SERVICE_NAME and OTEL_RESOURCE_ATTRIBUTES so telemetry stops landing under 'unknown_service' and services are identifiable.
Read guide - · 8 min read
OpenTelemetry Error Guide: 'rpc error: code = Unimplemented' — Fix OTLP Endpoint & Protocol
Fix 'permanent error: rpc error: code = Unimplemented' when exporting OTLP: correct the endpoint, protocol, ports 4317/4318, and path so traces reach an OTLP-aware Collector.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'sending queue is full' — Fix OTLP Exporter Queue Overflow
Fix the OTLP exporter 'sending queue is full' error: size sending_queue and num_consumers, add persistent file-storage queues, and fix slow backends.
Read guide - · 9 min read
OpenTelemetry Error Guide: 'x509: certificate signed by unknown authority' — Fix OTLP TLS Trust
Fix the OTLP 'x509 certificate signed by unknown authority' error: supply the right CA bundle, fix hostname mismatches, and validate mTLS trust.
Read guide