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

أنت تعرض مستندات 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. حدِّد سياسة تسجيل الرسائل التي حدث فيها الخطأ. يمكنك العثور على هذه المعلومات في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم السياسة هو 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. حدِّد سياسة تسجيل الرسائل التي حدث فيها الخطأ. يمكنك العثور على هذه المعلومات في رسالة الخطأ. على سبيل المثال، في الخطأ التالي، يكون اسم السياسة هو LogToSyslog:

    Invalid Port: 0 for Syslog handler in policy LogToSyslog.
    
  2. في سياسة MessageLog التي تعذّر تنفيذها، تحقَّق مما إذا تم تحديد رقم منفذ صالح داخل العنصر <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>