Add spec for dbaas mysql metrics

specification/DigitalOcean-public.v2.yaml

@@ -1657,6 +1657,50 @@ paths:
     get:
       $ref: "resources/monitoring/monitoring_get_droplet_autoscale_target_memory_utilization.yml"
 
+  /v2/monitoring/metrics/database/mysql/cpu_usage:
+    get:
+      $ref: "resources/monitoring/monitoring_get_database_mysql_cpu_usage.yml"
+
+  /v2/monitoring/metrics/database/mysql/load:
+    get:
+      $ref: "resources/monitoring/monitoring_get_database_mysql_load.yml"
+
+  /v2/monitoring/metrics/database/mysql/memory_usage:
+    get:
+      $ref: "resources/monitoring/monitoring_get_database_mysql_memory_usage.yml"
+
+  /v2/monitoring/metrics/database/mysql/disk_usage:
+    get:
+      $ref: "resources/monitoring/monitoring_get_database_mysql_disk_usage.yml"
+
+  /v2/monitoring/metrics/database/mysql/threads_connected:
+    get:
+      $ref: "resources/monitoring/monitoring_get_database_mysql_threads_connected.yml"
+
+  /v2/monitoring/metrics/database/mysql/threads_created_rate:
+    get:
+      $ref: "resources/monitoring/monitoring_get_database_mysql_threads_created_rate.yml"
+
+  /v2/monitoring/metrics/database/mysql/threads_active:
+    get:
+      $ref: "resources/monitoring/monitoring_get_database_mysql_threads_active.yml"
+
+  /v2/monitoring/metrics/database/mysql/index_vs_sequential_reads:
+    get:
+      $ref: "resources/monitoring/monitoring_get_database_mysql_index_vs_sequential_reads.yml"
+
+  /v2/monitoring/metrics/database/mysql/op_rates:
+    get:
+      $ref: "resources/monitoring/monitoring_get_database_mysql_op_rates.yml"
+
+  /v2/monitoring/metrics/database/mysql/schema_throughput:
+    get:
+      $ref: "resources/monitoring/monitoring_get_database_mysql_schema_throughput.yml"
+
+  /v2/monitoring/metrics/database/mysql/schema_latency:
+    get:
+      $ref: "resources/monitoring/monitoring_get_database_mysql_schema_latency.yml"
+
   /v2/monitoring/sinks/destinations:
     post:
       $ref: "resources/monitoring/monitoring_create_destination.yml"

specification/resources/monitoring/monitoring_get_database_mysql_cpu_usage.yml

@@ -0,0 +1,34 @@
+operationId: monitoring_get_database_mysql_cpu_usage
+
+summary: Get Database MySQL CPU Usage Metrics
+
+description: >-
+  Retrieve CPU usage (percent) for a MySQL cluster. Response is a time series of
+  cluster-level CPU usage. Use **aggregate** to get avg, max, or min over the range.
+
+tags:
+  - Monitoring
+
+parameters:
+  - $ref: 'parameters.yml#/db_id'
+  - $ref: 'parameters.yml#/aggregate_avg_max_min'
+  - $ref: 'parameters.yml#/metric_timestamp_start'
+  - $ref: 'parameters.yml#/metric_timestamp_end'
+
+responses:
+  "200":
+    $ref: responses/metric_response.yml
+  "401":
+    $ref: ../../shared/responses/unauthorized.yml
+  "404":
+    $ref: ../../shared/responses/not_found.yml
+  "429":
+    $ref: ../../shared/responses/too_many_requests.yml
+  "500":
+    $ref: ../../shared/responses/server_error.yml
+  default:
+    $ref: ../../shared/responses/unexpected_error.yml
+
+security:
+  - bearer_auth:
+    - 'monitoring:read'

specification/resources/monitoring/monitoring_get_database_mysql_disk_usage.yml

@@ -0,0 +1,34 @@
+operationId: monitoring_get_database_mysql_disk_usage
+
+summary: Get Database MySQL Disk Usage Metrics
+
+description: >-
+  Retrieve disk usage (percent) for a MySQL cluster. Use **aggregate** (avg, max,
+  or min) over the time range.
+
+tags:
+  - Monitoring
+
+parameters:
+  - $ref: 'parameters.yml#/db_id'
+  - $ref: 'parameters.yml#/aggregate_avg_max_min'
+  - $ref: 'parameters.yml#/metric_timestamp_start'
+  - $ref: 'parameters.yml#/metric_timestamp_end'
+
+responses:
+  "200":
+    $ref: responses/metric_response.yml
+  "401":
+    $ref: ../../shared/responses/unauthorized.yml
+  "404":
+    $ref: ../../shared/responses/not_found.yml
+  "429":
+    $ref: ../../shared/responses/too_many_requests.yml
+  "500":
+    $ref: ../../shared/responses/server_error.yml
+  default:
+    $ref: ../../shared/responses/unexpected_error.yml
+
+security:
+  - bearer_auth:
+    - 'monitoring:read'

