observability-toolkit 1.6.0 → 1.8.0

package/README.md

@@ -18,134 +18,250 @@ claude mcp add observability-toolkit -- node ~/.claude/mcp-servers/observability
 
 | Tool | Description |
 |------|-------------|
-| `obs_query_traces` | Query traces from local JSONL or SigNoz |
-| `obs_query_metrics` | Query metrics with aggregation support |
-| `obs_query_logs` | Query logs by severity, search text, trace ID |
+| `obs_query_traces` | Query traces with filtering, regex, numeric operators |
+| `obs_query_metrics` | Query metrics with aggregations (sum, avg, p50, p95, p99, rate) |
+| `obs_query_logs` | Query logs with boolean search, field extraction |
 | `obs_query_llm_events` | Query LLM events with token usage and duration metrics |
-| `obs_health_check` | Check telemetry system health |
+| `obs_health_check` | Check telemetry system health with cache statistics |
 | `obs_context_stats` | Get context window utilization stats |
 | `obs_get_trace_url` | Get SigNoz trace viewer URL (requires SigNoz) |
-| `obs_setup_claudeignore` | Add entries to .claudeignore (telemetry, test files, coverage) |
+| `obs_setup_claudeignore` | Add entries to .claudeignore |
 
 ## Configuration
 
-| Variable | Description | Required |
-|----------|-------------|----------|
-| `TELEMETRY_DIR` | Local telemetry directory | No (default: `~/.claude/telemetry`) |
-| `SIGNOZ_URL` | SigNoz instance URL | No (enables SigNoz integration) |
-| `SIGNOZ_API_KEY` | SigNoz API key | No (required if using SigNoz) |
-
-The server works standalone with local JSONL files. SigNoz integration is optional.
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `TELEMETRY_DIR` | Local telemetry directory | `~/.claude/telemetry` |
+| `SIGNOZ_URL` | SigNoz instance URL | - |
+| `SIGNOZ_API_KEY` | SigNoz API key | - |
+| `CACHE_TTL_MS` | Query cache TTL in milliseconds | `60000` |
+| `RETENTION_DAYS` | Days to retain telemetry files | `7` |
 
 ## Usage Examples
 
-### Query traces
+### Query Traces
 
-```
-obs_query_traces({ backend: "local", limit: 10 })
-obs_query_traces({ traceId: "abc123..." })
-obs_query_traces({ serviceName: "claude-code", minDurationMs: 100 })
-obs_query_traces({ attributeFilter: { "agent.source_type": "lazy" } })
-```
+```javascript
+// Basic query
+obs_query_traces({ limit: 10 })
 
-### Filterable Attributes
+// Filter by trace ID
+obs_query_traces({ traceId: "abc123..." })
 
-Use `attributeFilter` to query by span attributes:
+// Filter by service and duration
+obs_query_traces({ serviceName: "claude-code", minDurationMs: 100 })
 
-| Attribute | Values | Description |
-|-----------|--------|-------------|
-| `agent.type` | string | Agent name (e.g., "Explore", "auto-error-resolver") |
-| `agent.source_type` | `active`, `lazy`, `builtin`, `settings` | Where agent is defined |
-| `agent.category` | string | Agent category (e.g., "error-handling", "code") |
-| `plugin.name` | string | Skill/plugin name |
-| `plugin.source_type` | `active`, `lazy`, `settings` | Where skill is defined |
-| `plugin.category` | string | Skill category |
-| `mcp.server` | string | MCP server name |
-| `mcp.tool` | string | MCP tool name |
-| `builtin.tool` | string | Built-in tool name (Read, Write, Bash, etc.) |
-| `hook.type` | `agent`, `plugin`, `mcp`, `builtin` | Hook handler type |
+// Regex pattern matching
+obs_query_traces({ spanNameRegex: "^http\\..*" })
+
+// Numeric attribute filtering
+obs_query_traces({
+  numericFilter: [
+    { attribute: "http.status_code", operator: "gte", value: 400 }
+  ]
+})
+
+// Existence checks
+obs_query_traces({
+  attributeExists: ["error.message"],
+  attributeNotExists: ["http.response.body"]
+})
+
+// OTel GenAI agent/tool filters
+obs_query_traces({ agentName: "Explore", toolName: "Read" })
+obs_query_traces({ operationName: "execute_tool", toolCallId: "toolu_123" })
+```
 
