@tpmjs/tools-error-log-triage
Triages error logs by severity and frequency. Groups similar errors together by pattern (removing IDs, paths, timestamps), counts occurrences, tracks time ranges, and provides actionable recommendations for debugging. Useful for analyzing application logs, identifying systemic issues, and prioritizing bug fixes.
Test @tpmjs/tools-error-log-triage (errorLogTriageTool) with AI-powered execution
0/2000 characters
Install this tool and use it with the AI SDK
npm install @tpmjs/tools-error-log-triagepnpm add @tpmjs/tools-error-log-triageyarn add @tpmjs/tools-error-log-triagebun add @tpmjs/tools-error-log-triagedeno add npm:@tpmjs/tools-error-log-triageimport { errorLogTriageTool } from '@tpmjs/tools-error-log-triage';import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { errorLogTriageTool } from '@tpmjs/tools-error-log-triage';
const result = await generateText({
model: openai('gpt-4o'),
tools: { errorLogTriageTool },
prompt: 'Your prompt here...',
});
console.log(result.text);Available configuration options
logsarrayArray of log entries to analyze
Schema extracted: 1/1/2026, 8:17:36 AM
Triages error logs by severity and frequency, groups similar errors, and provides actionable recommendations for debugging.
npm install @tpmjs/tools-error-log-triage
import { errorLogTriageTool } from '@tpmjs/tools-error-log-triage'; const result = await errorLogTriageTool.execute({ logs: [ { message: 'Database connection failed to postgres://localhost:5432', level: 'error', timestamp: '2025-01-15T10:30:00Z' }, { message: 'Database connection failed to postgres://localhost:5433', level: 'error', timestamp: '2025-01-15T10:30:05Z' }, { message: 'Null reference error at user.service.ts:45', level: 'error', timestamp: '2025-01-15T10:31:00Z' } ] }); console.log(result); // { // groups: [ // { // pattern: 'Database connection failed to [URL]', // count: 2, // severity: 'error', // firstOccurrence: '2025-01-15T10:30:00Z', // lastOccurrence: '2025-01-15T10:30:05Z', // examples: [ // 'Database connection failed to postgres://localhost:5432', // 'Database connection failed to postgres://localhost:5433' // ] // }, // // ... more groups // ], // severityCounts: { // critical: 0, // error: 3, // warning: 0, // info: 0 // }, // recommendations: [ // 'Check network and database connectivity - 2 connection error(s) detected', // 'Add null checks - 1 null/undefined reference error(s) detected' // ], // summary: { // totalLogs: 3, // uniquePatterns: 2, // timeRange: '2025-01-15T10:30:00Z to 2025-01-15T10:31:00Z' // } // }
{ logs: Array<{ message: string; // The error message or log text level: string; // Log level (error, warning, info, critical, fatal, etc.) timestamp: string; // ISO 8601 timestamp }> }
{ groups: Array<{ pattern: string; // Normalized error pattern count: number; // Number of occurrences severity: string; // Mapped severity level firstOccurrence: string; // ISO timestamp of first occurrence lastOccurrence: string; // ISO timestamp of last occurrence examples: string[]; // Up to 3 example messages }>, severityCounts: { critical: number; error: number; warning: number; info: number; }, recommendations: string[]; // Actionable debugging recommendations summary: { totalLogs: number; uniquePatterns: number; timeRange: string; } }
The tool normalizes error messages to group similar errors:
[PATH][UUID][ID][TIMESTAMP][URL][IP][LINE][NUM]Example:
"Error in /app/user.service.ts:45 for user ID 12345"
→ "Error in [PATH]:[LINE] for user ID [ID]"
MIT
Downloads/month
38
Quality Score