specification/resources/monitoring/monitoring_get_database_mysql_index_vs_sequential_reads.yml

@@ -0,0 +1,33 @@
+operationId: monitoring_get_database_mysql_index_vs_sequential_reads
+
+summary: Get Database MySQL Index vs Sequential Reads Metrics
+
+description: >-
+  Retrieve index vs sequential reads ratio (percent) for a MySQL service — i.e.
+  percentage of reads using an index.
+
+tags:
+  - Monitoring
+
+parameters:
+  - $ref: 'parameters.yml#/db_id'
+  - $ref: 'parameters.yml#/metric_timestamp_start'
+  - $ref: 'parameters.yml#/metric_timestamp_end'
+
+responses:
+  "200":
+    $ref: responses/metric_response.yml
+  "401":
+    $ref: ../../shared/responses/unauthorized.yml
+  "404":
+    $ref: ../../shared/responses/not_found.yml
+  "429":
+    $ref: ../../shared/responses/too_many_requests.yml
+  "500":
+    $ref: ../../shared/responses/server_error.yml
+  default:
+    $ref: ../../shared/responses/unexpected_error.yml
+
+security:
+  - bearer_auth:
+    - 'monitoring:read'

specification/resources/monitoring/monitoring_get_database_mysql_load.yml

@@ -0,0 +1,36 @@
+operationId: monitoring_get_database_mysql_load
+
+summary: Get Database MySQL Load Average Metrics
+
+description: >-
+  Retrieve load metrics for a MySQL cluster. Use **metric** for the window: **load1** (1-minute),
+  **load5** (5-minute), or **load15** (15-minute). Use **aggregate** to get either the average (avg)
+  or maximum (max) over that window over the time range.
+
+tags:
+  - Monitoring
+
+parameters:
+  - $ref: 'parameters.yml#/db_id'
+  - $ref: 'parameters.yml#/metric_load'
+  - $ref: 'parameters.yml#/aggregate_avg_max'
+  - $ref: 'parameters.yml#/metric_timestamp_start'
+  - $ref: 'parameters.yml#/metric_timestamp_end'
+
+responses:
+  "200":
+    $ref: responses/metric_response.yml
+  "401":
+    $ref: ../../shared/responses/unauthorized.yml
+  "404":
+    $ref: ../../shared/responses/not_found.yml
+  "429":
+    $ref: ../../shared/responses/too_many_requests.yml
+  "500":
+    $ref: ../../shared/responses/server_error.yml
+  default:
+    $ref: ../../shared/responses/unexpected_error.yml
+
+security:
+  - bearer_auth:
+    - 'monitoring:read'

specification/resources/monitoring/monitoring_get_database_mysql_memory_usage.yml

@@ -0,0 +1,34 @@
+operationId: monitoring_get_database_mysql_memory_usage
+
+summary: Get Database MySQL Memory Usage Metrics
+
+description: >-
+  Retrieve memory usage (percent) for a MySQL cluster. Use **aggregate** (avg, max,
+  or min) over the time range.
+
+tags:
+  - Monitoring
+
+parameters:
+  - $ref: 'parameters.yml#/db_id'
+  - $ref: 'parameters.yml#/aggregate_avg_max_min'
+  - $ref: 'parameters.yml#/metric_timestamp_start'
+  - $ref: 'parameters.yml#/metric_timestamp_end'
+
+responses:
+  "200":
+    $ref: responses/metric_response.yml
+  "401":
+    $ref: ../../shared/responses/unauthorized.yml
+  "404":
+    $ref: ../../shared/responses/not_found.yml
+  "429":
+    $ref: ../../shared/responses/too_many_requests.yml
+  "500":
+    $ref: ../../shared/responses/server_error.yml
+  default:
+    $ref: ../../shared/responses/unexpected_error.yml
+
+security:
+  - bearer_auth:
+    - 'monitoring:read'

specification/resources/monitoring/monitoring_get_database_mysql_op_rates.yml

@@ -0,0 +1,34 @@
+operationId: monitoring_get_database_mysql_op_rates
+
+summary: Get Database MySQL Operations Throughput Metrics
+
+description: >-
+  Retrieve operations rate (per second) for a MySQL service. Use **metric** to
+  choose select, insert, update, or delete.
+
+tags:
+  - Monitoring
+
+parameters:
+  - $ref: 'parameters.yml#/db_id'
+  - $ref: 'parameters.yml#/metric_op_rates'
+  - $ref: 'parameters.yml#/metric_timestamp_start'
+  - $ref: 'parameters.yml#/metric_timestamp_end'
+
+responses:
+  "200":
+    $ref: responses/metric_response.yml
+  "401":
+    $ref: ../../shared/responses/unauthorized.yml
+  "404":
+    $ref: ../../shared/responses/not_found.yml
+  "429":
+    $ref: ../../shared/responses/too_many_requests.yml
+  "500":
+    $ref: ../../shared/responses/server_error.yml
+  default:
+    $ref: ../../shared/responses/unexpected_error.yml
+
+security:
+  - bearer_auth:
+    - 'monitoring:read'

