مرجع پیام خطا

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

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

مشکلات Analytics

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

پیام یا شرح خطا Playbook
The report timed out: Try again with a smaller date range or a larger aggregation interval.

گزارش‌های Analytics زمان‌بندی‌شان تمام شد

یا:

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

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

استقرار پراکسی‌های API ممکن است به‌دلایل مختلفی مانند مشکلات اتصال شبکه بین سرورهای Edge، مشکلات مربوط به فروشگاه داده Cassandra، استثنائات ZooKeeper، و خطاهای موجود در بسته پراکسی API با شکست مواجه شود. این بخش اطلاعات و راهنمایی‌هایی درباره برخی‌از رویه‌های خاص ارائه می‌دهد که می‌توان برای عیب‌یابی خطاهای استقرار دنبال کرد.
پیام یا شرح خطا Playbook
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 خطا دسترسی به Datastore
Configuration failed, associated contexts = [] پیکربندی ناموفق بود
Unexpected error occurred while processing the updates, associated contexts = [] خطا به‌روزرسانی‌های پردازش

خطاهای «درگاه توسعه‌دهندگان»

این موضوعات به شما در حل مشکلاتی که ممکن است هنگام استفاده از درگاه توسعه‌دهندگان با آن‌ها مواجه شوید، کمک می‌کنند. قبل‌از تلاش برای رفع مشکلات درگاه توسعه‌دهندگان، مطمئن شوید که درک اولیه‌ای از نحوه عملکرد درگاه توسعه‌دهندگان دارید، همان‌طور که در نمای کلی عیب‌یابی درگاه توسعه‌دهندگان توضیح داده شده است.
پیام یا شرح خطا Playbook
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. مشکلات ارتباطی درگاه توسعه‌دهندگان

مشکلات درآمدزایی

موضوعات زیر به شما کمک می‌کند مشکلات رایج «درآمدزایی» را عیب‌یابی و برطرف کنید.

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

مشکلات «رهیاب لبه»

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

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

مشکلات OpenLDAP

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

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

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

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

پیام یا شرح خطا Playbook
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"
       }
    }
}
‫503 سرویس دردسترس نیست
HTTP/1.1 503 Service Unavailable یا Received fatal alert: handshake_failure SSL Handshake Failures
HTTP/1.1 503 Service Unavailable یا 
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
SSL Handshake Failures - Bad Client Certificate
HTTP/1.1 504 Gateway Timeout یا 
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}
‫504 Gateway Timeout (پایان مهلت زمانی دروازه ۵۰۴)

مشکلات باغ‌وحش

موضوعات زیر به شما کمک می‌کند مشکلات رایج Zookeeper را عیب‌یابی و برطرف کنید.
پیام یا شرح خطا Playbook
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 را ببینید. 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 را که ازطریق شبکه دریافت یا منتقل می‌شوند ضبط یا فیلتر کنید.
  • رونوشت‌های پشته
    رونوشت‌های پشته تصویری فوری از حافظه فرایند جاوا است. این فایل‌ها حاوی اطلاعاتی درباره کلاس‌ها و اشیای Java در پشته در لحظه جمع‌آوری پشته‌گردان هستند.
  • Thread dumps
    دُمپ رشته‌ای عبارت است از تصویری فوری از وضعیت همه رشته‌های فرایند Java درحال اجرا. وضعیت هر رشته با محتوای پشته آن ارائه می‌شود که به آن ردیابی پشته می‌گویند.