تحديد وحلّ المشاكل المتعلقة بنشر سياسة تسجيل الرسائل

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

InvalidProtocol

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم 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.

مثال للقطة شاشة

السبب

يمكن أن يتعذّر نشر سياسة MessageLogging مع ظهور هذا الخطأ إذا كان البروتوكول المحدَّد داخل العنصر <Protocol> غير صالح. البروتوكولات الصالحة هي TCP وUDP. لإرسال رسائل سجل النظام عبر TLS/SSL، لا يتم دعم سوى بروتوكول TCP.

على سبيل المثال، يفشل نشر الخادم الوكيل لواجهة برمجة التطبيقات ويظهر هذا الخطأ في حال تحديد HTTP في العنصر <Protocol> في سياسة MessageLogging على النحو الموضَّح أدناه:

<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> غير صالح، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات مع ظهور الخطأ التالي:

    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

رسالة الخطأ

يتعذّر نشر خادم وكيل لواجهة برمجة التطبيقات من خلال واجهة مستخدم 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.

مثال للقطة شاشة

السبب

قد يتعذّر نشر سياسة MessageLogging مع ظهور هذا الخطأ، إذا لم يتم تحديد رقم المنفذ داخل العنصر <Port> أو إذا كان غير صالح. يجب أن يكون رقم المنفذ عددًا صحيحًا أكبر من صفر.

على سبيل المثال، إذا تم الإعلان عن العنصر <Port> كما هو موضّح أدناه، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات:

<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> غير صالح، سيتعذّر نشر الخادم الوكيل لواجهة برمجة التطبيقات ويعرض الخطأ التالي:

    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>