-### Query logs
+### Query Logs
 
-```
+```javascript
+// Basic severity filter
 obs_query_logs({ severity: "ERROR", limit: 20 })
-obs_query_logs({ search: "timeout", startDate: "2026-01-28" })
-obs_query_logs({ traceId: "abc123..." })
+
+// Boolean search (AND)
+obs_query_logs({
+  searchTerms: ["timeout", "connection"],
+  searchOperator: "AND"
+})
+
+// Boolean search (OR)
+obs_query_logs({
+  searchTerms: ["error", "warning", "critical"],
+  searchOperator: "OR"
+})
+
+// Field extraction from JSON logs
+obs_query_logs({
+  extractFields: ["user.id", "request.method", "response.status"]
+})
+
+// Exclude patterns
+obs_query_logs({
+  search: "error",
+  excludeSearch: "health-check"
+})
 ```
 
-### Query metrics
+### Query Metrics
 
-```
+```javascript
+// Basic query
 obs_query_metrics({ metricName: "session.context.size" })
-obs_query_metrics({ metricName: "gen_ai.client.token.usage", aggregation: "sum" })
-```
 
-### Query LLM events
-
-```
-obs_query_llm_events({})
-obs_query_llm_events({ model: "claude-opus-4-5", limit: 10 })
-obs_query_llm_events({ provider: "anthropic", startDate: "2026-01-28" })
+// Aggregations
+obs_query_metrics({ metricName: "http.duration", aggregation: "avg" })
+obs_query_metrics({ metricName: "http.duration", aggregation: "p95" })
+obs_query_metrics({ metricName: "requests.count", aggregation: "rate" })
+
+// Time bucket grouping
+obs_query_metrics({
+  metricName: "token.usage",
+  aggregation: "sum",
+  timeBucket: "1h",
+  groupBy: ["model"]
+})
+
+// Percentiles
+obs_query_metrics({ metricName: "latency", aggregation: "p99" })
 ```
 
-### Health check
+### Query LLM Events
 
-```
-obs_health_check({ verbose: true })
-```
+```javascript
+// Basic query
+obs_query_llm_events({ limit: 20 })
 
-### Context stats
+// Filter by model and provider
+obs_query_llm_events({ model: "claude-3-opus", provider: "anthropic" })
 
-```
-obs_context_stats({})
-obs_context_stats({ sessionId: "abc123...", includeCost: true })
-```
+// OTel GenAI operation types
+obs_query_llm_events({ operationName: "chat" })
+obs_query_llm_events({ operationName: "invoke_agent" })
 
-### Get trace URL
+// Filter by conversation
+obs_query_llm_events({ conversationId: "conv-abc123" })
 
-```
-obs_get_trace_url({ traceId: "abc123..." })
+// Combine filters
+obs_query_llm_events({
+  operationName: "chat",
+  provider: "anthropic",
+  conversationId: "conv-abc123"
+})
 ```
 
-### Setup .claudeignore
+### Health Check with Cache Stats
 
-```
-obs_setup_claudeignore({})
-obs_setup_claudeignore({ dryRun: true })
-obs_setup_claudeignore({ includeDefaults: false, entry: "custom/" })
-obs_setup_claudeignore({ entries: ["logs/", "tmp/", "*.bak"] })
+```javascript
+obs_health_check({ verbose: true })
+
+// Returns:
+{
+  "status": "ok",
+  "backends": { ... },
+  "cache": {
+    "traces": { "hits": 10, "misses": 5, "hitRate": 0.67, "size": 15, "evictions": 0 },
+    "logs": { "hits": 8, "misses": 12, "hitRate": 0.4, "size": 20, "evictions": 2 },
+    "metrics": { "hits": 0, "misses": 0, "hitRate": 0, "size": 0, "evictions": 0 },
+    "llmEvents": { "hits": 0, "misses": 0, "hitRate": 0, "size": 0, "evictions": 0 }
+  }
+}
 ```
 
