---
title: "Post server metrics to analyze scaling conditions"
method: POST
path: "/servers/self/metrics"
tags: ["servers"]
---

# Post server metrics to analyze scaling conditions

`POST /servers/self/metrics`

Server periodically posts metrics that helps in making a scaling decision

## Request body

- ServerMeasurement[] — Measurements of resource usage of a server
  - `time` string, required — An iso8601 formatted timestamp
  - `cpu_percent` number — Percentage of CPU utilization. This is expected to be provided by all servers
  - `loadavg_norm` number[] — 15, 5 and 1 min load averages per cpu. This is expected to be provided by UNIX-based servers
  - `iowait_percent` number — Percentage of time spent by ready tasks waiting for I/O operations to complete. This is expected to be provided by UNIX-based servers
  - `memory_used_percent` number — Average percentage of memory used. This is expected to be provided by all servers
  - `avg_processor_queue_length` number — Average of processor queue length. This is expected to be provided by Windows-based servers
  - `avg_disk_queue_length` number — Average of disk queue length. This is expected to be provided by Windows-based servers
  - `duration` integer, required — The size of the interval ending at 'time' to which the metrics apply. Providers of metrics are expected to periodically supply metrics in adjacent intervals with identical duration, preferably every 20 seconds

## Response `200`

Metrics were posted

- ServerMeasurement[] — Measurements of resource usage of a server
  - `time` string, required — An iso8601 formatted timestamp
  - `cpu_percent` number — Percentage of CPU utilization. This is expected to be provided by all servers
  - `loadavg_norm` number[] — 15, 5 and 1 min load averages per cpu. This is expected to be provided by UNIX-based servers
  - `iowait_percent` number — Percentage of time spent by ready tasks waiting for I/O operations to complete. This is expected to be provided by UNIX-based servers
  - `memory_used_percent` number — Average percentage of memory used. This is expected to be provided by all servers
  - `avg_processor_queue_length` number — Average of processor queue length. This is expected to be provided by Windows-based servers
  - `avg_disk_queue_length` number — Average of disk queue length. This is expected to be provided by Windows-based servers
  - `duration` integer, required — The size of the interval ending at 'time' to which the metrics apply. Providers of metrics are expected to periodically supply metrics in adjacent intervals with identical duration, preferably every 20 seconds

---

[API](https://skmtc.dev/webscale/apis/webscale-apis.md) · [All operations](https://skmtc.dev/webscale/apis/webscale-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webscale/webscale-apis/revisions/c98d872b50cb/schema)