Các phương pháp hay nhất dành cho yêu cầu hỗ trợ của Google Cloud Apigee

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến Tài liệu về Apigee X. thông tin

Bạn đang xem tài liệu về Apigee X.
Xem Tài liệu về Apigee Edge.

Việc cung cấp thông tin chi tiết và bắt buộc trong yêu cầu hỗ trợ sẽ giúp Nhóm hỗ trợ Google Cloud Apigee có thể trả lời bạn một cách nhanh chóng và hiệu quả. Trường hợp bạn hỗ trợ trường hợp thiếu thông tin quan trọng, chúng tôi sẽ cần yêu cầu thêm thông tin, có thể bao gồm việc qua lại nhiều lần. Việc này mất nhiều thời gian hơn và có thể khiến quá trình giải quyết vấn đề bị chậm trễ. Hướng dẫn về các phương pháp hay nhất này cung cấp cho bạn thông tin mà chúng tôi cần để giải quyết các vấn đề về kỹ thuật yêu cầu hỗ trợ nhanh hơn.

Mô tả vấn đề

Vấn đề phải chứa thông tin giải thích chi tiết về những gì đã xảy ra so với những gì đã xảy ra dự kiến sẽ xảy ra cũng như thời điểm và cách thức tình huống đó xảy ra. Bạn nên thiết lập một nhóm hỗ trợ hiệu quả cho Apigee chứa những thông tin quan trọng sau đây cho từng sản phẩm Apigee:

Thông tin quan trọng Mô tả Apigee Edge cho Đám mây công cộng Apigee Edge cho Đám mây riêng tư
Sản phẩm Sản phẩm Apigee cụ thể đang gặp vấn đề, bao gồm cả phiên bản nếu có.
  • Phiên bản
Thông tin chi tiết về vấn đề Nội dung mô tả rõ ràng và chi tiết về vấn đề, bao gồm cả thông tin đầy đủ (nếu có).
  • Thông báo lỗi
  • Kết quả đầu ra của công cụ theo dõi
  • Các bước tái hiện vấn đề
  • Hoàn tất yêu cầu/lệnh API
  • Thông báo lỗi
  • Kết quả đầu ra của công cụ theo dõi
  • Các bước tái hiện vấn đề
  • Hoàn tất yêu cầu/lệnh API
  • Nhật ký chẩn đoán thành phần
Thời gian Dấu thời gian cụ thể khi vấn đề bắt đầu và kéo dài trong bao lâu.
  • Ngày, giờ và múi giờ xảy ra sự cố
  • Thời lượng của sự cố
  • Ngày, giờ và múi giờ xảy ra sự cố
  • Thời lượng của sự cố
Thiết lập Thông tin chi tiết về nơi phát hiện vấn đề.
  • Tên tổ chức
  • Tên môi trường
  • Tên proxy API
  • Bản sửa đổi
  • Cấu trúc liên kết mạng
  • Thành phần cạnh không hoạt động

Các phần sau đây sẽ mô tả chi tiết hơn về những khái niệm này.

Sản phẩm

Có nhiều sản phẩm Apigee, Apigee Edge trên Public Cloud và Apigee Edge trên nền tảng đám mây riêng tư, nên chúng tôi cần thông tin cụ thể thông tin về sản phẩm cụ thể nào đang gặp sự cố.

Bảng sau đây cung cấp một số ví dụ trình bày đầy đủ thông tin trong cột DO và thông tin không đầy đủ trong Cột KHÔNG NÊN:

Việc nên làm KHÔNG NÊN
Không triển khai proxy API OAuth2 được trên tổ chức Public Cloud ...

Triển khai proxy API không thành công

(Chúng tôi cần biết sản phẩm Apigee mà bạn đang gặp vấn đề.)

Không cài đặt được kèm theo lỗi sau trên Edge Private Cloud phiên bản 4.50.00 ...

Không cài đặt được trong chế độ thiết lập Đám mây riêng tư của chúng tôi.

(Thiếu thông tin phiên bản)

Chi tiết vấn đề

Cung cấp thông tin chính xác về vấn đề đang gặp phải, bao gồm cả thông báo lỗi (nếu bất kỳ) cũng như hành vi dự kiến và thực tế quan sát được.

Bảng sau đây cung cấp một số ví dụ hiển thị đầy đủ thông tin trong cột DO, và thông tin không đầy đủ trong cột KHÔNG NÊN:

Việc nên làm KHÔNG NÊN

Proxy edgemicro mới edgemicro_auth không thành công với lỗi sau:

{"error":"missing_authorization","error_description":"Missing Authorization header"}

Proxy edgemicro mới được tạo hôm nay không hoạt động

