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

您正在查看 Apigee 和 Apigee Hybrid 說明文件。
查看 Apigee Edge 說明文件。

InvalidProtocol

錯誤訊息

透過 Apigee UI 或 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.

螢幕截圖範例

儲存修訂版本 4 時發生錯誤。

原因

如果 <Protocol> 元素中指定的通訊協定無效，MessageLogging 政策的部署作業可能會失敗並顯示這項錯誤。有效的通訊協定為 TCP 和 UDP。如要透過 TLS/SSL 傳送 Syslog 訊息，則僅支援 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

錯誤訊息

透過 Apigee UI 或 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.

螢幕截圖範例

儲存修訂版本 4 時發生錯誤。

原因

如果 <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>