عیب‌یابی خطای استقرار خط‌مشی «گزارش‌گیری پیام»

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

InvalidProtocol

پیام خطا

استقرار کارگزار پروکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

Error Saving Revision revision_number
Invalid Protocol: invalid_protocol for Syslog handler in policy policy_name.

پیام خطای نمونه

Error Saving Revision 4
Invalid Protocol: HTTP for Syslog handler in policy LogToSyslog.

نماگرفت نمونه

علت

اگر پروتکل مشخص‌شده در عنصر <Protocol> معتبر نباشد، استقرار خط‌مشی MessageLogging policy ممکن است با این خطا مواجه شود. پروتکل‌های معتبر عبارت‌اند از TCP و UDP. برای ارسال پیام‌های syslog ازطریق TLS/SSL، فقط از TCP پشتیبانی می‌شود.

برای مثال، اگر HTTP را در عنصر <Protocol> «خط‌مشی MessageLogging» مشخص کنید، همان‌طور که در زیر نشان داده شده است، استقرار «پراکسی API» با این خطا ناموفق خواهد بود:

<Protocol>HTTP</Protocol>

تشخیص

  1. خط‌مشی MessageLogging را که خطا در آن رخ داده است شناسایی کنید. می‌توانید این اطلاعات را در پیام خطا پیدا کنید. برای مثال، در خطای زیر، نام خط‌مشی LogToSyslog: است

    Invalid Protocol: HTTP for Syslog handler in policy LogToSyslog.
    
  2. در پیکربندی خط‌مشی MessageLogging ناموفق، بررسی کنید که آیا پروتکل مشخص‌شده در عنصر <Protocol> معتبر است یا خیر. اگر پروتکل نامعتبری مشخص شده باشد، دلیل خطا همین است.

    برای مثال، خط‌مشی زیر پروتکل نامعتبری را مشخص می‌کند.

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <MessageLogging name="LogToSyslog">
      <Syslog>
        <Message>[3f509b58 tag="{organization.name}.{apiproxy.name}.{environment.name}"] Weather request for WOEID {request.queryparam.w}.</Message>
        <Host>logs-01.loggly.com</Host>
        <Port>514</Port>
        <Protocol>HTTP</Protocol>
        <FormatMessage>true</FormatMessage>
      </Syslog>
      <logLevel>ALERT</logLevel>
    </MessageLogging>
    

    ازآنجایی‌که پروتکل تعریف‌شده در عنصر <Protocol> نامعتبر است، استقرار «پراکسی API» با این خطا ناموفق است:

    Invalid Protocol: HTTP for Syslog handler in policy LogToSyslog.
    

وضوح

مطمئن شوید که پروتکل تعریف‌شده در عنصر <Protocol> خط‌مشی MessageLogging معتبر باشد. عنصر <Protocol> از مقادیر زیر پشتیبانی می‌کند:

  • TCP
  • UDP

برای اصلاح کردن نمونه نشان‌داده‌شده در بالا، پروتکل معتبری را در عنصر <Protocol> تعریف کنید:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageLogging name="LogToSyslog">
  <Syslog>
    <Message>[3f509b58 tag="{organization.name}.{apiproxy.name}.{environment.name}"] Weather request for WOEID {request.queryparam.w}.</Message>
    <Host>logs-01.loggly.com</Host>
    <Port>514</Port>
    <Protocol>TCP</Protocol>
    <FormatMessage>true</FormatMessage>
  </Syslog>
  <logLevel>ALERT</logLevel>
</MessageLogging>

InvalidPort

پیام خطا

استقرار کارگزار پروکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

Error Saving Revision revision_number
Invalid Port: 0 for Syslog handler in policy policy_name.

پیام خطای نمونه

Error Saving Revision 4
Invalid Port: 0 for Syslog handler in policy LogToSyslog.

نماگرفت نمونه

علت

اگر شماره درگاه در عنصر <Port> مشخص نشده باشد یا معتبر نباشد، استقرار خط‌مشی MessageLogging می‌تواند با این خطا ناموفق باشد. شماره درگاه باید عدد صحیحی بزرگ‌تر از صفر باشد.

برای مثال، اگر عنصر <Port> همان‌طور که در زیر نشان داده شده است اعلام شود، استقرار پراکسی API ناموفق خواهد بود:

<Port>0</Port>

تشخیص

  1. خط‌مشی MessageLogging را که خطا در آن رخ داده است شناسایی کنید. می‌توانید این اطلاعات را از پیام خطا پیدا کنید. برای مثال، در خطای زیر، نام خط‌مشی LogToSyslog: است

    Invalid Port: 0 for Syslog handler in policy LogToSyslog.
    
  2. در خط‌مشی MessageLogging ناموفق، بررسی کنید که آیا شماره درگاه معتبری در عنصر <Port> مشخص شده است یا نه. اگر شماره درگاه تعریف نشده باشد یا نامعتبر باشد، این دلیل خطا است.

    برای مثال، خط‌مشی زیر شماره درگاه نامعتبری را مشخص می‌کند:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <MessageLogging name="LogToSyslog">
      <Syslog>
        <Message>[3f509b58 tag="{organization.name}.{apiproxy.name}.{environment.name}"] Weather request for WOEID {request.queryparam.w}.</Message>
        <Host>logs-01.loggly.com</Host>
        <Port>0</Port>
        <Protocol>TCP</Protocol>
        <FormatMessage>true</FormatMessage>
      </Syslog>
      <logLevel>ALERT</logLevel>
    </MessageLogging>
    

    چون شماره درگاه تعریف‌شده در عنصر <Port> نامعتبر است، استقرار «پراکسی API» با این خطا ناموفق است:

    Invalid Port: 0 for Syslog handler in policy LogToSyslog.
    

وضوح

مطمئن شوید که شماره درگاهی در عنصر <Port> خط‌مشی MessageLogging تعریف شده باشد. باید عدد صحیحی بزرگ‌تر از صفر باشد.

برای اصلاح کردن نمونه نشان‌داده‌شده در بالا، شماره درگاه معتبری را در عنصر <Protocol> تعریف کنید.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageLogging name="LogToSyslog">
  <Syslog>
    <Message>[3f509b58 tag="{organization.name}.{apiproxy.name}.{environment.name}"] Weather request for WOEID {request.queryparam.w}.</Message>
    <Host>logs-01.loggly.com</Host>
    <Port>514</Port>
    <Protocol>TCP</Protocol>
    <FormatMessage>true</FormatMessage>
  </Syslog>
  <logLevel>ALERT</logLevel>
</MessageLogging>