-Default entries added when `includeDefaults: true` (default):
-- `telemetry/` - telemetry data
-- `*.test.ts` - TypeScript test files
-- `*.test.js` - JavaScript test files
-- `coverage/` - coverage reports
+## Features
+
+### Query Capabilities
+
+| Feature | Description |
+|---------|-------------|
+| Percentile Aggregations | p50, p95, p99 for metrics |
+| Time Bucket Grouping | 1m, 5m, 1h, 1d buckets for trend analysis |
+| Rate Calculations | Per-second rate of change |
+| Numeric Operators | gt, gte, lt, lte, eq for attribute filtering |
+| Regex Patterns | Advanced span name filtering |
+| Boolean Search | AND/OR operators for log queries |
+| Field Extraction | Extract JSON paths from structured logs |
+| Negation Filters | Exclude matching spans/logs |
+| Existence Checks | Filter by attribute presence |
+
+### OTel Compliance
+
+| Feature | Description |
+|---------|-------------|
+| severityNumber | Standard OTel severity levels |
+| statusCode | UNSET, OK, ERROR for spans |
+| Histogram Buckets | Full histogram distribution support |
+| InstrumentationScope | Library/module metadata |
+| Span Links | Cross-trace relationships |
+| Exemplars | Metric-to-trace correlation |
+| Aggregation Temporality | DELTA, CUMULATIVE support |
+
+### OTel GenAI Semantic Conventions (8/10 compliance)
+
+| Feature | Description |
+|---------|-------------|
+| `gen_ai.operation.name` | Filter by chat, embeddings, invoke_agent, execute_tool |
+| `gen_ai.provider.name` | Provider fallback: gen_ai.provider.name → gen_ai.system → provider |
+| `gen_ai.conversation.id` | Filter LLM events by conversation ID |
+| `gen_ai.agent.id/name` | Filter traces by agent attributes |
+| `gen_ai.tool.name/call.id` | Filter traces by tool attributes |
+| Percentiles | p50, p95, p99, rate aggregations |
+
+### Performance
+
+| Feature | Description |
+|---------|-------------|
+| Query Caching | LRU cache with configurable TTL |
+| File Indexing | .idx sidecars for fast lookups |
+| Gzip Support | Transparent decompression of .jsonl.gz files |
+| BatchWriter | Buffered writes to reduce I/O |
+| Streaming | Early termination for large files |
+| Parallel Queries | Concurrent multi-directory queries |
+| Cursor Pagination | Efficient large result set handling |
+
+### Internal Observability
+
+| Feature | Description |
+|---------|-------------|
+| Cache Metrics | Hit/miss/eviction tracking |
+| Query Timing | Slow query warnings (>500ms) |
+| Circuit Breaker Logging | State transition visibility |
+| Health Check Stats | Cache statistics in health output |
 
 ## Data Sources
 
 ### Local JSONL (Default)
 
-Automatically scans multiple telemetry directories:
+Scans multiple telemetry directories:
 - **Global**: `~/.claude/telemetry/` (always checked)
-- **Project-local**: `.claude/telemetry/`, `telemetry/`, `.telemetry/` (checked if they exist in cwd)
-
-This allows querying both global Claude Code telemetry and project-specific telemetry.
+- **Project-local**: `.claude/telemetry/`, `telemetry/`, `.telemetry/`
 
-File patterns:
-- `traces-YYYY-MM-DD.jsonl` - Trace spans
-- `logs-YYYY-MM-DD.jsonl` - Log records
-- `metrics-YYYY-MM-DD.jsonl` - Metric data points
-- `llm-events-YYYY-MM-DD.jsonl` - LLM events
+File patterns (supports gzip compression):
+- `traces-YYYY-MM-DD.jsonl` / `.jsonl.gz`
+- `logs-YYYY-MM-DD.jsonl` / `.jsonl.gz`
+- `metrics-YYYY-MM-DD.jsonl` / `.jsonl.gz`
+- `llm-events-YYYY-MM-DD.jsonl` / `.jsonl.gz`
 
 ### SigNoz Cloud (Optional)
 
-When `SIGNOZ_URL` and `SIGNOZ_API_KEY` are configured, queries SigNoz Cloud API:
-- Traces: `/api/v3/traces`
-- Logs: `/api/v3/logs`
-- Metrics: `/api/v3/query_range`
+When configured, queries SigNoz Cloud API with:
+- Circuit breaker protection
+- Cursor-based pagination
+- Response time tracking
 
