Troubleshooting

ஏதாவது வேலை செய்யாதபோது இங்கே தொடங்கவும். Steps ஐ order இல் பின்பற்றவும்.

முதல் Steps

1. Daemon இயங்குகிறதா என்று சரிபார்க்கவும்

triggerfish status

Daemon இயங்காவிட்டால், start செய்யவும்:

triggerfish start

2. Logs சரிபார்க்கவும்

triggerfish logs

இது log file ஐ real time இல் tail செய்கிறது. Noise குறைக்க level filter பயன்படுத்தவும்:

triggerfish logs --level ERROR
triggerfish logs --level WARN

3. Diagnostics இயக்கவும்

triggerfish patrol

Gateway reachable ஆ, LLM provider respond செய்கிறதா, channels connected ஆ, policy rules loaded ஆ, மற்றும் skills discovered ஆ என்று Patrol சரிபார்க்கிறது. CRITICAL அல்லது WARNING marked check எங்கே focus செய்வது என்று சொல்கிறது.

4. Config validate செய்யவும்

triggerfish config validate

இது triggerfish.yaml parse செய்கிறது, required fields சரிபார்க்கிறது, classification levels validate செய்கிறது, மற்றும் secret references resolve செய்கிறது.

Area அடிப்படையில் Troubleshooting

மேலே உள்ள first steps problem point out செய்யவில்லையென்றால், உங்கள் symptoms match ஆகும் area தேர்ந்தெடுக்கவும்:

• Installation - install script failures, build-from-source issues, platform problems
• Daemon - service start ஆகாது, port conflicts, "already running" errors
• Configuration - YAML parse errors, missing fields, secret resolution failures
• Channels - bot respond செய்வதில்லை, auth failures, message delivery issues
• LLM Providers - API errors, model not found, streaming failures
• Integrations - Google OAuth, GitHub PAT, Notion API, CalDAV, MCP servers
• Browser Automation - Chrome not found, launch failures, navigation blocked
• Security & Classification - write-down blocks, taint issues, SSRF, policy denials
• Secrets & Credentials - keychain errors, encrypted file store, permission problems

இன்னும் Stuck ஆ?

மேலே உள்ள guides உங்கள் issue resolve செய்யவில்லையென்றால்:

1. Log bundle collect செய்யவும்
2. Filing issues guide படிக்கவும்
3. GitHub இல் issue open செய்யவும்