訊息記錄政策部署錯誤疑難排解

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊

InvalidProtocol

錯誤訊息

無法透過 Edge UI 或 Edge Management API 部署 API Proxy，並顯示以下錯誤訊息：

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 政策政策可能會部署失敗。有效的通訊協定為 TCP 和 UDP。如果是透過 TLS/SSL 傳送系統記錄訊息，則僅支援 TCP。

舉例來說，如果您在 MessageLogging 政策的 <Protocol> 元素中指定 HTTP，則 API Proxy 的部署作業會失敗並發生此錯誤，如下所示：

<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 Proxy 部署作業會失敗，並顯示以下錯誤：

    Invalid Protocol: HTTP for Syslog handler in policy LogToSyslog.

解析度

確保 MessageLogging 政策的 <Protocol> 元素中定義的通訊協定有效。<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 UI 或 Edge Management API 部署 API Proxy，並顯示以下錯誤訊息：

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 Proxy 的部署作業就會失敗：

<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 Proxy 部署作業會失敗並顯示以下錯誤：

    Invalid Port: 0 for Syslog handler in policy LogToSyslog.

解析度

確保已在 MessageLogging 政策的 <Port> 元素中定義通訊埠號碼。必須為大於零的整數。

如要修正上述範例，請在 <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>