(Tên proxy không xác định. Không rõ proxy có trả về lỗi hay không phản hồi không mong muốn.)

Khách hàng của chúng tôi gặp phải 500 lỗi với thông báo lỗi sau khi gửi yêu cầu tới proxy API:

{"fault":{"faultstring":"Execution of JSReadResponse failed with error: Javascript runtime error: \"TypeError: Cannot read property \"content\" from undefined. (JSReadResponse.js:23)","detail":{"errorcode":"steps.javascript.ScriptExecutionFailed"}}}

Khách hàng của chúng tôi gặp 500 Lỗi khi gửi yêu cầu proxy API.

(Việc chỉ truyền đạt 500 Lỗi không cung cấp đầy đủ thông tin để chúng tôi điều tra vấn đề này. Chúng ta cần biết thông báo lỗi và mã lỗi thực tế đang được quan sát).

Thời gian

Thời gian là một thông tin rất quan trọng. Kỹ sư hỗ trợ cần phải biết được khi bạn nhận thấy vấn đề này lần đầu tiên, vấn đề này kéo dài bao lâu và vấn đề có còn tiếp diễn hay không.

Kỹ sư hỗ trợ giải quyết vấn đề này có thể không theo múi giờ của bạn, vì vậy, các tuyên bố tương đối khiến cho việc chẩn đoán vấn đề trở nên khó khăn hơn. Do đó, bạn nên sử dụng Định dạng ISO 8601 cho ngày và giờ để cung cấp thông tin thời gian chính xác về thời điểm phát hiện thấy vấn đề.

Bảng sau đây cung cấp một số ví dụ thể hiện thời gian và khoảng thời gian chính xác mà vấn đề đã xảy ra trong cột DO và thông tin không rõ ràng về thời điểm đã xảy ra sự cố trong cột KHÔNG NÊN:

Việc nên làm KHÔNG NÊN
Quan sát thấy rất nhiều 503s được ghi nhận vào hôm qua trong khoảng thời gian từ 17:30 ngày 6/11/2020 theo Giờ ban ngày Thái Bình Dương (PDT) và 2020-11-06 17:35 PDT...

Chúng tôi đã quan sát thấy rất nhiều 503s vào lúc 5:30 chiều trong 5 phút hôm qua.

(Chúng tôi buộc phải sử dụng ngày được ngụ ý và cũng không rõ vấn đề này ở múi giờ nào quan sát thấy).

Độ trễ cao đã được quan sát thấy trên các proxy API sau từ 2020-11-09 15:30 IST đến 18:10 IST ...

Chúng tôi nhận thấy một số Proxy API có độ trễ cao vào tuần trước.

(Không rõ ngày và khoảng thời gian vấn đề này được quan sát thấy vào tuần trước.)

Thiết lập

Chúng tôi cần biết thông tin chi tiết về vị trí chính xác mà bạn gặp vấn đề. Tuỳ thuộc vào sản phẩm bạn đang sử dụng, chúng tôi cần những thông tin sau:

  • Nếu đang sử dụng Apigee Cloud, bạn có thể có nhiều tổ chức, vì vậy, chúng tôi cần để biết tổ chức cụ thể và các thông tin chi tiết khác nơi bạn đang phát hiện vấn đề:
    • Tên tổ chức và môi trường
    • Tên proxy API và số bản sửa đổi (đối với lỗi yêu cầu API)
  • Nếu đang dùng Đám mây riêng tư , bạn có thể đang dùng một trong nhiều tôi xin lỗi về việc cài đặt. Vì vậy, chúng tôi cần biết bạn đang sử dụng cấu trúc liên kết nào, bao gồm các chi tiết như số lượng trung tâm dữ liệu và nút.

Bảng sau đây cung cấp một số ví dụ hiển thị đầy đủ thông tin trong cột DO, và thông tin không đầy đủ trong cột KHÔNG NÊN:

Việc nên làm KHÔNG NÊN

401 Số lỗi đã tăng lên trên Edge Public Cloud kể từ 06/11/2020 09:30 CST.

Thông tin chi tiết về chế độ thiết lập chi tiết:

Sau đây là thông tin chi tiết về API không thành công:
Tên tổ chức: myorg
Tên môi trường: test
Tên proxy API: myproxy
Số bản sửa đổi: 3

Lỗi:

{"fault":{"faultstring":"Failed to resolve API Key variable request.header.X-APP-API_KEY","detail":{"errorcode":"steps.oauth.v2.FailedToResolveAPIKey"}}}

401 lỗi đã tăng lên.

(Bài viết này không cung cấp bất kỳ thông tin nào về sản phẩm đang được sử dụng, kể từ thời điểm vấn đề xảy ra ghi nhận được hoặc bất kỳ thông tin thiết lập nào).

