/
Monitoring Web Services

Monitoring Web Services

Overview

Universal Controller supports the following RESTful-based web service for Monitoring operations:

  • Universal Controller Metrics (Prometheus)

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

http://localhost:8080/uc/resources/metrics

Authentication

HTTP Basic

Consumes Content-Type

n/a

Produces Content-Type

text/plain; version=0.0.4

Example Responses

  • Status 200

    • <Metrics as text/plain; version=0.0.4>

  • Status 403

    • Operation prohibited due to security constraints.


Metrics

The following metric details will be collected and will be scraped by Prometheus, an open-source systems monitoring and alerting toolkit.

  • Universal Controller Task Instance Activity and History Metric Exports
  • Standard Metric Exports (CPU Time Spent and Memory Usage)
  • JVM Class Loading
    • JVM Memory Pools Metric Exports
    • JVM Memory Allocation Metric Exports
    • JVM Buffer Pools Metric Exports
    • JVM Garbage Collector Exports
    • JVM Thread Metric Exports
    • JVM Class Loading Metric Exports
    • JVM Version Info Exports
  • Universal Controller Build Info Metric Exports
  • Universal Controller Database Connection Pool Metric Exports
  • OMS Server Metrics
  • License Detail Metrics

See Universal Controller Provided Metrics for a full list of metrics.


Metrics Data Example

# HELP uc_history_total Total number of task instances that completed with an end status of In Doubt, Start Failure, Confirmation Required, Cancelled, Failed, Skipped, Finished, or Success.
# TYPE uc_history_total counter
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",task_instance_status="Success",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Universal Command",task_type_detailed="Universal Command",task_instance_status="Success",} 2.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SQL",task_type_detailed="SQL",task_instance_status="Success",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Application Control",task_type_detailed="Application Control",task_instance_status="Finished",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Remote File Monitor",task_type_detailed="Remote File Monitor",task_instance_status="Success",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Workflow",task_type_detailed="Workflow",task_instance_status="Success",} 2.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Stored Procedure",task_type_detailed="Stored Procedure",task_instance_status="Success",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Task Monitor",task_type_detailed="Task Monitor",task_instance_status="Success",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Variable Monitor",task_type_detailed="Variable Monitor",task_instance_status="Success",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Manual",task_type_detailed="Manual",task_instance_status="Success",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",task_instance_status="Success",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",task_instance_status="Success",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",task_instance_status="Success",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="z/OS",task_type_detailed="z/OS",task_instance_status="Skipped",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Universal",task_type_detailed="License Generator - 7.5",task_instance_status="Success",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Application Control",task_type_detailed="Application Control",task_instance_status="Failed",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Agent File Monitor",task_type_detailed="Agent File Monitor",task_instance_status="Success",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Windows",task_type_detailed="Windows",task_instance_status="Skipped",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",task_instance_status="Success",} 1.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Timer",task_type_detailed="Timer",task_instance_status="Success",} 2.0
uc_history_total{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="z/OS",task_type_detailed="z/OS",task_instance_status="Success",} 101.0
# HELP uc_task_instance_late_start_total Total number of task instances that started late.
# TYPE uc_task_instance_late_start_total counter
# HELP jvm_classes_currently_loaded The number of classes that are currently loaded in the JVM
# TYPE jvm_classes_currently_loaded gauge
jvm_classes_currently_loaded 17606.0
# HELP jvm_classes_loaded_total The total number of classes that have been loaded since the JVM has started execution
# TYPE jvm_classes_loaded_total counter
jvm_classes_loaded_total 18951.0
# HELP jvm_classes_unloaded_total The total number of classes that have been unloaded since the JVM has started execution
# TYPE jvm_classes_unloaded_total counter
jvm_classes_unloaded_total 1345.0
# HELP jvm_info VM version info
# TYPE jvm_info gauge
jvm_info{runtime="OpenJDK Runtime Environment",vendor="Ubuntu",version="11.0.17+8-post-Ubuntu-1ubuntu220.04",} 1.0
# HELP uc_task_instance_early_finish_total Total number of task instances that finished early.
# TYPE uc_task_instance_early_finish_total counter
# HELP uc_task_instance_duration_seconds Task instance duration in seconds.
# TYPE uc_task_instance_duration_seconds histogram
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="1.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="2.5",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="5.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="10.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="15.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="30.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="45.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="60.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="150.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="300.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="600.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="900.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="1800.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="2700.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="3600.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",le="+Inf",} 1.0
uc_task_instance_duration_seconds_count{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",} 1.0
uc_task_instance_duration_seconds_sum{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="File Transfer",task_type_detailed="File Transfer",} 0.13
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="1.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="2.5",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="5.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="10.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="15.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="30.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="45.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="60.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="150.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="300.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="600.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="900.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="1800.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="2700.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="3600.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",le="+Inf",} 1.0
uc_task_instance_duration_seconds_count{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",} 1.0
uc_task_instance_duration_seconds_sum{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Linux/Unix",task_type_detailed="Linux/Unix",} 0.036
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="1.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="2.5",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="5.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="10.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="15.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="30.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="45.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="60.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="150.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="300.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="600.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="900.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="1800.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="2700.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="3600.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",le="+Inf",} 1.0
uc_task_instance_duration_seconds_count{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",} 1.0
uc_task_instance_duration_seconds_sum{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="System Monitor",task_type_detailed="System Monitor",} 0.012
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="1.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="2.5",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="5.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="10.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="15.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="30.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="45.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="60.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="150.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="300.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="600.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="900.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="1800.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="2700.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="3600.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",le="+Inf",} 1.0
uc_task_instance_duration_seconds_count{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",} 1.0
uc_task_instance_duration_seconds_sum{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="Email",task_type_detailed="Email",} 0.091
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="1.0",} 0.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="2.5",} 0.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="5.0",} 0.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="10.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="15.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="30.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="45.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="60.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="150.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="300.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="600.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="900.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="1800.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="2700.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="3600.0",} 1.0
uc_task_instance_duration_seconds_bucket{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",le="+Inf",} 1.0
uc_task_instance_duration_seconds_count{cluster_node_id="qa-opswise6:8080-qa_opswise6",task_type="SAP",task_type_detailed="SAP",} 1.0
uc_task_instance_duratio