-Use `backend: "signoz"` in queries to explicitly use SigNoz, or `backend: "auto"` to try both.
+## OTLP Export
+
+Export data in OpenTelemetry format:
+
+```javascript
+// Export traces
+const otlpTraces = await backend.exportTracesOTLP({ startDate: "2026-01-28" });
+
+// Export logs
+const otlpLogs = await backend.exportLogsOTLP({ severity: "ERROR" });
+
+// Export metrics
+const otlpMetrics = await backend.exportMetricsOTLP({ metricName: "http.duration" });
+```
 
 ## Development
 
@@ -153,15 +269,11 @@ Use `backend: "signoz"` in queries to explicitly use SigNoz, or `backend: "auto"
 cd ~/.claude/mcp-servers/observability-toolkit
 npm install
 npm run build
-npm test     # 617 tests
+npm test     # 911 tests
 npm run start
 ```
 
 ## Documentation
 
-- [ROADMAP.md](docs/ROADMAP.md) - Improvement roadmap with priorities
-- [code-review.md](docs/code-review.md) - Code review findings
-- [security-audit.md](docs/security-audit.md) - Security audit report
-- [observability-audit.md](docs/observability-audit.md) - Observability best practices audit
-
-
+- [CHANGELOG.md](CHANGELOG.md) - Version history and changes
+- [docs/ROADMAP.md](docs/ROADMAP.md) - Feature roadmap (all items complete)

package/dist/backends/index.d.ts

@@ -119,6 +119,55 @@ export interface NumericFilterCondition {
     operator: 'gt' | 'gte' | 'lt' | 'lte' | 'eq';
     value: number;
 }
