Khắc phục sự cố khi triển khai chính sách Ghi nhật ký thư

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

InvalidProtocol

Thông báo lỗi

Việc triển khai một proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge không thành công và bạn nhận được thông báo lỗi sau:

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

Thông báo lỗi mẫu

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

Ảnh chụp màn hình ví dụ

Nguyên nhân

Việc triển khai chính sách MessageLogging có thể không thành công với lỗi này nếu giao thức được chỉ định trong phần tử <Protocol> không hợp lệ. Các giao thức hợp lệ là TCP và UDP. Để gửi thông báo syslog qua TLS/SSL, chỉ có TCP được hỗ trợ.

Ví dụ: việc triển khai API Proxy sẽ không thành công do lỗi này nếu bạn chỉ định HTTP trong phần tử <Protocol> của Chính sách MessageLogging như minh hoạ dưới đây:

<Protocol>HTTP</Protocol>

Chẩn đoán

1. Xác định chính sách MessageLogging nơi xảy ra lỗi. Bạn có thể tìm thấy thông tin này trong thông báo lỗi. Ví dụ: trong lỗi sau, tên chính sách là LogToSyslog:

   Invalid Protocol: HTTP for Syslog handler in policy LogToSyslog.
   

2. Trong quá trình kiểm tra cấu hình chính sách MessageLogging không thành công, hãy kiểm tra xem giao thức được chỉ định trong phần tử <Protocol> có hợp lệ hay không. Nếu bạn chỉ định một giao thức không hợp lệ, thì đó là nguyên nhân gây ra lỗi.

   Ví dụ: chính sách sau đây chỉ định một giao thức không hợp lệ.

   <?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>
   

   Vì giao thức được xác định trong phần tử <Protocol> không hợp lệ, nên việc triển khai API Proxy không thành công và gặp lỗi:

   Invalid Protocol: HTTP for Syslog handler in policy LogToSyslog.
   

Độ phân giải

Đảm bảo rằng giao thức được xác định trong phần tử <Protocol> của chính sách MessageLogging là hợp lệ. Phần tử <Protocol> hỗ trợ các giá trị sau:

• TCP
• UDP

Để sửa ví dụ nêu trên, hãy xác định một giao thức hợp lệ trong phần tử <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

Thông báo lỗi

Việc triển khai một proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge không thành công và bạn nhận được thông báo lỗi sau:

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

Thông báo lỗi mẫu

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

Ảnh chụp màn hình ví dụ

Nguyên nhân

Việc triển khai chính sách MessageLogging có thể không thành công với lỗi này nếu bạn không chỉ định số cổng trong phần tử <Port> hoặc nếu số cổng không hợp lệ. Số cổng phải là một số nguyên lớn hơn 0.

Ví dụ: nếu phần tử <Port> được khai báo như minh hoạ dưới đây, thì việc triển khai proxy API sẽ không thành công:

<Port>0</Port>

Chẩn đoán

1. Xác định chính sách MessageLogging nơi xảy ra lỗi. Bạn có thể tìm thấy thông tin này trong thông báo lỗi. Ví dụ: trong lỗi sau, tên chính sách là LogToSyslog:

   Invalid Port: 0 for Syslog handler in policy LogToSyslog.
   

2. Trong quá trình kiểm tra chính sách MessageLogging không thành công, nếu bạn chỉ định một số cổng hợp lệ trong phần tử <Port>. Nếu số cổng không được xác định hoặc không hợp lệ, thì đó là nguyên nhân gây ra lỗi.

   Ví dụ: chính sách sau đây chỉ định một số cổng không hợp lệ:

   <?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>
   

   Vì số cổng được xác định trong phần tử <Port> không hợp lệ, nên việc triển khai API Proxy sẽ không thành công và gặp lỗi:

   Invalid Port: 0 for Syslog handler in policy LogToSyslog.
   

Độ phân giải

Đảm bảo rằng số cổng được xác định trong phần tử <Port> của chính sách MessageLogging. Đó phải là một số nguyên lớn hơn 0.

Để sửa ví dụ nêu trên, hãy xác định một số cổng hợp lệ trong phần tử <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>