Load Testing API, gRPC: TestService.List

Written by

Yandex Cloud

Updated at October 17, 2024

gRPC request
ListTestsRequest
ListTestsResponse
Test
SingleAgentConfiguration
AgentSelector
FilePointer
ObjectStorage
Details
Tag
ArtifactSettings
Summary
ImbalancePoint

Retrieves the list of test in the specified folder.

gRPC request

rpc List (ListTestsRequest) returns (ListTestsResponse)

ListTestsRequest

{
  "folderId": "string",
  "pageSize": "int64",
  "pageToken": "string",
  "filter": "string"
}

Field	Description
folderId	string ID of the folder to list tests in.
pageSize	int64 The maximum number of results per page to return. If the number of available results is larger than `page_size`, the service returns a ListTestsResponse.nextPageToken that can be used to get the next page of results in subsequent list requests. Default value: 100.
pageToken	string Page token. To get the next page of results, set `page_token` to the ListTestsResponse.nextPageToken returned by a previous list request.
filter	string A filter expression that filters tests listed in the response. The filter expression may contain multiple field expressions joined by `AND`. The field expression must specify: The field name. An operator: `=`, `!=`, `<`, `<=`, `>`, `>=`, `CONTAINS`, `:` for single values. `IN` or `NOT IN` for lists of values. The value. String values must be encosed in `"`, boolean values are {`true`, `false`}, timestamp values in ISO-8601. Currently supported fields: `id` yandex.cloud.loadtesting.api.v1.test.Test.id operators: `=`, `!=`, `IN`, `NOT IN` `details.name` yandex.cloud.loadtesting.api.v1.test.Details.name operators: `=`, `!=`, `IN`, `NOT IN`, `CONTAINS` `details.tags.<TAG_NAME>` yandex.cloud.loadtesting.api.v1.test.Details.tags operators: `:` `summary.status` yandex.cloud.loadtesting.api.v1.test.Summary.status operators: `=`, `!=`, `IN`, `NOT IN` `summary.is_finished` yandex.cloud.loadtesting.api.v1.test.Summary.isFinished operators: `=` `summary.created_at` yandex.cloud.loadtesting.api.v1.test.Summary.createdAt operators: `<`, `<=`, `>`, `>=` `summary.created_by` yandex.cloud.loadtesting.api.v1.test.Summary.createdBy operators: `=`, `!=`, `IN`, `NOT IN` Examples: `summary.status IN ("DONE", "ERROR") AND details.tags.author:"yandex"` `summary.is_finished = true AND details.name CONTAINS "nightly-test"`

ListTestsResponse

{
  "tests": [
    {
      "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"
    }
  ],
  "nextPageToken": "string"
}

Field

Description

tests[]

Test

List of tests in the specified folder.

nextPageToken

string

Token for getting the next page of the list. If the number of results is greater than
the specified ListTestsRequest.pageSize, use next_page_token as the value
for the ListTestsRequest.pageToken parameter in the next list request.

Each subsequent page will have its own next_page_token to continue paging through the results.

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[]	SingleAgentConfiguration Configuration of the test. A test can have multiple configurations if it can be executed on multiple agents simultaneously. For more information, see Load testing using multiple agents.
details	Details Test meta information. Name, description, etc.
summary	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	AgentSelector Agent selection criterion.
files	FilePointer Additional files to be used during test execution, represented as `rel_path:file` pairs. `rel_path` can be either a simple file name, a relative path, or absolute path. Files are downloaded by the agent to appropriate location. Use cases include: Test Data files. Custom Pandora executable. JMeter executable or ".jmx" scenario. etc.

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 `agentId`, `matchByFilter`, `anonymousAgent`.
matchByFilter	string Selection by filter string. Includes only one of the fields `agentId`, `matchByFilter`, `anonymousAgent`.
anonymousAgent	bool Select anonymoud (i.e. not registered) agents. Includes only one of the fields `agentId`, `matchByFilter`, `anonymousAgent`.

FilePointer

Variant-like structure for referencing files in different sources.

Field

Description

objectStorage

ObjectStorage

Reference to a file in Object Storage.

Includes only one of the fields objectStorage.

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[]	Tag Tags assigned to the test.
loggingLogGroupId	string ID of the logging group to which test artifacts are uploaded.
artifactSettings	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 `objectStorageBucket`.
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: [''] - all files will be uploaded. ['.log', '*.yaml] - all `.log` and `.yaml` files will be uploaded.
filterExclude[]	string Filter strings defining which files should be excluded from artifacts. GLOB format. Example: filter_include=['*'], filter_exclude=['phout.log'] - upload all `.log` files excluding `phout.log`.

Summary

Process of test and some results

Field	Description
status	enum Status Status of the test. `STATUS_UNSPECIFIED`: Status is unspecified. `CREATED`: Test has been created, but not started by any agent. `INITIATED`: Execution stage: initialization. `PREPARING`: Execution stage: data preparation and warm-up. `RUNNING`: Execution stage: load generation. `FINISHING`: Execution stage: termination. `DONE`: Test is done. `POST_PROCESSING`: Execution stage: results post-processing. `FAILED`: Test has failed due to some error. `STOPPING`: Test is being stopped. `STOPPED`: Test has been stopped. `AUTOSTOPPED`: Test has been stopped automatically by satisfying autostop condition. `WAITING`: Execution stage: waiting for a trigger to start. `DELETING`: Test is being deleted. `LOST`: Test status has not been reported in a while during execution stage. Means that either an agent is too busy to send it, got offline, or failed without reporting a final status.
createdAt	google.protobuf.Timestamp Creation timestamp.
createdBy	string UA or SA that created the test.
startedAt	google.protobuf.Timestamp Test start timestamp. Empty if the test has not been started yet.
finishedAt	google.protobuf.Timestamp 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	ImbalancePoint Detected imbalance point. Contains information about a state at the moment it has been auto-stopped. Empty if no auto-stop occured.
assignedAgentId	string ID of the agent that executed the test.
artifacts	FilePointer Test output artifacts. Link to the artifacts output target containing `.log` and other files collected during test execution.

ImbalancePoint

Test imbalance point.

Field	Description
at	google.protobuf.Timestamp Imbalance moment timestamp.
rps	int64 Imbalance moment RPS.
comment	string Imbalance reason comment.

Load Testing API, gRPC: TestService.List

gRPC requestgRPC request

ListTestsRequestListTestsRequest

ListTestsResponseListTestsResponse

TestTest

SingleAgentConfigurationSingleAgentConfiguration

AgentSelectorAgentSelector

FilePointerFilePointer

ObjectStorageObjectStorage

DetailsDetails

TagTag

ArtifactSettingsArtifactSettings

SummarySummary

ImbalancePointImbalancePoint

Was the article helpful?

gRPC request

ListTestsRequest

ListTestsResponse

Test

SingleAgentConfiguration

AgentSelector

FilePointer

ObjectStorage

Details

Tag

ArtifactSettings

Summary

ImbalancePoint