+/**
+ * OTel GenAI agent and tool attribute names
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/
+ */
+export declare const GENAI_AGENT_ATTRIBUTES: {
+    readonly AGENT_ID: "gen_ai.agent.id";
+    readonly AGENT_NAME: "gen_ai.agent.name";
+    readonly AGENT_DESCRIPTION: "gen_ai.agent.description";
+};
+export declare const GENAI_TOOL_ATTRIBUTES: {
+    readonly TOOL_NAME: "gen_ai.tool.name";
+    readonly TOOL_CALL_ID: "gen_ai.tool.call.id";
+    readonly TOOL_TYPE: "gen_ai.tool.type";
+};
+/**
+ * OTel GenAI request attribute names
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/
+ */
+export declare const GENAI_REQUEST_ATTRIBUTES: {
+    readonly MODEL: "gen_ai.request.model";
+    readonly TEMPERATURE: "gen_ai.request.temperature";
+    readonly MAX_TOKENS: "gen_ai.request.max_tokens";
+};
+/**
+ * OTel GenAI response attribute names
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/
+ */
+export declare const GENAI_RESPONSE_ATTRIBUTES: {
+    readonly MODEL: "gen_ai.response.model";
+    readonly FINISH_REASONS: "gen_ai.response.finish_reasons";
+};
+/**
+ * OTel GenAI usage attribute names
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/
+ */
+export declare const GENAI_USAGE_ATTRIBUTES: {
+    readonly INPUT_TOKENS: "gen_ai.usage.input_tokens";
+    readonly OUTPUT_TOKENS: "gen_ai.usage.output_tokens";
+};
+/**
+ * OTel GenAI core attribute names
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/
+ */
+export declare const GENAI_CORE_ATTRIBUTES: {
+    readonly OPERATION_NAME: "gen_ai.operation.name";
+    readonly PROVIDER_NAME: "gen_ai.provider.name";
+    readonly SYSTEM: "gen_ai.system";
+    readonly CONVERSATION_ID: "gen_ai.conversation.id";
+};
 export interface TraceQueryOptions extends QueryOptions {
     traceId?: string;
     serviceName?: string;
@@ -136,6 +185,18 @@ export interface TraceQueryOptions extends QueryOptions {
     attributeNotExists?: string[];
     /** Numeric comparison filters for attributes */
     numericFilter?: NumericFilterCondition[];
+    /** Filter by agent ID (gen_ai.agent.id) */
+    agentId?: string;
+    /** Filter by agent name (gen_ai.agent.name) */
+    agentName?: string;
+    /** Filter by tool name (gen_ai.tool.name) */
+    toolName?: string;
+    /** Filter by tool call ID (gen_ai.tool.call.id) */
+    toolCallId?: string;
+    /** Filter by tool type (gen_ai.tool.type) */
+    toolType?: string;
+    /** Filter by operation name (gen_ai.operation.name) */
+    operationName?: GenAIOperationName;
 }
 export interface LogQueryOptions extends QueryOptions {
     severity?: string;
@@ -168,11 +229,20 @@ export interface LLMEvent {
     name: string;
     attributes: Record<string, unknown>;
 }
+/**
+ * OTel GenAI operation types
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/
+ */
+export type GenAIOperationName = 'chat' | 'embeddings' | 'invoke_agent' | 'execute_tool';
 export interface LLMEventQueryOptions extends QueryOptions {
     eventName?: string;
     model?: string;
     provider?: string;
     search?: string;
+    /** Filter by OTel GenAI operation name (chat, embeddings, invoke_agent, execute_tool) */
+    operationName?: GenAIOperationName;
+    /** Filter by conversation/session ID (gen_ai.conversation.id) */
+    conversationId?: string;
 }
 export type { OTLPTraceExport, OTLPLogExport, OTLPMetricExport, } from '../lib/otlp-export.js';
 export interface TelemetryBackend {

package/dist/backends/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"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"}

package/dist/backends/index.js

@@ -1,5 +1,53 @@
 /**
  * Backend interface for telemetry data sources
  */
-export {};
+/**
+ * OTel GenAI agent and tool attribute names
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/
+ */
+export const GENAI_AGENT_ATTRIBUTES = {
+    AGENT_ID: 'gen_ai.agent.id',
+    AGENT_NAME: 'gen_ai.agent.name',
+    AGENT_DESCRIPTION: 'gen_ai.agent.description',
+};
+export const GENAI_TOOL_ATTRIBUTES = {
+    TOOL_NAME: 'gen_ai.tool.name',
+    TOOL_CALL_ID: 'gen_ai.tool.call.id',
+    TOOL_TYPE: 'gen_ai.tool.type',
+};
+/**
+ * OTel GenAI request attribute names
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/
+ */
+export const GENAI_REQUEST_ATTRIBUTES = {
+    MODEL: 'gen_ai.request.model',
+    TEMPERATURE: 'gen_ai.request.temperature',
+    MAX_TOKENS: 'gen_ai.request.max_tokens',
+};
+/**
+ * OTel GenAI response attribute names
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/
+ */
+export const GENAI_RESPONSE_ATTRIBUTES = {
+    MODEL: 'gen_ai.response.model',
+    FINISH_REASONS: 'gen_ai.response.finish_reasons',
+};
+/**
+ * OTel GenAI usage attribute names
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/
+ */
+export const GENAI_USAGE_ATTRIBUTES = {
+    INPUT_TOKENS: 'gen_ai.usage.input_tokens',
+    OUTPUT_TOKENS: 'gen_ai.usage.output_tokens',
+};
+/**
+ * OTel GenAI core attribute names
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/
+ */
+export const GENAI_CORE_ATTRIBUTES = {
+    OPERATION_NAME: 'gen_ai.operation.name',
+    PROVIDER_NAME: 'gen_ai.provider.name',
+    SYSTEM: 'gen_ai.system',
+    CONVERSATION_ID: 'gen_ai.conversation.id',
+};
 //# sourceMappingURL=index.js.map

package/dist/backends/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgIH;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,iBAAiB;IAC3B,UAAU,EAAE,mBAAmB;IAC/B,iBAAiB,EAAE,0BAA0B;CACrC,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,SAAS,EAAE,kBAAkB;IAC7B,YAAY,EAAE,qBAAqB;IACnC,SAAS,EAAE,kBAAkB;CACrB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,4BAA4B;IACzC,UAAU,EAAE,2BAA2B;CAC/B,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,KAAK,EAAE,uBAAuB;IAC9B,cAAc,EAAE,gCAAgC;CACxC,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY,EAAE,2BAA2B;IACzC,aAAa,EAAE,4BAA4B;CACnC,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,cAAc,EAAE,uBAAuB;IACvC,aAAa,EAAE,sBAAsB;IACrC,MAAM,EAAE,eAAe;IACvB,eAAe,EAAE,wBAAwB;CACjC,CAAC"}

package/dist/backends/local-jsonl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-jsonl.d.ts","sourceRoot":"","sources":["../../src/backends/local-jsonl.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"local-jsonl.d.ts","sourceRoot":"","sources":["../../src/backends/local-jsonl.ts"],"names":[],"mappings":"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"}

package/dist/backends/local-jsonl.js

@@ -424,7 +424,7 @@ export class LocalJsonlBackend {
             logTiming();
             return cached;
         }
-        const files = getFilesInRange(this.telemetryDir, /traces-\d{4}-\d{2}-\d{2}\.jsonl$/, options.startDate, options.endDate);
+        const files = getFilesInRange(this.telemetryDir, /traces-\d{4}-\d{2}-\d{2}\.jsonl(\.gz)?$/, options.startDate, options.endDate);
         const results = [];
         const limit = options.limit || 100;
         const offset = options.offset || 0;
@@ -481,6 +481,19 @@ export class LocalJsonlBackend {
                 if (!applyNumericFilters(span.attributes, options.numericFilter))
                     return false;
             }
+            // OTel GenAI agent/tool filters
+            if (options.agentId && span.attributes?.['gen_ai.agent.id'] !== options.agentId)
+                return false;
+            if (options.agentName && span.attributes?.['gen_ai.agent.name'] !== options.agentName)
+                return false;
+            if (options.toolName && span.attributes?.['gen_ai.tool.name'] !== options.toolName)
+                return false;
+            if (options.toolCallId && span.attributes?.['gen_ai.tool.call.id'] !== options.toolCallId)
+                return false;
+            if (options.toolType && span.attributes?.['gen_ai.tool.type'] !== options.toolType)
+                return false;
+            if (options.operationName && span.attributes?.['gen_ai.operation.name'] !== options.operationName)
+                return false;
             return true;
         };
         for (const file of files) {
@@ -552,7 +565,7 @@ export class LocalJsonlBackend {
             logTiming();
             return cached;
         }
-        const files = getFilesInRange(this.telemetryDir, /logs-\d{4}-\d{2}-\d{2}\.jsonl$/, options.startDate, options.endDate);
+        const files = getFilesInRange(this.telemetryDir, /logs-\d{4}-\d{2}-\d{2}\.jsonl(\.gz)?$/, options.startDate, options.endDate);
         const results = [];
         const limit = options.limit || 100;
         const offset = options.offset || 0;
@@ -667,7 +680,7 @@ export class LocalJsonlBackend {
             logTiming();
             return cached;
         }
-        const files = getFilesInRange(this.telemetryDir, /metrics-\d{4}-\d{2}-\d{2}\.jsonl$/, options.startDate, options.endDate);
+        const files = getFilesInRange(this.telemetryDir, /metrics-\d{4}-\d{2}-\d{2}\.jsonl(\.gz)?$/, options.startDate, options.endDate);
         const results = [];
         const limit = options.limit || 100;
         const offset = options.offset || 0;
@@ -839,7 +852,7 @@ export class LocalJsonlBackend {
             logTiming();
             return cached;
         }
-        const files = getFilesInRange(this.telemetryDir, /llm-events-\d{4}-\d{2}-\d{2}\.jsonl$/, options.startDate, options.endDate);
+        const files = getFilesInRange(this.telemetryDir, /llm-events-\d{4}-\d{2}-\d{2}\.jsonl(\.gz)?$/, options.startDate, options.endDate);
         const results = [];
         const limit = options.limit || 100;
         const offset = options.offset || 0;
@@ -855,10 +868,23 @@ export class LocalJsonlBackend {
                     return false;
             }
             if (options.provider) {
-                const provider = event.attributes?.['gen_ai.system'] || event.attributes?.['provider'];
+                // OTel GenAI compliant: gen_ai.provider.name -> gen_ai.system -> provider
+                const provider = event.attributes?.['gen_ai.provider.name'] ||
+                    event.attributes?.['gen_ai.system'] ||
+                    event.attributes?.['provider'];
                 if (provider !== options.provider)
                     return false;
             }
+            if (options.operationName) {
+                const opName = event.attributes?.['gen_ai.operation.name'];
+                if (opName !== options.operationName)
+                    return false;
+            }
+            if (options.conversationId) {
+                const convId = event.attributes?.['gen_ai.conversation.id'];
+                if (convId !== options.conversationId)
+                    return false;
+            }
             if (options.search) {
                 const searchLower = options.search.toLowerCase();
                 const attrStr = JSON.stringify(event.attributes).toLowerCase();