After creating a service, you can configure its quality of service (QoS) operations, edit/delete the service or manage/monitor it using the dashboard.
Accessing the service dashboard
Follow the steps below to access the dashboard of a service.
- Log in to the management console and select Services > List under the Main menu .
- The Deployed Services page appears, which lists out all deployed services. Click on a service to view its dashboard.
Accessing the service groups dashboard
A Service Group is a convenient way of deploying multiple services in one service archive file. There is a logical relationship between the services at runtime. The only difference in the services.xml for a service group and a single service is its root element. For a service group, the root element is <serviceGroup>
, and we have multiple <service>
elements inside the <serviceGroup>
element. For example,
<serviceGroup> <service name=Test1> ... </service> <service name=Test2> ... </service> </serviceGroup>
The steps below show how to access and manage service groups.
- Log in to the management console and select Services > List under the Main menu .
- In the Deployed Services page that appears, click the deployed service group(s) link to access the groups.
- The Deployed Service Groups window opens. Click a group to go to its dashboard.
- The Services Panel lists all the services included in the group. For example,
Managing a service using the dashboard
When you click a service on the Deployed Services screen or the Service Groups dashboard, the service dashboard will open. You can then use the following funtions available on the dashboard:
Getting the service endpoints
The Endpoints section on the service dashboard displays the endpoint URLs that can be used to access the service. Each service has two endpoints by default. Typically, the endpoint URI is of the following format: http://{host ip of the server}:{server port}/services/{service name}.
Trying the service
When you click Try this service, it will direct you to a page that displays all the operations available for the service. For operations that take arguments, you will see primitive argument type fields. The values specified in these fields will be passed to the operations. For no-argument operations, you will only see the button that has the same name as the operation. Click Send to invoke the service operation. The return value immediately appears in the response text area.
Generating a client for the service
The Generate Client option is provided by the wsdl.tools
feature of the WSO2 feature repository.
Using the WSDLs: WSDL 1.1 and WSDL 2.0
Opens XML configurations. The WSDLs describe the operations the service exposes, the structure of the XML that is sent and received by each operation, and how to communicate with the service to retrieve the XML content. By default, six different types of endpoints are deployed. Each of these endpoint types are represented by the WSDL 2.0 <endpoint> elements of the service, and by the <binding> elements to which these endpoints refer. The default six types of endpoints are as follows:
- SOAP 1.2 over HTTP
- SOAP 1.1 over HTTP
- Plain old XML/REST over HTTP
- SOAP 1.2 over HTTPS
- SOAP 1.1 over HTTPS
- Plain old XML/REST over HTTPS
The URLs for the WSDL files of the service can also be appended by concatenating the endpoint URL of the service with the following strings:
- ?wsdl2 : WSDL 2.0 description of the service
- ?wsdl: WSDL 1.1 description of the service
Viewing statistics
The Statistics panel provides statistical information about a service as follows: Request Count, Response Count, Fault Count, Maximum Response Time, Minimum Response Time, Average Response Time. It also provides a graphical view of the system response time.
Editing a service
The service Specific Configurations section allows you to apply modifications to your service. The available options will depend on the type of service. See the following topics for instructions relevant to each service type: