Comprehensive guidance for appropriate use of logging in API routes to maintain clean, useful, and performant logs.
| ERROR | Unexpected failures requiring attention | Database connection failures, unhandled exceptions, critical service errors | | WARN | Recoverable issues or concerning patterns | Rate limiting triggered, deprecated API usage, fallback behavior activated |
| INFO | Important business events (NOT routine operations) | User account created, payment processed, critical configuration changed | | DEBUG | Detailed diagnostic information | Query parameters, intermediate calculations, cache hit/miss details |
أفضل الممارسات والإرشادات لاستخدام المسجل في مسارات واجهة برمجة التطبيقات. يحدد مستويات التسجيل المناسبة، وما يجب تسجيله، ومتى يجب تجنب التسجيل. يُستخدم عند تنفيذ أو مراجعة تسجيل مسار واجهة برمجة التطبيقات (API)، أو إستراتيجيات تصحيح الأخطاء، أو تحسين مخرجات السجل. المصدر: inkeep/agents.