Skip to main content

types

AgentSelector

Agent selection criterion.

The structure is used by service to determine on which agents a specific test should be executed.

One of agent

  • agentId : string

    Selection by agent ID.

  • matchByFilter : string

    Selection by filter string.

  • anonymousAgent : bool

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

ArtifactSettings

Artifact upload settings.

Defines where to upload test artifacts and which files should be included.

One of uploadTo

  • objectStorageBucket : string

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

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.

Details

Test meta information.

name : string

Name of the test.

description : string

Description of the test.

tags : common.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.

FilePointer

Variant-like structure for referencing files in different sources.

One of filePointer

  • objectStorage : ObjectStorage

    Reference to a file in Object Storage.

ImbalancePoint

Test imbalance point.

at : google.protobuf.Timestamp

Imbalance moment timestamp.

rps : int64

Imbalance moment RPS.

comment : string

Imbalance reason comment.

ObjectStorage

Reference to a file stored in Object Storage.

bucket : string

Bucket name.

name : string

File name.

SingleAgentConfiguration

Configuration of a test.

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.

Summary

Process of test and some results

status : Status

Status of the test.

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.

Test

Load Test.

In context of the service, Test represents a single testing task/job.

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.