Không thể khởi động Trình xử lý thư trên Edge Private Cloud phiên bản 4.19.06 sau thêm các nút cổng vào.

Nhật ký chẩn đoán:
Đã đính kèm nhật ký Trình xử lý thư.

Cấu trúc liên kết mạng:
Đã đính kèm tệp network-topology.png chứa các nút bổ sung.

Không thể khởi động Trình xử lý thư trên Edge Private Cloud phiên bản 4.19.06 sau thêm các nút cổng vào.

(Thiếu nhật ký trình xử lý thư và cấu trúc liên kết mạng.)

Cấu phần phần mềm hữu ích

Việc cung cấp cho chúng tôi các cấu phần phần mềm liên quan đến vấn đề sẽ giúp chúng tôi giải quyết nhanh hơn vì điều này sẽ giúp chúng tôi nắm được hành vi chính xác mà bạn đang quan sát và thu thập thêm thông tin chi tiết về hành vi đó.

Phần này mô tả một số cấu phần phần mềm hữu ích hữu ích cho tất cả các sản phẩm của Apigee:

Cấu phần phần mềm phổ biến cho tất cả sản phẩm Apigee

Các cấu phần phần mềm sau đây hữu ích cho tất cả các sản phẩm của Apigee: Apigee Edge trên Public Cloud và Apigee Edge trên Private Cloud:

Cấu phần phần mềm Mô tả
Kết quả của công cụ theo dõi Kết quả của công cụ Theo dõi chứa thông tin chi tiết về các yêu cầu API chuyển qua Sản phẩm của Apigee. Thông tin này rất hữu ích cho mọi lỗi thời gian chạy, chẳng hạn như 4XX, 5XX và vấn đề về độ trễ.
Ảnh chụp màn hình Ảnh chụp màn hình giúp chuyển tiếp ngữ cảnh của hành vi hoặc lỗi thực tế đang quan sát được. Đó là hữu ích cho mọi lỗi hoặc vấn đề được ghi nhận, chẳng hạn như trong giao diện người dùng hoặc Analytics.
HAR (Tệp ARchive http) HAR là một tệp được các công cụ phiên HTTP thu thập để gỡ lỗi mọi sự cố liên quan đến giao diện người dùng. Bạn có thể chụp ảnh bằng các trình duyệt như Chrome, Firefox hoặc Internet Explorer.
tcpdumps Công cụ tcpdump bắt các gói TCP/IP được chuyển hoặc nhận qua mạng. Điều này rất hữu ích đối với mọi sự cố liên quan đến mạng như lỗi bắt tay TLS, 502 lỗi và vấn đề về độ trễ, v.v.

Cấu phần phần mềm bổ sung cho Apigee Edge dành cho Cloud riêng tư

Đối với Apigee Edge cho Đám mây riêng tư, chúng tôi có thể cần thêm một số cấu phần phần mềm để hỗ trợ hoạt động nhanh hơn chẩn đoán vấn đề.

Cấu phần phần mềm Mô tả
Cấu trúc liên kết mạng Sơ đồ cấu trúc liên kết cài đặt Edge mô tả cách thiết lập Đám mây riêng tư của bạn, bao gồm tất cả các trung tâm dữ liệu, nút và thành phần được cài đặt trong mỗi nút.
Nhật ký chẩn đoán thành phần cạnh Nhật ký chẩn đoán liên quan đến thành phần Apigee Edge, chẳng hạn như Tin nhắn Bộ xử lý, Bộ định tuyến hoặc Cassandra.
Tệp cấu hình cài đặt Tệp cấu hình im lặng được dùng khi cài đặt hoặc nâng cấp Apigee Edge.

Tệp này rất hữu ích trong việc xác thực xem tất cả chế độ cài đặt có chính xác hay không trong trường hợp đã gặp phải sự cố cài đặt hoặc di chuyển.

Tệp báo lỗi Tệp báo lỗi là thông tin tổng quan nhanh về tiến trình bộ nhớ trong Java. Điều này rất hữu ích nếu bộ nhớ cao sử dụng hoặc lỗi OutOfMemory xuất hiện trên một số thành phần của Edge.
Tệp kết xuất luồng Tệp kết xuất luồng là thông tin tổng quan nhanh về tất cả các luồng của một quy trình Java đang chạy.

Điều này rất hữu ích nếu quan sát thấy mức CPU hoặc mức tải cao trên một số thành phần của Edge.

Mẫu trường hợp và trường hợp mẫu

Phần này cung cấp các mẫu trường hợp và trường hợp mẫu cho các sản phẩm khác nhau dựa trên các phương pháp hay nhất được mô tả trong tài liệu này:

