Monitoring Web Services
- Former user (Deleted)
- Stonebranch (Deactivated)
Overview
Universal Controller supports the following RESTful-based web service for Monitoring operations:
Formatting specifications for each web service, including details about parameter requirements, are provided.
Universal Controller Metrics (Prometheus)
TheĀ Universal Controller MetricsĀ API requires the ops_admin role or the ops_service role.
Description | |
|---|---|
URI | http://host_name/uc/resources/metrics |
HTTP Method | GET |
Description | Scrape the Universal Controller metrics as Prometheus text. |
Example URI | |
Authentication | HTTP Basic |
Consumes Content-Type | n/a |
Produces Content-Type | text/plain; version=0.0.4 |
Example Responses |
|
Metrics
The following metric details Ā will be collected and will be scraped by Prometheus, an open-source systems monitoring and alerting toolkit.
Standard ExportsĀ CPU Time Spent and Memory Usage
- JVM Class Loading
Memory Pool ExportsĀ
Memory Allocation Exports
Buffer Pools ExportsĀ
Garbage Collector ExportsĀ
Thread Exports
Version Info Exports
- Universal ControllerĀ
UC Build Info Exports
UC Database Connection Pool ExportsĀ
OMS Server
- Status
- Last Connected Server
- Last Connected Time
- License Details
License Expiration DateĀ
Cluster Nodes actual/licensedĀ Ā
Distributed Agents actual/licensedĀ Ā
z/OS Agents actual/licensedĀ Ā
Task Defintions actual/licensedĀ Ā
Monthly Task Executions actual/licensedĀ Ā
License Metrics Data Example
HELP uc_license_cluster_nodes_used Returns the number of cluster nodes used
# TYPE uc_license_cluster_nodes_used gauge
uc_license_cluster_nodes_used{environment="QA",customer="*Stonebranch Internal*",expiry_date="2029-12-31",} 1.0
# HELP uc_license_cluster_nodes_max Returns the number of cluster nodes allowed
# TYPE uc_license_cluster_nodes_max gauge
uc_license_cluster_nodes_max{environment="QA",customer="*Stonebranch Internal*",expiry_date="2029-12-31",} 2.0
# HELP uc_license_agents_distributed_used Returns the number of distributed agents used
# TYPE uc_license_agents_distributed_used gauge
uc_license_agents_distributed_used{environment="QA",customer="*Stonebranch Internal*",expiry_date="2029-12-31",} 4.0
# HELP uc_license_agents_distributed_max Returns the number of distributed agents allowed
# TYPE uc_license_agents_distributed_max gauge
uc_license_agents_distributed_max{environment="QA",customer="*Stonebranch Internal*",expiry_date="2029-12-31",} 300.0
# HELP uc_license_agents_zos_max Returns the number of Zos agents allowed
# TYPE uc_license_agents_zos_max gauge
uc_license_agents_zos_max{environment="QA",customer="*Stonebranch Internal*",expiry_date="2029-12-31",} 150.0
# HELP uc_license_agents_zos_used Returns the number of Zos agents used
# TYPE uc_license_agents_zos_used gauge
uc_license_agents_zos_used{environment="QA",customer="*Stonebranch Internal*",expiry_date="2029-12-31",} 0.0
# HELP uc_license_task_definitions_max Returns the number of task definitions allowed
# TYPE uc_license_task_definitions_max gauge
uc_license_task_definitions_max{environment="QA",customer="*Stonebranch Internal*",expiry_date="2029-12-31",} -1.0
# HELP uc_license_task_definitions_used Returns the number of task definitions used
# TYPE uc_license_task_definitions_used gauge
uc_license_task_definitions_used{environment="QA",customer="*Stonebranch Internal*",expiry_date="2029-12-31",} 0.0
# HELP uc_license_monthly_executions_max Returns the number of monthly task executions allowed
# TYPE uc_license_monthly_executions_max gauge
uc_license_monthly_executions_max{environment="QA",customer="*Stonebranch Internal*",expiry_date="2029-12-31",} -1.0
# HELP uc_license_monthly_executions_used Returns the number of monthly task executions used
# TYPE uc_license_monthly_executions_used gauge
uc_license_monthly_executions_used{environment="QA",customer="*Stonebranch Internal*",expiry_date="2029-12-31",} 0.0
OMS Server Metrics Data Example
# HELP uc_oms_server_status OMS Server status. (0=Disconnected, 1=Connected, -1=Unknown)
# TYPE uc_oms_server_status gauge
uc_oms_server_status{server_address="localhost",last_connected="localhost/127.0.0.1:7878",} 1.0
# HELP uc_oms_server_last_connected_time_seconds OMS Server last connected time in seconds.
# TYPE uc_oms_server_last_connected_time_seconds gauge
uc_oms_server_last_connected_time_seconds{server_address="localhost",last_connected="localhost/127.0.0.1:7878",} 1.656447938346E12
# HELP uc_oms_server_session_status OMS Server session status. (0=None, 1=Impaired, 2=Operational, -1=Unknown)
# TYPE uc_oms_server_session_status gauge
uc_oms_server_session_status{server_address="localhost",last_connected="localhost/127.0.0.1:7878",} 2.0