Viewing running instances of virtual services

After you start virtual services from the Resources page, you can view the instances of the virtual services that are running from the Instances page in HCL OneTest™ Server. You can view the details, configuration settings, routing rules, usage statistics, or logs of a specific running instance of the virtual service. You can also stop the running instance.

Before you begin

You must have completed the following tasks:
  • Started the virtual service resources as a Tester or Owner from the Resources page.
  • Been assigned the Viewer, Tester, or Owner role in the project so that you can view the virtual services that are running.

About this task

After you started the virtual services from the Resources page on HCL OneTest™ Server, you can go to the Instances page and you can perform the following tasks:
  • View all running instances of the virtual services that are contained in the project repositories.
  • Search for a specific instance of the virtual service for which you want to view the details.
  • Create or use saved filters for viewing specific running instances of the virtual service.
  • View the details, configuration settings, routing rules, usage statistics, or logs of a specific running instance of the virtual service.
  • Change the behavior or logging level of a running instance of the virtual service before you run tests on the virtual service.
  • Stop a specific running instance of the virtual service.

Procedure

  1. Log in to HCL OneTest™ Server.
  2. Open the project that contains the virtual services in the test assets by clicking Projects > My Projects > project_name.
    The Overview page is displayed.
  3. Click Virtualization > Instances in the navigation pane.

    The Instances page is displayed.

    You can view all running instances of the virtual services that you started and the instances that were started by other members of the project. You can find the following information about the running instances that are displayed on the Instances page.
    • The name and path of the virtual service in the project repository are displayed in the Name column.
    • The tags or labels added to the instance when the run was configured is displayed in the Labels column.
    • The name of the environment associated with the operation in which the virtual service was created in HCL OneTest™ API is displayed in the Environment column.
    • The state of the running instance is displayed as Running in the State column.
    • The activity of the running instance of the virtual service based on the number of requests received in the previous hour is displayed in the Activity column. The activities are classified and displayed as indicated in the following table:
      Activity load Activity displayed as
      Received 0 requests None
      Received 1 - 10 requests Low
      Received 11 - 100 requests Mid
      Received 101 - 1000 requests High
      Received more than 1000 requests Very High
    • The Stop icon Image of the stop run icon. is displayed in the Actions column and stops the running instance of the virtual service, when clicked.
  4. Complete the steps for the task that you want to perform as listed in the following table:
    Task Action

    Searching for a specific instance of the virtual service for which you want to view the details or want to stop the instance.

    		 Enter either the complete text or part of the text in the name or the path of the virtual service that is in the repository in the Search field.

    The instances of the virtual services that match the text searched are displayed.
    Creating or using saved filters for viewing specific instances of virtual service resources.
    To create a query, perform the following actions:
    1. Click New filter.
    2. Create a rule with an appropriate operator.
    3. Select criteria such as Name, Path, Instance number, or Instance state.
    4. Select the condition, and then enter the value for the criteria.
    5. Apply the filter query.

      The virtual services that match the filter criteria are displayed.

    6. Save the filter query for retrieving it from the saved filters list.
    To use a saved filter query, perform the following actions:
    Note: To open the filter query, you must have created and saved a filter query.
    1. Click the Open filters icon Image of the icon.
    2. Select the saved filter.
    3. Apply the filter.

      The virtual services that match the filter criteria in the filter that is applied are displayed.
    Viewing the details, configuration settings, routing rules, usage statistics, or logs of a specific running instance of the virtual service. After you identify the virtual service instance for which you want to view the details, perform the following actions:
    1. Click the Expand icon Image of the icon. in the row of the identified instance of the virtual service.
      The Details panel of the instance is displayed. You can find the following details about the instance displayed:
      • Name
      • Path
      • Labels
      • API Environment
      • Version
      • Started at
      • Started by
      • Associated components
      • Documentation
    2. Click Behavior to expand the panel and view the behavior that was configured for the virtual service.
    3. Click Routing Rules to expand the panel and view the routing rules that were configured in the virtual service.
    4. Click Statistics to expand the panel and view the graphical representation of the activities performed by the virtual service.
    5. Click Diagnostics to expand the panel and view the logging configuration of the virtual service and the links to the logs.
    Changing the behavior or logging level of a running instance of the virtual service. After you identify the virtual service instance for which you want to view the details, perform the following actions:
    1. Click the Expand icon Image of the icon. in the row of the identified instance of the virtual service.

      The Details panel of the instance is displayed.

    2. Click Behavior to expand the panel.
      Perform the following steps to change the behavior configurations:
      1. Click the Edit icon Image of the edit icon..
      2. Select a different operation for the virtual service, if available.
      3. Select a different response time and enter the values for the delay you want to set.
      4. Click apply.
    3. Click Diagnostics to expand the panel.
      Perform the following steps to change the logging level configuration:
      1. Click the Edit icon Image of the edit icon..
      2. Select a different logging level.
      3. Click apply.
    Stop a specific running instance of the virtual service. Click the Stop icon Image of the stop run icon. in the row of the virtual service instance.

Results

You have viewed running instances of the virtual services from the Instances page on HCL OneTest™ Server.

What to do next

You can perform the following tasks: