Contact UsGet started

Load Testing API, gRPC: TestService.Get

Written by
Updated at December 17, 2024

Returns the specified test.

To get the list of all available tests, make a List request.

gRPC request

rpc Get (GetTestRequest) returns (test.Test)

GetTestRequest

{
  "test_id": "string"
}

Field

Description

test_id

string

Required field. ID of the test to return.

test.Test

{
  "id": "string",
  "configurations": [
    {
      "config_id": "string",
      "agent_selector": {
        // Includes only one of the fields `agent_id`, `match_by_filter`, `anonymous_agent`
        "agent_id": "string",
        "match_by_filter": "string",
        "anonymous_agent": "bool"
        // end of the list of possible fields
      },
      "files": "map<string, FilePointer>"
    }
  ],
  "details": {
    "name": "string",
    "description": "string",
    "tags": [
      {
        "key": "string",
        "value": "string"
      }
    ],
    "logging_log_group_id": "string",
    "artifact_settings": {
      // Includes only one of the fields `object_storage_bucket`
      "object_storage_bucket": "string",
      // end of the list of possible fields
      "is_archive": "bool",
      "filter_include": [
        "string"
      ],
      "filter_exclude": [
        "string"
      ]
    }
  },
  "summary": {
    "status": "Status",
    "created_at": "google.protobuf.Timestamp",
    "created_by": "string",
    "started_at": "google.protobuf.Timestamp",
    "finished_at": "google.protobuf.Timestamp",
    "is_finished": "bool",
    "error": "string",
    "imbalance_point": {
      "at": "google.protobuf.Timestamp",
      "rps": "int64",
      "comment": "string"
    },
    "assigned_agent_id": "string",
    "artifacts": {
      // Includes only one of the fields `object_storage`
      "object_storage": {
        "bucket": "string",
        "name": "string"
      }
      // end of the list of possible fields
    }
  },
  "folder_id": "string"
}

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.

folder_id

string

ID of the folder that the test belongs to.

SingleAgentConfiguration

Configuration of a test.

Field

Description

config_id

string

ID of the config.

agent_selector

AgentSelector

Agent selection criterion.

files

object (map<string, 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

agent_id

string

Selection by agent ID.

Includes only one of the fields agent_id, match_by_filter, anonymous_agent.

match_by_filter

string

Selection by filter string.

Includes only one of the fields agent_id, match_by_filter, anonymous_agent.

anonymous_agent

bool

Select anonymoud (i.e. not registered) agents.

Includes only one of the fields agent_id, match_by_filter, anonymous_agent.

FilePointer

Variant-like structure for referencing files in different sources.

Field

Description

object_storage

ObjectStorage

Reference to a file in Object Storage.

Includes only one of the fields object_storage.

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.

logging_log_group_id

string

ID of the logging group to which test artifacts are uploaded.

artifact_settings

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

object_storage_bucket

string

Name of output object storage bucket in test's folder.

Includes only one of the fields object_storage_bucket.

is_archive

bool

Setting which defines whether artifact files should be archived prior to uploading.

filter_include[]

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.

filter_exclude[]

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.

created_at

google.protobuf.Timestamp

Creation timestamp.

created_by

string

UA or SA that created the test.

started_at

google.protobuf.Timestamp

Test start timestamp.

Empty if the test has not been started yet.

finished_at

google.protobuf.Timestamp

Test finish timestamp.

Empty if the test has not been finished yet.

is_finished

bool

Indicates whether the test is finished.

error

string

Error message.

imbalance_point

ImbalancePoint

Detected imbalance point.

Contains information about a state at the moment it has been
auto-stopped.

Empty if no auto-stop occured.

assigned_agent_id

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.
Previous
Create
Next
Stop