用途:为 Java、Python、Node.js、.NET、Go 应用接入 OpenTelemetry SDK,把 traces、metrics、logs 发送到 Coralogix。
主要能力:按语言选择接入方式;配置 OTLP 端点、区域与认证;生成含假设、代码与验证步骤的答复;诊断 SDK 侧缺失的 traces/metrics/logs。
使用方式:先加载 language-selector.md 确定语言、信号、模式与导出路径,再加载对应语言参考(java.md、python.md、nodejs.md、dotnet.md、go.md),随后加载 coralogix-endpoints.md,最后用 output-templates.md 生成面向用户的答复;排障时加载 troubleshooting.md。代理模式应先调用 list_references(),再 read_reference(...)。
关键要求:答复需包含环境变量名 OTEL_EXPORTER_OTLP_ENDPOINT、OTEL_EXPORTER_OTLP_HEADERS、OTEL_SERVICE_NAME、OTEL_RESOURCE_ATTRIBUTES,以及必要时的 OTEL_EXPORTER、OTEL_EXPORTER_OTLP_PROTOCOL;资源属性需含 service.name、cx.application.name、cx.subsystem.name,telemetry.sdk.language 自动设置且不应移除。遥测质量要求低基数 span 名、无敏感数据、指标属性有界、结构化单行日志含 trace/span ID;禁止把 user_id、tenant_id、request_id、session_id 作为指标标签。路由默认:开发测试、简单单服务生产或无 collector 时直连 OTLP;Kubernetes 需 pod/namespace 富化、尾采样、多服务共享密钥或缓冲重试时经 collector。
已知要点:Java 用 opentelemetry-javaagent.jar 与 JAVA_TOOL_OPTIONS="-javaagent:/path/to/opentelemetry-javaagent.jar";Java/.NET gRPC 端点须为完整 URI https://ingress.<region>.coralogix.com:443;Python 环境变量认证头需 %20;Node.js HTTP/proto 的 exporter url 须含 /v1/traces;Go gRPC 用 credentials.NewTLS(nil) 与裸端点;Go 指标默认基数上限 2000;.NET OTLP 磁盘重试需指定目录;Transactions 需 CoralogixTransactionSampler。
限制:不含 Collector/OTTL、Lambda/Serverless、PHP、eBPF 自动注入及 Coralogix 平台内部配置;原生 Coralogix SDK 于 2026 年 6 月 30 日 EOL,应改用 OTel。