specification/resources/monitoring/monitoring_get_database_mysql_schema_latency.yml

@@ -0,0 +1,35 @@
+operationId: monitoring_get_database_mysql_schema_latency
+
+summary: Get Database MySQL Schema Latency Metrics
+
+description: >-
+  Retrieve table I/O latency (seconds) for a schema. Requires **schema** and
+  **metric** (insert, fetch, update, delete).
+
+tags:
+  - Monitoring
+
+parameters:
+  - $ref: 'parameters.yml#/db_id'
+  - $ref: 'parameters.yml#/schema'
+  - $ref: 'parameters.yml#/metric_schema_io'
+  - $ref: 'parameters.yml#/metric_timestamp_start'
+  - $ref: 'parameters.yml#/metric_timestamp_end'
+
+responses:
+  "200":
+    $ref: responses/metric_response.yml
+  "401":
+    $ref: ../../shared/responses/unauthorized.yml
+  "404":
+    $ref: ../../shared/responses/not_found.yml
+  "429":
+    $ref: ../../shared/responses/too_many_requests.yml
+  "500":
+    $ref: ../../shared/responses/server_error.yml
+  default:
+    $ref: ../../shared/responses/unexpected_error.yml
+
+security:
+  - bearer_auth:
+    - 'monitoring:read'

specification/resources/monitoring/monitoring_get_database_mysql_schema_throughput.yml

@@ -0,0 +1,35 @@
+operationId: monitoring_get_database_mysql_schema_throughput
+
+summary: Get Database MySQL Schema Throughput Metrics
+
+description: >-
+  Retrieve table I/O throughput (rows per second) for a schema. Requires **schema**
+  and **metric** (insert, fetch, update, delete).
+
+tags:
+  - Monitoring
+
+parameters:
+  - $ref: 'parameters.yml#/db_id'
+  - $ref: 'parameters.yml#/schema'
+  - $ref: 'parameters.yml#/metric_schema_io'
+  - $ref: 'parameters.yml#/metric_timestamp_start'
+  - $ref: 'parameters.yml#/metric_timestamp_end'
+
+responses:
+  "200":
+    $ref: responses/metric_response.yml
+  "401":
+    $ref: ../../shared/responses/unauthorized.yml
+  "404":
+    $ref: ../../shared/responses/not_found.yml
+  "429":
+    $ref: ../../shared/responses/too_many_requests.yml
+  "500":
+    $ref: ../../shared/responses/server_error.yml
+  default:
+    $ref: ../../shared/responses/unexpected_error.yml
+
+security:
+  - bearer_auth:
+    - 'monitoring:read'

specification/resources/monitoring/monitoring_get_database_mysql_threads_active.yml

@@ -0,0 +1,31 @@
+operationId: monitoring_get_database_mysql_threads_active
+
+summary: Get Database MySQL Threads Active Metrics
+
+description: Retrieve active (running) threads for a MySQL service.
+
+tags:
+  - Monitoring
+
+parameters:
+  - $ref: 'parameters.yml#/db_id'
+  - $ref: 'parameters.yml#/metric_timestamp_start'
+  - $ref: 'parameters.yml#/metric_timestamp_end'
+
+responses:
+  "200":
+    $ref: responses/metric_response.yml
+  "401":
+    $ref: ../../shared/responses/unauthorized.yml
+  "404":
+    $ref: ../../shared/responses/not_found.yml
+  "429":
+    $ref: ../../shared/responses/too_many_requests.yml
+  "500":
+    $ref: ../../shared/responses/server_error.yml
+  default:
+    $ref: ../../shared/responses/unexpected_error.yml
+
+security:
+  - bearer_auth:
+    - 'monitoring:read'

specification/resources/monitoring/monitoring_get_database_mysql_threads_connected.yml

@@ -0,0 +1,31 @@
+operationId: monitoring_get_database_mysql_threads_connected
+
+summary: Get Database MySQL Threads Connected Metrics
+
+description: Retrieve current threads connected for a MySQL service (gauge).
+
+tags:
+  - Monitoring
+
+parameters:
+  - $ref: 'parameters.yml#/db_id'
+  - $ref: 'parameters.yml#/metric_timestamp_start'
+  - $ref: 'parameters.yml#/metric_timestamp_end'
+
+responses:
+  "200":
+    $ref: responses/metric_response.yml
+  "401":
+    $ref: ../../shared/responses/unauthorized.yml
+  "404":
+    $ref: ../../shared/responses/not_found.yml
+  "429":
+    $ref: ../../shared/responses/too_many_requests.yml
+  "500":
+    $ref: ../../shared/responses/server_error.yml
+  default:
+    $ref: ../../shared/responses/unexpected_error.yml
+
+security:
+  - bearer_auth:
+    - 'monitoring:read'