Contact UsGet started
© 2024 Direct Cursus Technology L.L.C.

Load Testing API, gRPC: AgentService.Get

Written by
Updated at December 17, 2024

Returns the specified agent.

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

gRPC request

rpc Get (GetAgentRequest) returns (agent.Agent)

GetAgentRequest

{
  "agent_id": "string"
}

Field

Description

agent_id

string

ID of the agent to return.

agent.Agent

{
  "id": "string",
  "folder_id": "string",
  "name": "string",
  "description": "string",
  "compute_instance_id": "string",
  "status": "Status",
  "errors": [
    "string"
  ],
  "current_job_id": "string",
  "agent_version_id": "string",
  "labels": "map<string, string>",
  "log_settings": {
    "cloud_log_group_id": "string"
  }
}

Load testing agent on which tests are executed.

Field

Description

id

string

ID of the agent. Generated at creation time.

folder_id

string

ID of the folder that the agent belongs to.

name

string

Name of the agent.

description

string

Description of the agent.

compute_instance_id

string

ID of the compute instance managed by the agent.

Empty if there is no such instance (i.e. the case of external agent).

status

enum Status

Status of the agent.

  • STATUS_UNSPECIFIED: Status is not specified.
  • PREPARING_TEST: Agent is preparing a test to be executed.
  • READY_FOR_TEST: Agent is ready to take a test.
  • TESTING: Agent is executing a test.
  • TANK_FAILED: Agent application encountered an error and cannot operate normally.
  • PROVISIONING: Agent is waiting for resources to be allocated.
  • STOPPING: Agent is being stopped.
  • STOPPED: Agent is stopped.
  • STARTING: Agent is being started.
  • RESTARTING: Agent is being restarted.
  • UPDATING: Agent is being updated.
  • ERROR: Agent encountered an error and cannot operate.
  • CRASHED: Agent is crashed and will be restarted automatically.
  • DELETING: Agent is being deleted.
  • INITIALIZING_CONNECTION: Service is waiting for connection with agent to be established.
  • LOST_CONNECTION_WITH_AGENT: Service has lost connection with agent.
  • UPLOADING_ARTIFACTS: Agent is uploading test artifacts.

errors[]

string

List of errors reported by the agent.

current_job_id

string

ID of the test that is currently being executed by the agent.

agent_version_id

string

Version of the agent.

labels

object (map<string, string>)

Agent labels as key:value pairs.

log_settings

LogSettings

Agent log settings

LogSettings

Field

Description

cloud_log_group_id

string

Id of Yandex Cloud log group to upload agent logs to
Previous
Create
Next
List