Apigee Edge trên Đám mây công cộng

Mẫu

Phần này cung cấp một mẫu cho Apigee Edge trên Đám mây công cộng.

Vấn đề:

<Cung cấp mô tả chi tiết về vấn đề hoặc hành vi bạn quan sát được. Thêm tên và phiên bản sản phẩm (nếu có).>

Thông báo lỗi:

<Bao gồm thông báo lỗi hoàn chỉnh đã phát hiện được (nếu có)>

Thời gian bắt đầu sự cố (định dạng ISO 8601):

Thời gian kết thúc sự cố (định dạng ISO 8601):

Thông tin chi tiết về việc thiết lập API:
Tên tổ chức:
Tên môi trường:
Tên proxy API:
Số bản sửa đổi:

Các bước tái hiện sự cố:

<Cung cấp các bước để tái hiện vấn đề khi có thể>

Thông tin chẩn đoán:

<Danh sách các tệp đính kèm>

Trường hợp mẫu

Phần này cung cấp một trường hợp mẫu cho Apigee Cloud (Apigee trên Google Cloud/Apigee Edge trên Đám mây công cộng).

Vấn đề:

Chúng tôi nhận thấy rất nhiều lỗi 503 Dịch vụ không hoạt động trong Đám mây công cộng của mình org. Vui lòng xem xét và giải quyết vấn đề hoặc tư vấn cho chúng tôi cách giải quyết.

Thông báo lỗi:

{"fault":{"faultstring":"The Service is temporarily available", "detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"}}}

Thời gian bắt đầu sự cố (định dạng ISO 8601): 2020-10-04 06:30 IST

Thời gian kết thúc sự cố (định dạng ISO 8601): Sự cố vẫn đang xảy ra.

Thông tin chi tiết về việc thiết lập Apigee Cloud:
Tên tổ chức: myorg
Tên môi trường: dev
Tên proxy API: myproxy
Số bản sửa đổi: 3

Các bước tái hiện sự cố:

Chạy lệnh curl sau đây để tái hiện vấn đề:

curl -X GET 'https://myorg-dev.apigee.net/v1/myproxy'

Thông tin chẩn đoán:

Kết quả của công cụ theo dõi (trace-503.xml)

Apigee Edge cho Đám mây riêng tư

Mẫu

Phần này cung cấp một mẫu cho Apigee Edge dành cho Đám mây riêng tư.

Vấn đề:

<Cung cấp mô tả chi tiết về vấn đề hoặc hành vi bạn quan sát được. Thêm tên và phiên bản sản phẩm (nếu có).>

Thông báo lỗi:

<Bao gồm thông báo lỗi hoàn chỉnh đã phát hiện được (nếu có)>

Thời gian bắt đầu sự cố (định dạng ISO 8601):

Thời gian kết thúc sự cố (định dạng ISO 8601):

Thông tin chi tiết về cách thiết lập Edge Private Cloud:

<Đính kèm cấu trúc liên kết mạng mô tả cách thiết lập Đám mây riêng tư của bạn, bao gồm trung tâm dữ liệu và nút>

Các bước tái hiện sự cố:

<Cung cấp các bước để tái hiện vấn đề nếu có thể>

Thông tin chẩn đoán

<Danh sách các tệp đính kèm>

Trường hợp mẫu

Phần này cung cấp một trường hợp mẫu cho Apigee Edge cho Private Cloud.

Vấn đề:

Thời gian chúng tôi cài đặt Máy chủ quản lý Apigee trên Nút số 10 như một phần của Edge Private Cloud 4.19.06 trên Linux RHEL 7.6, chúng tôi đang gặp phải lỗi sau đây.

Thông báo lỗi:

<snipped as the output is too long>
Checking for management-server uuid ................................................
Unable to get uuid for management-server.
Error: setup.sh: /opt/apigee/apigee-service/bin/apigee-service exited with unexpected status 1

Thời gian bắt đầu sự cố (định dạng ISO 8601): Điều này xảy ra bất cứ khi nào chúng tôi cài đặt

Thời gian kết thúc sự cố(định dạng ISO 8601): Không áp dụng

Thông tin chi tiết về cách thiết lập Edge Private Cloud:

Đã đính kèm tệp network-topology.png

Các bước tái hiện sự cố:

Dưới đây là lệnh đã gây ra lỗi ở trên:

/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /app/NonProdConfig.txt

Thông tin chẩn đoán:

Đã đính kèm các tệp sau:

  • output.txt chứa đầu ra đầy đủ của lệnh trên, bao gồm cả thông báo lỗi
  • Nhật ký máy chủ quản lý và
  • Tệp cấu hình NonProdConfig.txt