tencent cloud

All product documents
Tencent Cloud Observability Platform
DocumentationTencent Cloud Observability PlatformPerformance Testing ServiceOperation GuidePerformance Testing in Script ModeProtobuf-based Performance Testing
Protobuf-based Performance Testing
Download PDF
Last updated: 2025-03-10 22:14:19
Protobuf-based Performance Testing
Last updated: 2025-03-10 22:14:19
Download PDF
This document introduces how to use the serialization protocol Protobuf.

Protocol File Upload

Before using the Protobuf protocol, you need to upload .proto files. The performance testing engine relies on protocol files to complete the serialization of requests. You can upload files or directories. File names should be unique, and existing files with the same name will be overwritten by newly uploaded files. If you upload a ZIP file, PTS will decompress the file and display the structure of the decompressed file. If the directory or ZIP package contains files other than .proto files, PTS will ignore these files.



Note:
For multi-protocol files, see Using Protocol Files.
With the .proto files you upload, you can serialize/deserialize objects in the script. If demo.proto depends on other .proto files, they also need to be uploaded together (the standard .proto files provided by Google, namely, google/protobuf/*.proto, do not need to be uploaded separately because PTS will load them automatically). You only need to load the main .proto file, and other .proto files that the main .proto file depends on will be loaded recursively.

Example





Protocol File

duty.proto

syntax = "proto3";

message Duty {
  string time = 1;
  string work = 2;
}

student.proto

syntax = "proto3";
import "duty.proto";

package student;

message Student {
  string name = 1;
  Gender gender = 2;

  message GradeInfo {
    enum Grade {
	  DEFAULT = 0;
      FIRST = 1;
      SECOND = 2;
      THIRD = 3;
    }
    Grade grade = 1;
  }
  GradeInfo gradeInfo = 3;
  
  map<string, int32> scores = 4;
  repeated Duty duties = 5;
}

enum Gender {
  DEFAULT = 0;
  FEMALE = 1;
  MALE = 2;
}

message SearchRequest {
  string id = 1;
}

message SearchResponse {
  message Result {
    Student student = 1;

  }
}

service SearchService {
  rpc SearchScores (SearchRequest) returns (SearchResponse);
}

Script

import protobuf from 'pts/protobuf';


// Load the student.proto file in the root directory of the protocol files. The duty.proto file will be loaded at the same time.
protobuf.load([], 'student.proto');


// Load the student.proto file in the dirName directory of the protocol files.
// protobuf.load(['dirName'], 'student.proto');


export default function () {
    let bodyBuffer = protobuf.marshal('student.Student', {
        'name': 'Alice',
        'gender': 1, // Alternatively, set it to FEMALE. You can directly set the specific value for enum.
        'gradeInfo': {
            'grade': 'THIRD'
        },
        'scores': {
            'Chinese': 116,
            'Math': 120,
            'English': 106
        },
        'duties': [
            {
                'time': 'time1',
                'work': 'work1'
            },
            {
                'time': 'time2',
                'work': 'work2'
            }
        ]
    });

    const value = protobuf.unmarshal('student.Student', bodyBuffer);
	// {"name":"Alice","gender":"FEMALE","gradeInfo":{"grade":"THIRD"},"scores":{"Math":120,"Chinese":116,"English":106},"duties":[{"time":"time","work":"work"}]}
    console.log(JSON.stringify(value));
}

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon