Trình tạo cấu hình chỉ số

Trình tạo cấu hình chỉ số (MCG) là một dịch vụ giúp đơn giản hoá việc tạo cấu hình đo từ xa SDV. MCG chuyển đổi các cấu hình JSON mà con người có thể đọc được thành định dạng tệp MetricsConfiguration giao thức đệm (protobuf) nhị phân mà các chiến dịch đo từ xa trên xe yêu cầu.

MCG là một dịch vụ web mà bạn tương tác bằng các yêu cầu HTTP tiêu chuẩn. Phương pháp dựa trên API này cho phép bạn sử dụng các công cụ dòng lệnh như curl để tạo và gỡ lỗi theo cách thủ công, hoặc tích hợp MCG làm một phần phụ trợ cho các công cụ phức tạp hơn, chẳng hạn như giao diện đồ hoạ để tạo cấu hình.

Tính năng

Dịch vụ Đo từ xa trên xe yêu cầu một thông báo protobuf nhị phân MetricsConfiguration. Mặc dù thông báo này có thể được biểu thị dưới dạng định dạng textproto để gỡ lỗi, nhưng việc trực tiếp tạo định dạng này đòi hỏi kiến thức chi tiết về cấu trúc cấp thấp của định dạng và có thể tẻ nhạt cũng như dễ xảy ra lỗi. MCG đơn giản hoá quy trình này bằng cách chuyển hoạt động tạo cấu hình sang định dạng JSON thân thiện với người dùng.

MCG có những tính năng sau:

  • Cấu hình dựa trên JSON: Bạn có thể xác định các cấu hình chỉ số (bao gồm cả nguồn dữ liệu, logic xử lý và quy tắc báo cáo) ở định dạng JSON mà con người có thể đọc được. MCG sẽ biên dịch các cấu hình này thành định dạng protobuf nhị phân bắt buộc.
  • Xác thực tích hợp: Quy trình tạo tự động xác thực các cấu hình dựa trên định nghĩa tín hiệu và quy tắc giản đồ để phát hiện lỗi trước khi triển khai.
  • Tự động tạo loại thông báo: Các trình tổng hợp và báo cáo tạo ra những kết quả phải được xác định bằng cách sử dụng các trình mô tả thông báo protobuf trong cấu hình nhị phân cuối cùng. MCG suy luận cấu trúc của các kết quả này dựa trên các loại tín hiệu đầu vào và logic tổng hợp, đồng thời tự động tạo các bộ mô tả thông báo bắt buộc. Điều này giúp bạn không cần phải xác định lược đồ theo cách thủ công cho các cấu trúc dữ liệu trung gian hoặc dành riêng cho báo cáo.
  • Dễ dàng tạo biểu thức hơn: Ngữ pháp tuỳ chỉnh mà con người có thể đọc được để xác định biểu thức giúp bạn không phải tạo cây biểu thức theo cách thủ công.

Luồng công việc

Việc sử dụng MCG để tạo cấu hình chỉ số bao gồm 2 giai đoạn chính: tải từng phiên bản Danh mục tín hiệu xe mà bạn dự định sử dụng lên một lần, sau đó viết và tạo từng cấu hình chỉ số.

  1. Tải định nghĩa tín hiệu lên: Bạn chỉ cần thực hiện bước này một lần cho mỗi phiên bản Danh mục tín hiệu xe. Để bật tính năng xác thực và suy luận kiểu, MCG phải có quyền truy cập vào các định nghĩa tín hiệu xe mà bạn dự định tham chiếu trong cấu hình của mình. Các định nghĩa này phải đã tồn tại dưới dạng tệp protobuf trong dự án của bạn trong danh mục VSIDL (hoặc bạn có thể sử dụng các định nghĩa mẫu để thử nghiệm). Để cung cấp các tín hiệu này cho MCG, hãy đóng gói chúng vào một Danh mục tín hiệu xe và tải danh mục đó lên bằng API:

  2. Viết cấu hình: Sau khi tải một phiên bản danh mục lên MCG, bạn có thể viết bất kỳ số lượng cấu hình chỉ số nào tham chiếu đến phiên bản đó. Trong cấu hình JSON, bạn xác định nguồn dữ liệu cần dùng, cách thực hiện các phép tính hoặc phép tổng hợp trên dữ liệu đó và các điều kiện kích hoạt xác định thời điểm kết quả được tạo.

  3. Tạo: Gửi cấu hình JSON đến MCG API. API này xác thực cấu hình và biên dịch cấu hình đó thành định dạng MetricsConfiguration. Bạn có thể yêu cầu thông tin này dưới dạng protobuf nhị phân (application/x-protobuf) để sử dụng trên xe hoặc dưới dạng textproto (text/x-protobuf) để xem xét hoặc gỡ lỗi.

Để biết thông tin chi tiết toàn diện về tất cả các điểm cuối, định dạng yêu cầu và phản hồi cũng như các ví dụ về cách sử dụng, hãy xem Tài liệu tham khảo API MCG.

Triển khai

Là một dịch vụ gốc trên đám mây, MCG được thiết kế để triển khai vào một môi trường đám mây (chẳng hạn như Google Cloud Run), cung cấp một điểm tập trung để tạo và xác thực cấu hình trên các nhóm của bạn. Để biết hướng dẫn triển khai, hãy xem phần Triển khai trên Google Cloud.

Đối với quá trình phát triển và kiểm thử cục bộ, MCG cũng có thể chạy dưới dạng một dịch vụ độc lập trên máy của nhà phát triển. Để biết hướng dẫn thiết lập, hãy xem phần Chạy cục bộ.