observability-toolkit 1.3.0 → 1.4.0

package/dist/tools/signoz.integration.test.js

@@ -0,0 +1,141 @@
+/**
+ * Integration tests for SigNoz-dependent tools
+ *
+ * These tests connect to a real SigNoz instance when configured.
+ * They skip gracefully when SIGNOZ_URL and SIGNOZ_API_KEY are not set.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { SIGNOZ_URL, SIGNOZ_API_KEY, SIGNOZ_QUERY_URL } from '../lib/constants.js';
+import { healthCheck } from './health-check.js';
+import { getTraceUrl } from './get-trace-url.js';
+import { queryTraces } from './query-traces.js';
+import { queryLogs } from './query-logs.js';
+import { queryMetrics } from './query-metrics.js';
+// Check if SigNoz Query API is configured (SIGNOZ_QUERY_URL required for queries)
+const SIGNOZ_QUERY_CONFIGURED = !!(SIGNOZ_QUERY_URL && SIGNOZ_API_KEY);
+// Check if SigNoz ingest is configured (for health check)
+const SIGNOZ_CONFIGURED = !!(SIGNOZ_URL && SIGNOZ_API_KEY);
+describe('Tool Integration Tests (SigNoz)', { skip: !SIGNOZ_QUERY_CONFIGURED }, () => {
+    describe('healthCheck with SigNoz', () => {
+        it('should include SigNoz status in health check', async () => {
+            const result = await healthCheck({ verbose: true });
+            assert.strictEqual(typeof result, 'object');
+            assert('backends' in result);
+            assert('signoz' in result.backends);
+            assert.strictEqual(result.backends.signoz.configured, true);
+            assert(['ok', 'error'].includes(result.backends.signoz.status));
+            console.log(`  SigNoz status: ${result.backends.signoz.status}`);
+            if (result.backends.signoz.message) {
+                console.log(`  Message: ${result.backends.signoz.message}`);
+            }
+        });
+        it('should report degraded status if SigNoz fails', async () => {
+            const result = await healthCheck({ verbose: false });
+            // When SigNoz is configured, overall status depends on both backends
+            assert(['healthy', 'degraded', 'unhealthy'].includes(result.status));
+            console.log(`  Overall status: ${result.status}`);
+        });
+    });
+    describe('getTraceUrl with SigNoz', () => {
+        it('should generate trace URL for valid trace ID', async () => {
+            // First, get a real trace ID from SigNoz
+            const traces = await queryTraces({ backend: 'signoz', limit: 1 });
+            if (traces.count > 0 && traces.traces.length > 0) {
+                const traceId = traces.traces[0].traceId;
+                const result = await getTraceUrl({ traceId });
+                assert('url' in result);
+                assert(result.url && result.url.includes(traceId));
+                console.log(`  Generated URL for trace: ${traceId.substring(0, 16)}...`);
+            }
+            else {
+                console.log('  No traces found to test URL generation');
+            }
+        });
+        it('should handle non-existent trace ID gracefully', async () => {
+            const result = await getTraceUrl({ traceId: 'nonexistent-trace-id-12345' });
+            // Should still return a URL (validation happens on SigNoz side)
+            assert('url' in result || 'error' in result);
+        });
+    });
+    describe('queryTraces with SigNoz backend', () => {
+        it('should query traces from SigNoz', async () => {
+            const result = await queryTraces({ backend: 'signoz', limit: 5 });
+            assert.strictEqual(result.backend, 'signoz');
+            assert(typeof result.count === 'number');
+            assert(Array.isArray(result.traces));
+            console.log(`  Found ${result.count} traces via SigNoz`);
+        });
+        it('should filter traces by duration', async () => {
+            const result = await queryTraces({
+                backend: 'signoz',
+                minDurationMs: 100,
+                limit: 5,
+            });
+            assert.strictEqual(result.backend, 'signoz');
+            console.log(`  Found ${result.count} traces with duration >= 100ms`);
+        });
+    });
+    describe('queryLogs with SigNoz backend', () => {
+        it('should query logs from SigNoz', async () => {
+            const result = await queryLogs({ backend: 'signoz', limit: 5 });
+            assert.strictEqual(result.backend, 'signoz');
+            assert(typeof result.count === 'number');
+            assert(Array.isArray(result.logs));
+            console.log(`  Found ${result.count} logs via SigNoz`);
+        });
+        it('should filter logs by severity', async () => {
+            const result = await queryLogs({
+                backend: 'signoz',
+                severity: 'INFO',
+                limit: 5,
+            });
+            assert.strictEqual(result.backend, 'signoz');
+            console.log(`  Found ${result.count} INFO logs`);
+        });
+    });
+    describe('queryMetrics with SigNoz backend', () => {
+        it('should query metrics from SigNoz', async () => {
+            const result = await queryMetrics({
+                backend: 'signoz',
+                metricName: 'signoz_calls_total',
+                limit: 5,
+            });
+            assert.strictEqual(result.backend, 'signoz');
+            assert(typeof result.count === 'number');
+            console.log(`  Found ${result.count} metric data points via SigNoz`);
+        });
+    });
+});
+describe('Tool Integration (No SigNoz Query)', { skip: SIGNOZ_QUERY_CONFIGURED || !SIGNOZ_CONFIGURED }, () => {
+    // This test only runs when ingest is configured but query is not
+    it('should show SigNoz configured but query unavailable', async () => {
+        const result = await healthCheck({ verbose: false });
+        // Ingest URL is configured, so healthCheck shows it as configured
+        // But query operations will fail without SIGNOZ_QUERY_URL
+        console.log(`  SigNoz ingest configured: ${result.backends.signoz.configured}`);
+        console.log(`  SigNoz status: ${result.backends.signoz.status}`);
+        assert(true);
+    });
+});
+describe('Tool Integration (No SigNoz At All)', { skip: SIGNOZ_CONFIGURED }, () => {
+    it('should handle missing SigNoz configuration gracefully', async () => {
+        const result = await healthCheck({ verbose: false });
+        assert.strictEqual(result.backends.signoz.configured, false);
+        assert.strictEqual(result.backends.signoz.status, 'not_configured');
+        console.log('  SigNoz not configured - tools handle gracefully');
+    });
+});
+describe('SigNoz Tool Configuration Check', () => {
+    it('should report SigNoz configuration status', () => {
+        if (SIGNOZ_QUERY_CONFIGURED) {
+            console.log('  SigNoz Query API configured - tool integration tests will run');
+        }
+        else {
+            console.log('  SigNoz Query API not configured - tool integration tests skipped');
+            console.log('  Set SIGNOZ_QUERY_URL and SIGNOZ_API_KEY to enable');
+        }
+        assert(true);
+    });
+});
+//# sourceMappingURL=signoz.integration.test.js.map

package/dist/tools/signoz.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signoz.integration.test.js","sourceRoot":"","sources":["../../src/tools/signoz.integration.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "observability-toolkit",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "MCP server for observability tooling - query traces, metrics, logs from local JSONL or SigNoz",
   "type": "module",
   "main": "dist/server.js",
@@ -11,7 +11,7 @@
     "build": "tsc",
     "watch": "tsc --watch",
     "start": "node dist/server.js",
-    "test": "node --test dist/**/*.test.js"
+    "test": "node --test dist/*.test.js dist/**/*.test.js"
   },
   "keywords": [
     "mcp",
@@ -26,8 +26,11 @@
   "author": "Alyshia Ledlie",
   "license": "MIT",
   "dependencies": {
+    "@modelcontextprotocol/ext-apps": "^1.0.1",
     "@modelcontextprotocol/sdk": "^1.11.2",
-    "zod": "^3.24.2"
+    "mcp-remote": "^0.1.37",
+    "zod": "^3.24.2",
+    "zod-to-json-schema": "^3.25.1"
   },
   "devDependencies": {
     "@types/node": "^22.15.21",