Load Testing API, gRPC: TestService.Create
Creates (runs) a test in the specified folder.
gRPC request
rpc Create (CreateTestRequest) returns (operation.Operation)
CreateTestRequest
{
"folderId": "string",
"configurations": [
{
"configId": "string",
"agentSelector": {
// Includes only one of the fields `agentId`, `matchByFilter`, `anonymousAgent`
"agentId": "string",
"matchByFilter": "string",
"anonymousAgent": "bool"
// end of the list of possible fields
},
"files": {
// Includes only one of the fields `objectStorage`
"objectStorage": {
"bucket": "string",
"name": "string"
}
// end of the list of possible fields
}
}
],
"testDetails": {
"name": "string",
"description": "string",
"tags": [
{
"key": "string",
"value": "string"
}
],
"loggingLogGroupId": "string",
"artifactSettings": {
// Includes only one of the fields `objectStorageBucket`
"objectStorageBucket": "string",
// end of the list of possible fields
"isArchive": "bool",
"filterInclude": [
"string"
],
"filterExclude": [
"string"
]
}
}
}
Field |
Description |
folderId |
string Required field. ID of the folder to create a test in. |
configurations[] |
Test configuration associated with agents on which they will be executed. |
testDetails |
Test details. Name, tags etc. |
SingleAgentConfiguration
Configuration of a test.
Field |
Description |
configId |
string ID of the config. |
agentSelector |
Agent selection criterion. |
files |
Additional files to be used during test execution, represented as
Use cases include:
|
AgentSelector
Agent selection criterion.
The structure is used by service to determine on which agents a specific test should be executed.
Field |
Description |
agentId |
string Selection by agent ID. Includes only one of the fields |
matchByFilter |
string Selection by filter string. Includes only one of the fields |
anonymousAgent |
bool Select anonymoud (i.e. not registered) agents. Includes only one of the fields |
FilePointer
Variant-like structure for referencing files in different sources.
Field |
Description |
objectStorage |
Reference to a file in Object Storage. Includes only one of the fields |
ObjectStorage
Reference to a file stored in Object Storage.
Field |
Description |
bucket |
string Bucket name. |
name |
string File name. |
Details
Test meta information.
Field |
Description |
name |
string Name of the test. |
description |
string Description of the test. |
tags[] |
Tags assigned to the test. |
loggingLogGroupId |
string ID of the logging group to which test artifacts are uploaded. |
artifactSettings |
Settings which define where to upload test artifacts and which files should be included. |
Tag
Tag attached to some entity.
Field |
Description |
key |
string Key of the tag. |
value |
string Value of the tag. |
ArtifactSettings
Artifact upload settings.
Defines where to upload test artifacts and which files should be included.
Field |
Description |
objectStorageBucket |
string Name of output object storage bucket in test's folder. Includes only one of the fields |
isArchive |
bool Setting which defines whether artifact files should be archived prior to uploading. |
filterInclude[] |
string Filter strings defining which files should be included to artifacts. GLOB format. Example:
|
filterExclude[] |
string Filter strings defining which files should be excluded from artifacts. GLOB format. Example:
|
operation.Operation
{
"id": "string",
"description": "string",
"createdAt": "google.protobuf.Timestamp",
"createdBy": "string",
"modifiedAt": "google.protobuf.Timestamp",
"done": "bool",
"metadata": {
"testId": "string"
},
// Includes only one of the fields `error`, `response`
"error": "google.rpc.Status",
"response": {
"id": "string",
"configurations": [
{
"configId": "string",
"agentSelector": {
// Includes only one of the fields `agentId`, `matchByFilter`, `anonymousAgent`
"agentId": "string",
"matchByFilter": "string",
"anonymousAgent": "bool"
// end of the list of possible fields
},
"files": {
// Includes only one of the fields `objectStorage`
"objectStorage": {
"bucket": "string",
"name": "string"
}
// end of the list of possible fields
}
}
],
"details": {
"name": "string",
"description": "string",
"tags": [
{
"key": "string",
"value": "string"
}
],
"loggingLogGroupId": "string",
"artifactSettings": {
// Includes only one of the fields `objectStorageBucket`
"objectStorageBucket": "string",
// end of the list of possible fields
"isArchive": "bool",
"filterInclude": [
"string"
],
"filterExclude": [
"string"
]
}
},
"summary": {
"status": "Status",
"createdAt": "google.protobuf.Timestamp",
"createdBy": "string",
"startedAt": "google.protobuf.Timestamp",
"finishedAt": "google.protobuf.Timestamp",
"isFinished": "bool",
"error": "string",
"imbalancePoint": {
"at": "google.protobuf.Timestamp",
"rps": "int64",
"comment": "string"
},
"assignedAgentId": "string",
"artifacts": {
// Includes only one of the fields `objectStorage`
"objectStorage": {
"bucket": "string",
"name": "string"
}
// end of the list of possible fields
}
},
"folderId": "string"
}
// end of the list of possible fields
}
An Operation resource. For more information, see Operation.
Field |
Description |
id |
string ID of the operation. |
description |
string Description of the operation. 0-256 characters long. |
createdAt |
Creation timestamp. |
createdBy |
string ID of the user or service account who initiated the operation. |
modifiedAt |
The time when the Operation resource was last modified. |
done |
bool If the value is |
metadata |
Service-specific metadata associated with the operation. |
error |
The error result of the operation in case of failure or cancellation. Includes only one of the fields The operation result. |
response |
The normal response of the operation in case of success. Includes only one of the fields The operation result. |
CreateTestMetadata
Field |
Description |
testId |
string ID of the test that is being created. |
Test
Load Test.
In context of the service, Test represents a single testing task/job.
Field |
Description |
id |
string ID of the test. Generated at creation time. |
configurations[] |
Configuration of the test. A test can have multiple configurations if it can be |
details |
Test meta information. Name, description, etc. |
summary |
Test execution information. |
folderId |
string ID of the folder that the test belongs to. |
SingleAgentConfiguration
Configuration of a test.
Field |
Description |
configId |
string ID of the config. |
agentSelector |
Agent selection criterion. |
files |
Additional files to be used during test execution, represented as
Use cases include:
|
AgentSelector
Agent selection criterion.
The structure is used by service to determine on which agents a specific test should be executed.
Field |
Description |
agentId |
string Selection by agent ID. Includes only one of the fields |
matchByFilter |
string Selection by filter string. Includes only one of the fields |
anonymousAgent |
bool Select anonymoud (i.e. not registered) agents. Includes only one of the fields |
FilePointer
Variant-like structure for referencing files in different sources.
Field |
Description |
objectStorage |
Reference to a file in Object Storage. Includes only one of the fields |
ObjectStorage
Reference to a file stored in Object Storage.
Field |
Description |
bucket |
string Bucket name. |
name |
string File name. |
Details
Test meta information.
Field |
Description |
name |
string Name of the test. |
description |
string Description of the test. |
tags[] |
Tags assigned to the test. |
loggingLogGroupId |
string ID of the logging group to which test artifacts are uploaded. |
artifactSettings |
Settings which define where to upload test artifacts and which files should be included. |
Tag
Tag attached to some entity.
Field |
Description |
key |
string Key of the tag. |
value |
string Value of the tag. |
ArtifactSettings
Artifact upload settings.
Defines where to upload test artifacts and which files should be included.
Field |
Description |
objectStorageBucket |
string Name of output object storage bucket in test's folder. Includes only one of the fields |
isArchive |
bool Setting which defines whether artifact files should be archived prior to uploading. |
filterInclude[] |
string Filter strings defining which files should be included to artifacts. GLOB format. Example:
|
filterExclude[] |
string Filter strings defining which files should be excluded from artifacts. GLOB format. Example:
|
Summary
Process of test and some results
Field |
Description |
status |
enum Status Status of the test.
|
createdAt |
Creation timestamp. |
createdBy |
string UA or SA that created the test. |
startedAt |
Test start timestamp. Empty if the test has not been started yet. |
finishedAt |
Test finish timestamp. Empty if the test has not been finished yet. |
isFinished |
bool Indicates whether the test is finished. |
error |
string Error message. |
imbalancePoint |
Detected imbalance point. Contains information about a state at the moment it has been Empty if no auto-stop occured. |
assignedAgentId |
string ID of the agent that executed the test. |
artifacts |
Test output artifacts. Link to the artifacts output target containing |
ImbalancePoint
Test imbalance point.
Field |
Description |
at |
Imbalance moment timestamp. |
rps |
int64 Imbalance moment RPS. |
comment |
string Imbalance reason comment. |