مرجع پیغام خطا

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید .
اطلاعات

این صفحه حاوی پیوندهایی به کتابچه‌های راهنمای عیب‌یابی برای خطاها و سایر مشکلاتی است که ممکن است هنگام استفاده از Apigee Edge با آنها مواجه شوید. هر کتابچه راهنمای عیب‌یابی نحوه تشخیص و حل هر نوع مشکل را توضیح می‌دهد.

مشکلات تحلیلی

این مباحث نحوه عیب‌یابی مواردی را توضیح می‌دهند که داده‌های تحلیلی در داشبوردهای تحلیلی یا گزارش‌های سفارشی نمایش داده نمی‌شوند.

پیام خطا یا توضیحات دفترچه راهنما
The report timed out: Try again with a smaller date range or a larger aggregation interval.

گزارش‌های تحلیلی به پایان زمان خود رسیده‌اند

یا:

زمان گزارش تمام شد

ممکن است هیچ پیام خطایی مشاهده نکنید، مگر اینکه فضای دیسک روی سرور Postgres کاملاً پر شده باشد. فضای دیسک سرور Postgres رو به اتمام است
هیچ خطایی مشاهده نمی‌شود. متغیر سفارشی برای گزارش‌های سفارشی تحلیلی قابل مشاهده نیست
No traffic in the selected date range داده‌ها در داشبوردهای تحلیلی نمایش داده نمی‌شوند
این موضوع توضیح می‌دهد که چگونه یک کار متداول درخواستی را انجام دهید. افزودن و حذف اجزای تحلیلی در گروه‌های تحلیلی
Could not get data for path ابعاد سفارشی هنگام پیکربندی چندین گروه محوری نمایش داده نمی‌شوند

خطاهای استقرار

استقرار پروکسی‌های API ممکن است به دلایل مختلفی مانند مشکلات اتصال شبکه بین سرورهای Edge، مشکلات مربوط به پایگاه داده Cassandra، استثنائات ZooKeeper و خطاهای موجود در بسته پروکسی API با شکست مواجه شود. این بخش اطلاعات و راهنمایی‌هایی در مورد برخی از رویه‌های خاص که می‌توان برای عیب‌یابی خطاهای استقرار دنبال کرد، ارائه می‌دهد.
پیام خطا یا توضیحات دفترچه راهنما
Error: Call timed out; either server is down or server is not reachable خطای تایم اوت
Unexpected error Error while fetching children for path خطا در واکشی فرزندان برای مسیر
Error while accessing datastore;Please retry later خطا در دسترسی به پایگاه داده
Configuration failed, associated contexts = [] پیکربندی ناموفق بود
Unexpected error occurred while processing the updates, associated contexts = [] خطا در پردازش به‌روزرسانی‌ها

خطاهای پورتال توسعه‌دهندگان

این مباحث به شما در مورد مشکلاتی که ممکن است هنگام استفاده از پورتال توسعه‌دهندگان با آنها مواجه شوید، کمک می‌کنند. قبل از تلاش برای رفع مشکلات پورتال توسعه‌دهندگان، مطمئن شوید که درک اولیه‌ای از نحوه کار پورتال توسعه‌دهندگان دارید، همانطور که در «مروری بر عیب‌یابی پورتال توسعه‌دهندگان» توضیح داده شده است.
پیام خطا یا توضیحات دفترچه راهنما
An internal error has occurred. Please retry your request. خطای داخلی پورتال توسعه‌دهندگان
The website encountered an unexpected error. Please try again later. یا There was an error trying to create the App. Please try again later. مشکلات ارتباطی پورتال توسعه‌دهندگان

مشکلات کسب درآمد

مباحث زیر به شما کمک می‌کند تا مشکلات رایج کسب درآمد را عیب‌یابی و برطرف کنید.

پیام خطا یا توضیحات دفترچه راهنما
<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>
توسعه‌دهنده معلق شد
ممکن است هیچ پیام خطایی مشاهده نکنید، اما مشکلاتی را مشاهده خواهید کرد که در بخش «علائم» در «مشکلات راه‌اندازی کسب درآمد» توضیح داده شده است. مشکلات راه‌اندازی کسب درآمد

مشکلات روتر لبه

روتر Edge با NGINX پیاده‌سازی شده است. در طول فرآیند ارتقاء Edge یا هنگام تغییر پیکربندی روتر، ممکن است خطاهای پیکربندی NGINX را مشاهده کنید. موضوع زیر به شما در رفع چنین مشکلاتی کمک خواهد کرد.

پیام خطا یا توضیحات دفترچه راهنما
هیچ پیام خطایی مشاهده نخواهید کرد. با این حال، ممکن است به دلیل فایل‌های پیکربندی نامناسب، نتوانید پروکسی‌های API خود را اجرا کنید. فایل‌های پیکربندی نامناسب
429 Too Many Requests: Tuning Nginx Router connection limits 429 درخواست‌های بیش از حد

مشکلات OpenLDAP

مباحث زیر به شما در عیب‌یابی و رفع مشکلات رایج OpenLDAP کمک می‌کند.

پیام خطا یا توضیحات دفترچه راهنما
Unknown username and password combination. SMTP غیرفعال است و کاربران باید رمز عبور را دوباره تنظیم کنند
هیچ خطایی ظاهر نمی‌شود، رابط کاربری Edge به سادگی لیست کاربرانی را که باید در تمام سرورهای OpenLDAP تکثیر می‌شدند، نشان نمی‌دهد. LDAP تکثیر نمی‌شود.
SLAPD Dead But Pid File Exists قادر به شروع OpenLDAP نیست
Unknown username and password combination. خرابی داده‌های OpenLDAP

خطاهای زمان اجرا

مباحث زیر به شما در عیب‌یابی و رفع مشکلات رایج زمان اجرا کمک می‌کند.

پیام خطا یا توضیحات دفترچه راهنما
HTTP/1.1 500 Internal Server Error یا
{
   "fault":{
      "detail":{
         "errorcode":"steps.servicecallout.ExecutionFailed"
      },
      "faultstring":"Execution of ServiceCallout callWCSAuthServiceCallout failed.
        Reason: ResponseCode 400 is treated as error"
   }
}


خطای داخلی سرور ۵۰۰
HTTP/1.1 502 Bad Gateway یا
{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget"
       }
    }
}
۵۰۲ دروازه بد
HTTP/1.1 503 Service Unavailable یا HTTP/1.1 503 Service Unavailable: Back-end server is at capacity یا
{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
       }
    }
}
سرویس ۵۰۳ در دسترس نیست
HTTP/1.1 503 Service Unavailable یا Received fatal alert: handshake_failure خطاهای SSL Handshake
HTTP/1.1 503 Service Unavailable یا
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
خطاهای SSL Handshake - گواهی کلاینت نامناسب
HTTP/1.1 504 Gateway Timeout یا
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}


زمان انقضای دروازه ۵۰۴

مشکلات مربوط به متصدی باغ وحش

مباحث زیر به شما در عیب‌یابی و رفع مشکلات رایج Zookeeper کمک می‌کند.
پیام خطا یا توضیحات دفترچه راهنما
org: env: main ERROR ZOOKEEPER - ZooKeeperServiceImpl.exists() : Could not detect existence of path: /regions/dc-1/pods/analytics/servers/abc123/reachable , reason: KeeperErrorCode = ConnectionLoss

یا

org.apache.zookeeper.KeeperException$ConnectionLossException: KeeperErrorCode = ConnectionLoss

یا

رابط کاربری Edge ممکن است این خطا را نمایش دهد:

Error Fetching Deployments Error while checking path existence for path: path
خطاهای قطع اتصال در Zookeeper
مشکلات مربوط به داده‌ها، که معمولاً به عنوان مشکلات سیم‌کشی شناخته می‌شوند، می‌توانند به عنوان یکی از چندین مشکل ظاهر شوند. برای جزئیات بیشتر به بخش مشکلات داده‌های Zookeeper مراجعه کنید. مشکلات داده‌های زوکیپر
+ apigee-service apigee-zookeeper status apigee-service: apigee-zookeeper: Not running (DEAD) apigee-all: Error: status failed on [apigee-zookeeper] قادر به شروع Zookeeper نیستیم

ابزارهای تشخیصی و گزارش‌ها

این مباحث ابزارها و گزارش‌هایی را شرح می‌دهند که می‌توانید برای تشخیص انواع خاصی از مشکلاتی که ممکن است هنگام استفاده از Apigee Edge با آنها مواجه شوید، استفاده کنید.

  • ابزار شنود بسته‌های TCP/IP (tcpdump)
    ابزار tcpdump یک ابزار شنود بسته‌های اطلاعاتی تحت خط فرمان است که به شما امکان می‌دهد بسته‌های اطلاعاتی TCP/IP که از طریق شبکه دریافت یا منتقل می‌شوند را ضبط یا فیلتر کنید.
  • هیپ دامپ‌ها
    داده‌های هیپ (Heap dumps) تصویری لحظه‌ای از حافظه‌ی یک فرآیند جاوا هستند. آن‌ها حاوی اطلاعات مربوط به اشیاء و کلاس‌های جاوا در هیپ در لحظه‌ی جمع‌آوری داده‌های هیپ هستند.
  • تخلیه نخ‌ها
    یک dump از thread، تصویری لحظه‌ای از وضعیت تمام threadهای یک فرآیند جاوای در حال اجرا است. وضعیت هر thread به همراه محتوای پشته آن نمایش داده می‌شود که به آن stack trace گفته می‌شود.