Using Metrics Service (Technical Preview)
Using Metrics Service (Technical Preview)
As a system administrator, use the Metrics Service to view information about the acitivty of services running in the API Mediation Layer. Currently, only HTTP metrics are displayed for core API Mediation Layer services.
In order for the Metrics Service to run, you must set components.metrics-service.enabled
in zowe.yaml
to true
. Additionally, for each APIML service you want to have metrics collected for, you must set components.<service>.apiml.metrics.enabled
set to true
in zowe.yaml
, or configs.apiml.metrics.enabled
set to true
in the service's manifest. When metrics are enabled for the API Gateway, the Gateway homepage displays a link to the Metrics Service dashboard. The dashboard is available at https://{gateway_host}:{gateway_port}/metrics-service/ui/v1
.`
#
API Mediation Layer Metrics Service Demo VideoWatch this video to see a demo of the Metrics Service.
#
View HTTP Metrics in the Metrics Service DashboardUse the Metrics Service to view HTTP metrics such as number of requests, response times, and error rates. The below image describes the information provided in the Metrics Service dashboard.
To view the HTTP metrics for a service, select the corresponding tab in the Metrics Service dashboard. Metrics are displayed for each endpoint of a service, aggregated from all service instances.
Example:
Metrics are provided on a near real-time basis, so the display shows the current activity of the selected service. At this time there is no persistence for this information.
Service instances expose their HTTP metrics at https://<service_host>:<service_port>/application/hystrix.stream
using the Server-Sent-Events protocol. The Metrics Service collects these streams and aggregates them across service instances before displaying.
Note: At this time, the /application/hystrix.stream
endpoint for a service does not require authentication if metrics are enabled for that service. If metrics for that service are not enabled, /application/hystrix.stream
is protected by authentication.