Troubleshooting

ಏನಾದರೂ ಕೆಲಸ ಮಾಡದಿದ್ದಾಗ ಇಲ್ಲಿಂದ ಪ್ರಾರಂಭಿಸಿ. Steps ಅನ್ನು ಕ್ರಮದಲ್ಲಿ ಅನುಸರಿಸಿ.

First Steps

1. Daemon ಚಲಿಸುತ್ತಿದೆಯೇ ಎಂದು Check ಮಾಡಿ

triggerfish status

Daemon ಚಲಿಸುತ್ತಿಲ್ಲದಿದ್ದರೆ, start ಮಾಡಿ:

triggerfish start

2. Logs Check ಮಾಡಿ

triggerfish logs

ಇದು real time ನಲ್ಲಿ log file tail ಮಾಡುತ್ತದೆ. Noise ಕಡಿಮೆ ಮಾಡಲು level filter ಬಳಸಿ:

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

3. Diagnostics ಚಲಾಯಿಸಿ

triggerfish patrol

Patrol gateway reachable ಇದೆಯೇ, LLM provider respond ಮಾಡುತ್ತದೆಯೇ, channels connected ಆಗಿವೆಯೇ, policy rules load ಆಗಿವೆಯೇ, ಮತ್ತು skills discovered ಆಗಿವೆಯೇ ಎಂದು check ಮಾಡುತ್ತದೆ. CRITICAL ಅಥವಾ WARNING ಎಂದು mark ಆದ check ಎಲ್ಲಿ focus ಮಾಡಬೇಕು ಎಂದು ತಿಳಿಸುತ್ತದೆ.

4. ನಿಮ್ಮ Config Validate ಮಾಡಿ

triggerfish config validate

ಇದು triggerfish.yaml parse ಮಾಡಿ, required fields check ಮಾಡಿ, classification levels validate ಮಾಡಿ, ಮತ್ತು secret references resolve ಮಾಡುತ್ತದೆ.

Area ಮೂಲಕ Troubleshooting

ಮೇಲಿನ first steps ಸಮಸ್ಯೆ ಕಾಣಿಸಲಿಲ್ಲವೆಂದರೆ, ನಿಮ್ಮ 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 ಕಂಡುಹಿಡಿಯಲಾಗಲಿಲ್ಲ, launch failures, navigation blocked
• Security & Classification - write-down blocks, taint issues, SSRF, policy denials
• Secrets & Credentials - keychain errors, encrypted file store, permission problems

ಇನ್ನೂ ಸಮಸ್ಯೆ ಇದೆಯೇ?

ಮೇಲಿನ guides ಯಾವೂ ನಿಮ್ಮ issue resolve ಮಾಡದಿದ್ದರೆ:

1. Log bundle collect ಮಾಡಿ
2. Filing issues guide ಓದಿ
3. GitHub ನಲ್ಲಿ issue open ಮಾಡಿ