Returns CPU, memory, network, load, and connection metrics for a running server over a configurable time window. Each metric is a time series of {t, v} data points where t is a Unix timestamp and v is the metric value.
Use period to control the time window (e.g., 1h for last hour) and step for data point resolution (e.g., 60s for one point per minute).
Only available for servers that are currently running.
GET
/
api
/
v3
/
servers
/
{instance_id}
/
metrics
Get server resource metrics
curl --request GET \ --url https://api.computeflow.cloud/api/v3/servers/{instance_id}/metrics \ --header 'api-key: <api-key>'
Relative time window for metrics (used when start_time is omitted). "5m": last 5 minutes, "15m": last 15 minutes, "1h": last hour, "6h": last 6 hours, "24h": last 24 hours.
Data point interval. Smaller steps give higher resolution but more data. "15s": every 15 seconds … "1800s": every 30 minutes. Scale it to the window (a wide window needs a coarse step).
Absolute window start — ISO 8601 (e.g., "2026-07-12T03:00:00Z") or relative (e.g., "-6h"). When set it OVERRIDES period, so you can inspect a specific interval (pair with end_time).
Number of vCPUs allocated to the machine, derived from compute_size. Threshold the 1-minute load average against this: at/above vcpus is a warning, at/above 2× is an overload likely to freeze the game loop. Null when the size is unknown.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Documentation - PlayFlow Cloud","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#1E3A8A"},"logo":{"light":"https://mintcdn.com/playflow/eqeqAmqAMsOYKFZn/logo/svgs/3.svg?fit=max\u0026auto=format\u0026n=eqeqAmqAMsOYKFZn\u0026q=85\u0026s=ec6b551d72d9a0550eceaf8372781505","dark":"https://mintcdn.com/playflow/eqeqAmqAMsOYKFZn/logo/svgs/4.svg?fit=max\u0026auto=format\u0026n=eqeqAmqAMsOYKFZn\u0026q=85\u0026s=56ed179b4ec9ff9a3b8c659b610385e1"},"favicon":"https://mintcdn.com/playflow/eqeqAmqAMsOYKFZn/favicon.svg?fit=max\u0026auto=format\u0026n=eqeqAmqAMsOYKFZn\u0026q=85\u0026s=4f01ae4525de4b30fd0fef06c5145d06","navbar":{"links":[{"href":"https://discord.gg/P5w45Vx5Q8","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.playflowcloud.com"}},"footer":{"socials":{"x":"https://x.com/PlayFlowCloud","github":"https://github.com/PlayFlowCloud","linkedin":"https://www.linkedin.com/company/84953462"}},"seo":{"metatags":{"description":"Official documentation for PlayFlow Cloud. Learn to build, deploy, and scale multiplayer games with our tools for server hosting, matchmaking, and lobbies.","keywords":"PlayFlow, PlayFlow Cloud, game development, multiplayer, Unity, Unreal Engine, Godot, game servers, server hosting, matchmaking, lobbies, WebGL, game backend, documentation","author":"PlayFlow Cloud","robots":"index, follow","googlebot":"index, follow","language":"en","copyright":"Copyright 2025 PlayFlow Cloud","distribution":"global","coverage":"Worldwide","category":"Game Development","og:title":"PlayFlow Cloud Documentation","og:description":"Official documentation for PlayFlow Cloud. Learn to build, deploy, and scale multiplayer games with our tools for server hosting, matchmaking, and lobbies.","og:type":"website","og:site_name":"PlayFlow Cloud","og:url":"https://docs.playflowcloud.com","og:locale":"en_US","twitter:card":"summary_large_image","twitter:site":"@PlayFlowCloud","twitter:creator":"@PlayFlowCloud","twitter:title":"PlayFlow Cloud Documentation","twitter:description":"Official documentation for PlayFlow Cloud. Learn to build, deploy, and scale multiplayer games with our tools for server hosting, matchmaking, and lobbies."},"indexing":"all"},"icons":{"library":"lucide"},"integrations":{"posthog":{"apiKey":"phc_fBrC62lJ5zi3r6ItRQsm4NcKIJOvc2e73YZtSaTpYxy"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/P5w45Vx5Q8"},{"anchor":"Blog","icon":"newspaper","href":"https://playflowcloud.com/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"playflow","hasAudioNarration":false,"actualSubdomain":"playflow","customDomains":["docs.playflowcloud.com"],"gitSource":{"type":"github","owner":"playflowcloud","repo":"playflow-core","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a551e6696ba02c71ec13582","collectionId":"3524da5f-fd4d-49f3-a07a-bea7ab61d2ef","schemaVersion":"v3"},"feedback":{"thumbs":false},"entitlements":{},"buildId":"6a551e6696ba02c71ec13582:success","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Documentation","count":37},{"language":"default","tag":"API Reference","count":36},{"language":"default","tag":"Endpoints","count":35},{"language":"default","tag":"Lobbies","count":18},{"language":"default","tag":"Lobbies \u0026 Matchmaking","count":12},{"language":"default","tag":"Getting Started","count":10},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Servers","count":8},{"language":"default","tag":"Quick Start Guides","count":7},{"language":"default","tag":"Unity SDK","count":6}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/servers/get-server-resource-metrics","slug":"/api-reference/servers/get-server-resource-metrics","pageMetadata":{"title":"Get server resource metrics","description":"Returns CPU, memory, network, load, and connection metrics for a running server over a configurable time window. Each metric is a time series of `{t, v}` data points where `t` is a Unix timestamp and `v` is the metric value.\n\nUse `period` to control the time window (e.g., `1h` for last hour) and `step` for data point resolution (e.g., `60s` for one point per minute).\n\nOnly available for servers that are currently running.","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/servers/{instance_id}/metrics","href":"/api-reference/servers/get-server-resource-metrics","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Returns CPU, memory, network, load, and connection metrics for a running server over a configurable time window. Each metric is a time series of \", _jsx(_components.code, {\n children: \"{t, v}\"\n }), \" data points where \", _jsx(_components.code, {\n children: \"t\"\n }), \" is a Unix timestamp and \", _jsx(_components.code, {\n children: \"v\"\n }), \" is the metric value.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Use \", _jsx(_components.code, {\n children: \"period\"\n }), \" to control the time window (e.g., \", _jsx(_components.code, {\n children: \"1h\"\n }), \" for last hour) and \", _jsx(_components.code, {\n children: \"step\"\n }), \" for data point resolution (e.g., \", _jsx(_components.code, {\n children: \"60s\"\n }), \" for one point per minute).\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Only available for servers that are currently running.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get server resource metrics","description":"Returns CPU, memory, network, load, and connection metrics for a running server over a configurable time window. Each metric is a time series of `{t, v}` data points where `t` is a Unix timestamp and `v` is the metric value.\n\nUse `period` to control the time window (e.g., `1h` for last hour) and `step` for data point resolution (e.g., `60s` for one point per minute).\n\nOnly available for servers that are currently running.","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/servers/{instance_id}/metrics","href":"/api-reference/servers/get-server-resource-metrics","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getServerMetrics","tags":["Servers"],"summary":"Get server resource metrics","description":"Returns CPU, memory, network, load, and connection metrics for a running server over a configurable time window. Each metric is a time series of `{t, v}` data points where `t` is a Unix timestamp and `v` is the metric value.\n\nUse `period` to control the time window (e.g., `1h` for last hour) and `step` for data point resolution (e.g., `60s` for one point per minute).\n\nOnly available for servers that are currently running.","parameters":["265e5021-0b50-41dc-8479-be3c3a8764df","e4bf82ea-9d71-44ff-86a5-4eef280b4490","345141b1-55d5-47f6-a20c-cecba2906ae1","4f56bf38-44ac-4d0d-b3de-a16d9c92bca0","74216d45-9ac5-40d9-8380-905f17a9193f"],"responses":{"200":"0ec00997-19f0-47cb-b6be-ec87d43bd660","404":"beec4759-29e5-4ae6-8e11-5c7e6703ec40"},"method":"get","type":"path","servers":["10dc6c24-ec8f-48c6-85d3-b4e04b596923"],"security":["0648c24c-6553-4c47-aec3-e48fcddd9e9d"],"path":"/api/v3/servers/{instance_id}/metrics","baseUrlOptions":["https://api.computeflow.cloud"],"title":"Get server resource metrics","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"265e5021-0b50-41dc-8479-be3c3a8764df":{"schema":{"type":"string","description":"Server instance ID.","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"Server instance ID.","name":"instance_id","in":"path"},"e4bf82ea-9d71-44ff-86a5-4eef280b4490":{"schema":{"type":"string","enum":["5m","15m","1h","6h","24h"],"default":"1h","description":"Relative time window for metrics (used when start_time is omitted). \"5m\": last 5 minutes, \"15m\": last 15 minutes, \"1h\": last hour, \"6h\": last 6 hours, \"24h\": last 24 hours.","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":false,"description":"Relative time window for metrics (used when start_time is omitted). \"5m\": last 5 minutes, \"15m\": last 15 minutes, \"1h\": last hour, \"6h\": last 6 hours, \"24h\": last 24 hours.","name":"period","in":"query"},"345141b1-55d5-47f6-a20c-cecba2906ae1":{"schema":{"type":"string","enum":["15s","30s","60s","300s","600s","1800s"],"default":"60s","description":"Data point interval. Smaller steps give higher resolution but more data. \"15s\": every 15 seconds … \"1800s\": every 30 minutes. Scale it to the window (a wide window needs a coarse step).","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":false,"description":"Data point interval. Smaller steps give higher resolution but more data. \"15s\": every 15 seconds … \"1800s\": every 30 minutes. Scale it to the window (a wide window needs a coarse step).","name":"step","in":"query"},"4f56bf38-44ac-4d0d-b3de-a16d9c92bca0":{"schema":{"type":"string","description":"Absolute window start — ISO 8601 (e.g., \"2026-07-12T03:00:00Z\") or relative (e.g., \"-6h\"). When set it OVERRIDES period, so you can inspect a specific interval (pair with end_time).","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"description":"Absolute window start — ISO 8601 (e.g., \"2026-07-12T03:00:00Z\") or relative (e.g., \"-6h\"). When set it OVERRIDES period, so you can inspect a specific interval (pair with end_time).","name":"start_time","in":"query"},"74216d45-9ac5-40d9-8380-905f17a9193f":{"schema":{"type":"string","description":"Absolute window end — ISO 8601. Defaults to now. Use with start_time for a fixed interval (e.g., a past incident window).","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"description":"Absolute window end — ISO 8601. Defaults to now. Use with start_time for a fixed interval (e.g., a past incident window).","name":"end_time","in":"query"}},"responses":{"0ec00997-19f0-47cb-b6be-ec87d43bd660":{"description":"Server resource metrics over the requested time window.","content":{"application/json":{"schema":{"type":"object","properties":{"instance_id":{"type":"string","description":"Server instance ID.","isRequired":true,"uniqueKey":"instance_id","typeLabel":"string"},"machine_id":{"type":"string","description":"Fly.io machine ID providing these metrics.","isRequired":true,"uniqueKey":"machine_id","typeLabel":"string"},"region":{"type":"string","description":"Fly.io region code (e.g., \"ewr\", \"fra\").","isRequired":true,"uniqueKey":"region","typeLabel":"string"},"compute_size":{"oneOf":[{"type":"string","description":"PlayFlow compute size of the machine (e.g. \"small\", \"large\").","isRequired":true,"uniqueKey":"compute_size.oneOf.0","typeLabel":"string"},{"type":"null","description":"PlayFlow compute size of the machine (e.g. \"small\", \"large\").","isRequired":true,"uniqueKey":"compute_size.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"compute_size","typeLabel":"string | null"},"vcpus":{"oneOf":[{"type":"number","description":"Number of vCPUs allocated to the machine, derived from compute_size. Threshold the 1-minute load average against this: at/above vcpus is a warning, at/above 2× is an overload likely to freeze the game loop. Null when the size is unknown.","isRequired":true,"uniqueKey":"vcpus.oneOf.0","typeLabel":"number"},{"type":"null","description":"Number of vCPUs allocated to the machine, derived from compute_size. Threshold the 1-minute load average against this: at/above vcpus is a warning, at/above 2× is an overload likely to freeze the game loop. Null when the size is unknown.","isRequired":true,"uniqueKey":"vcpus.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vcpus","typeLabel":"number | null"},"lifecycle":{"type":"object","properties":{"started_at":{"oneOf":[{"type":"string","description":"ISO 8601 time the current run started (last launch/restart). Overlay as a reference line so restarts are visible on the metric charts.","isRequired":true,"uniqueKey":"lifecycle.started_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 8601 time the current run started (last launch/restart). Overlay as a reference line so restarts are visible on the metric charts.","isRequired":true,"uniqueKey":"lifecycle.started_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lifecycle.started_at","typeLabel":"string | null"},"stopped_at":{"oneOf":[{"type":"string","description":"ISO 8601 time the server stopped, or null if still running.","isRequired":true,"uniqueKey":"lifecycle.stopped_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 8601 time the server stopped, or null if still running.","isRequired":true,"uniqueKey":"lifecycle.stopped_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lifecycle.stopped_at","typeLabel":"string | null"},"shutdown_reason":{"oneOf":[{"type":"string","description":"Why the server stopped (e.g. \"oom\", \"ttl\", \"crash\", \"user\"). Pair with stopped_at to mark an OOM/crash line on the timeline.","isRequired":true,"uniqueKey":"lifecycle.shutdown_reason.oneOf.0","typeLabel":"string"},{"type":"null","description":"Why the server stopped (e.g. \"oom\", \"ttl\", \"crash\", \"user\"). Pair with stopped_at to mark an OOM/crash line on the timeline.","isRequired":true,"uniqueKey":"lifecycle.shutdown_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lifecycle.shutdown_reason","typeLabel":"string | null"}},"required":["started_at","stopped_at","shutdown_reason"],"description":"Restart/stop/OOM markers for the charts.","isRequired":true,"uniqueKey":"lifecycle","typeLabel":"object"},"period":{"type":"object","properties":{"start":{"type":"number","description":"Unix timestamp for the start of the metrics window.","isRequired":true,"uniqueKey":"period.start","typeLabel":"number"},"end":{"type":"number","description":"Unix timestamp for the end of the metrics window.","isRequired":true,"uniqueKey":"period.end","typeLabel":"number"},"step":{"type":"string","description":"Data point interval used (e.g., \"60s\").","isRequired":true,"uniqueKey":"period.step","typeLabel":"string"}},"required":["start","end","step"],"description":"Time window and resolution for the returned metrics.","isRequired":true,"uniqueKey":"period","typeLabel":"object"},"cpu":{"type":"object","properties":{"usage_percent":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"cpu.usage_percent.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"cpu.usage_percent.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"cpu.usage_percent.items.[INDEX]","typeLabel":"object"},"description":"CPU usage percentage over time (0–100+). Values above 100% indicate multiple cores being used.","isRequired":true,"uniqueKey":"cpu.usage_percent","typeLabel":"object[]"},"iowait_percent":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"cpu.iowait_percent.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"cpu.iowait_percent.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"cpu.iowait_percent.items.[INDEX]","typeLabel":"object"},"description":"Percentage of CPU time spent waiting on I/O. Sustained high iowait is a common cause of game-loop stalls/freezes (the process is blocked on disk or network).","uniqueKey":"cpu.iowait_percent","typeLabel":"object[]"},"steal_percent":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"cpu.steal_percent.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"cpu.steal_percent.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"cpu.steal_percent.items.[INDEX]","typeLabel":"object"},"description":"Percentage of CPU time \"stolen\" by the hypervisor for other tenants. Elevated steal indicates noisy-neighbor contention on the host and can cause hitches the game cannot control.","uniqueKey":"cpu.steal_percent","typeLabel":"object[]"}},"required":["usage_percent"],"description":"CPU usage metrics, broken down to surface I/O-wait and steal which are typical freeze culprits.","isRequired":true,"uniqueKey":"cpu","typeLabel":"object"},"memory":{"type":"object","properties":{"used_mb":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"memory.used_mb.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"memory.used_mb.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"memory.used_mb.items.[INDEX]","typeLabel":"object"},"description":"Memory usage in megabytes over time.","isRequired":true,"uniqueKey":"memory.used_mb","typeLabel":"object[]"},"total_mb":{"type":"number","description":"Total memory available to this machine in megabytes.","isRequired":true,"uniqueKey":"memory.total_mb","typeLabel":"number"}},"required":["used_mb","total_mb"],"description":"Memory usage metrics.","isRequired":true,"uniqueKey":"memory","typeLabel":"object"},"network":{"type":"object","properties":{"rx_bytes_per_sec":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"network.rx_bytes_per_sec.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"network.rx_bytes_per_sec.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"network.rx_bytes_per_sec.items.[INDEX]","typeLabel":"object"},"description":"Inbound network throughput in bytes per second.","isRequired":true,"uniqueKey":"network.rx_bytes_per_sec","typeLabel":"object[]"},"tx_bytes_per_sec":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"network.tx_bytes_per_sec.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"network.tx_bytes_per_sec.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"network.tx_bytes_per_sec.items.[INDEX]","typeLabel":"object"},"description":"Outbound network throughput in bytes per second.","isRequired":true,"uniqueKey":"network.tx_bytes_per_sec","typeLabel":"object[]"},"rx_packets_per_sec":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"network.rx_packets_per_sec.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"network.rx_packets_per_sec.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"network.rx_packets_per_sec.items.[INDEX]","typeLabel":"object"},"description":"Inbound packets per second. Packet rate (vs. byte rate) better reflects per-tick networking pressure for multiplayer servers sending many small updates.","uniqueKey":"network.rx_packets_per_sec","typeLabel":"object[]"},"tx_packets_per_sec":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"network.tx_packets_per_sec.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"network.tx_packets_per_sec.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"network.tx_packets_per_sec.items.[INDEX]","typeLabel":"object"},"description":"Outbound packets per second.","uniqueKey":"network.tx_packets_per_sec","typeLabel":"object[]"},"rx_dropped_per_sec":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"network.rx_dropped_per_sec.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"network.rx_dropped_per_sec.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"network.rx_dropped_per_sec.items.[INDEX]","typeLabel":"object"},"description":"Inbound packets DROPPED per second. Sustained drops mean the server can't keep up with incoming traffic — a direct network cause of stalls/rubber-banding.","uniqueKey":"network.rx_dropped_per_sec","typeLabel":"object[]"},"tx_dropped_per_sec":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"network.tx_dropped_per_sec.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"network.tx_dropped_per_sec.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"network.tx_dropped_per_sec.items.[INDEX]","typeLabel":"object"},"description":"Outbound packets dropped per second.","uniqueKey":"network.tx_dropped_per_sec","typeLabel":"object[]"},"rx_errors_per_sec":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"network.rx_errors_per_sec.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"network.rx_errors_per_sec.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"network.rx_errors_per_sec.items.[INDEX]","typeLabel":"object"},"description":"Inbound packet errors per second (malformed/failed frames). Elevated errors point at a link or driver problem rather than application load.","uniqueKey":"network.rx_errors_per_sec","typeLabel":"object[]"},"tx_errors_per_sec":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"network.tx_errors_per_sec.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"network.tx_errors_per_sec.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"network.tx_errors_per_sec.items.[INDEX]","typeLabel":"object"},"description":"Outbound packet errors per second.","uniqueKey":"network.tx_errors_per_sec","typeLabel":"object[]"}},"required":["rx_bytes_per_sec","tx_bytes_per_sec"],"description":"Network I/O metrics (bytes, packets, and — for freeze diagnosis — dropped/error rates).","isRequired":true,"uniqueKey":"network","typeLabel":"object"},"load":{"type":"object","properties":{"average_1m":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"load.average_1m.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"load.average_1m.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"load.average_1m.items.[INDEX]","typeLabel":"object"},"description":"1-minute load average over time. Values above the CPU count indicate the machine is overloaded.","isRequired":true,"uniqueKey":"load.average_1m","typeLabel":"object[]"},"average_5m":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"load.average_5m.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"load.average_5m.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"load.average_5m.items.[INDEX]","typeLabel":"object"},"description":"5-minute load average. Sustained load above the CPU count (more than a brief 1m spike) indicates a persistent overload likely to cause freezing.","uniqueKey":"load.average_5m","typeLabel":"object[]"},"average_15m":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"load.average_15m.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"load.average_15m.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"load.average_15m.items.[INDEX]","typeLabel":"object"},"description":"15-minute load average, for spotting slow-building saturation trends.","uniqueKey":"load.average_15m","typeLabel":"object[]"}},"required":["average_1m"],"description":"System load average metrics over 1/5/15-minute windows.","isRequired":true,"uniqueKey":"load","typeLabel":"object"},"connections":{"type":"object","properties":{"tcp":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number","description":"Unix timestamp (seconds since epoch) for this data point.","isRequired":true,"uniqueKey":"connections.tcp.items.[INDEX].t","typeLabel":"number"},"v":{"type":"number","description":"Metric value at this timestamp. Units depend on the metric: percent for CPU, megabytes for memory, bytes/sec for network, count for connections.","isRequired":true,"uniqueKey":"connections.tcp.items.[INDEX].v","typeLabel":"number"}},"required":["t","v"],"description":"A single time-series data point (timestamp + value).","uniqueKey":"connections.tcp.items.[INDEX]","typeLabel":"object"},"description":"Number of active TCP connections over time.","isRequired":true,"uniqueKey":"connections.tcp","typeLabel":"object[]"}},"required":["tcp"],"description":"Network connection metrics.","isRequired":true,"uniqueKey":"connections","typeLabel":"object"}},"required":["instance_id","machine_id","region","compute_size","vcpus","lifecycle","period","cpu","memory","network","load","connections"],"description":"Server resource metrics including CPU, memory, network, load, and connections over a configurable time window.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"instance_id":"\u003cstring>","machine_id":"\u003cstring>","region":"\u003cstring>","compute_size":"\u003cstring>","vcpus":123,"lifecycle":{"started_at":"\u003cstring>","stopped_at":"\u003cstring>","shutdown_reason":"\u003cstring>"},"period":{"start":123,"end":123,"step":"\u003cstring>"},"cpu":{"usage_percent":[{"t":123,"v":123}],"iowait_percent":[{"t":123,"v":123}],"steal_percent":[{"t":123,"v":123}]},"memory":{"used_mb":[{"t":123,"v":123}],"total_mb":123},"network":{"rx_bytes_per_sec":[{"t":123,"v":123}],"tx_bytes_per_sec":[{"t":123,"v":123}],"rx_packets_per_sec":[{"t":123,"v":123}],"tx_packets_per_sec":[{"t":123,"v":123}],"rx_dropped_per_sec":[{"t":123,"v":123}],"tx_dropped_per_sec":[{"t":123,"v":123}],"rx_errors_per_sec":[{"t":123,"v":123}],"tx_errors_per_sec":[{"t":123,"v":123}]},"load":{"average_1m":[{"t":123,"v":123}],"average_5m":[{"t":123,"v":123}],"average_15m":[{"t":123,"v":123}]},"connections":{"tcp":[{"t":123,"v":123}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"beec4759-29e5-4ae6-8e11-5c7e6703ec40":{"description":"Server not found or no machine assigned.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable error message describing what went wrong.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"type":"number","description":"HTTP status code (matches the response status code).","isRequired":true,"uniqueKey":"status","typeLabel":"number"},"detail":{"type":"string","description":"Additional error context. May contain the same text as error or more specific technical details.","uniqueKey":"detail","typeLabel":"string"}},"required":["error","status"],"description":"Standard error response returned by all API endpoints on failure.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","status":123,"detail":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0648c24c-6553-4c47-aec3-e48fcddd9e9d":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-key","scopes":[]}}},"servers":{"10dc6c24-ec8f-48c6-85d3-b4e04b596923":{"url":"https://api.computeflow.cloud"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"api-key","scopes":[]},"schema":{"title":"api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"https://api.computeflow.cloud/api/doc"},"subdomain":"playflow","siteName":"Documentation - PlayFlow Cloud","title":"PlayFlow Cloud Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-13T17:20:49.397Z","originalFileLocation":"api-reference/servers/get-server-resource-metrics.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns CPU, memory, network, load, and connection metrics for a running server over a configurable time window. Each metric is a time series of {t, v} data points where t is a Unix timestamp and v is the metric value. Use period to control the time window (e.g., 1h for last hour) and step for data point resolution (e.g., 60s for one point per minute). Only available for servers that are currently running.\">\u003cmeta data-mint-head name=\"keywords\" content=\"PlayFlow, PlayFlow Cloud, game development, multiplayer, Unity, Unreal Engine, Godot, game servers, server hosting, matchmaking, lobbies, WebGL, game backend, documentation\">\u003cmeta data-mint-head name=\"application-name\" content=\"Documentation - PlayFlow Cloud\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/playflow/bdsieV7iirvG9AV3/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/playflow/bdsieV7iirvG9AV3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/playflow/bdsieV7iirvG9AV3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/playflow/bdsieV7iirvG9AV3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/playflow/bdsieV7iirvG9AV3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/playflow/bdsieV7iirvG9AV3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/playflow/bdsieV7iirvG9AV3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/playflow/bdsieV7iirvG9AV3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/playflow/bdsieV7iirvG9AV3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"PlayFlow Cloud Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Official documentation for PlayFlow Cloud. Learn to build, deploy, and scale multiplayer games with our tools for server hosting, matchmaking, and lobbies.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PlayFlow Cloud\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.playflowcloud.com/api-reference/servers/get-server-resource-metrics\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://playflow.mintlify.app/_mintlify/api/og/v2?division=Servers\u0026amp;title=Get+server+resource+metrics\u0026amp;description=Returns+CPU%2C+memory%2C+network%2C+load%2C+and+connection+metrics+for+a+running+server+over+a+configurable+time+window.+Each+metric+is+a+time+series+of+%60%7Bt%2C+v%7D%60+data+p\u0026amp;theme=efdcb79398ff0a4a395f8bf0\u0026amp;signature=24c80445329bb41f95e4c415dc4378ff6c5e628e34ffe109b9756c263fd6aa0b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"PlayFlow Cloud Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Official documentation for PlayFlow Cloud. Learn to build, deploy, and scale multiplayer games with our tools for server hosting, matchmaking, and lobbies.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://playflow.mintlify.app/_mintlify/api/og/v2?division=Servers\u0026amp;title=Get+server+resource+metrics\u0026amp;description=Returns+CPU%2C+memory%2C+network%2C+load%2C+and+connection+metrics+for+a+running+server+over+a+configurable+time+window.+Each+metric+is+a+time+series+of+%60%7Bt%2C+v%7D%60+data+p\u0026amp;theme=efdcb79398ff0a4a395f8bf0\u0026amp;signature=24c80445329bb41f95e4c415dc4378ff6c5e628e34ffe109b9756c263fd6aa0b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/playflow/bdsieV7iirvG9AV3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Documentation - PlayFlow Cloud\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"author\" content=\"PlayFlow Cloud\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003cmeta data-mint-head name=\"copyright\" content=\"Copyright 2025 PlayFlow Cloud\">\u003cmeta data-mint-head name=\"distribution\" content=\"global\">\u003cmeta data-mint-head name=\"coverage\" content=\"Worldwide\">\u003cmeta data-mint-head name=\"category\" content=\"Game Development\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@PlayFlowCloud\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.playflowcloud.com/api-reference/servers/get-server-resource-metrics\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/servers/get-server-resource-metrics.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.playflowcloud.com/#organization\",\"name\":\"Documentation - PlayFlow Cloud\",\"url\":\"https://docs.playflowcloud.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/playflow/eqeqAmqAMsOYKFZn/logo/svgs/3.svg?fit=max\u0026auto=format\u0026n=eqeqAmqAMsOYKFZn\u0026q=85\u0026s=ec6b551d72d9a0550eceaf8372781505\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.playflowcloud.com#website\",\"name\":\"Documentation - PlayFlow Cloud\",\"url\":\"https://docs.playflowcloud.com\",\"publisher\":{\"@id\":\"https://docs.playflowcloud.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.playflowcloud.com/api-reference/servers/get-server-resource-metrics#webpage\",\"url\":\"https://docs.playflowcloud.com/api-reference/servers/get-server-resource-metrics\",\"name\":\"Get server resource metrics\",\"description\":\"Returns CPU, memory, network, load, and connection metrics for a running server over a configurable time window. Each metric is a time series of {t, v} data points where t is a Unix timestamp and v is the metric value. Use period to control the time window (e.g., 1h for last hour) and step for data point resolution (e.g., 60s for one point per minute). Only available for servers that are currently running.\",\"dateModified\":\"2026-07-13T17:20:49.397Z\",\"isPartOf\":{\"@id\":\"https://docs.playflowcloud.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.playflowcloud.com/api-reference/servers/get-server-resource-metrics#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.playflowcloud.com/api-reference/servers/get-server-resource-metrics#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.playflowcloud.com/api-reference/servers/get-the-authoritative-match-roster\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Servers\",\"item\":\"https://docs.playflowcloud.com/api-reference/servers/get-the-authoritative-match-roster\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get server resource metrics\",\"item\":\"https://docs.playflowcloud.com/api-reference/servers/get-server-resource-metrics\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.playflowcloud.com/api-reference/servers/get-server-resource-metrics#apireference\",\"headline\":\"Get server resource metrics\",\"name\":\"Get server resource metrics\",\"description\":\"Returns CPU, memory, network, load, and connection metrics for a running server over a configurable time window. Each metric is a time series of {t, v} data points where t is a Unix timestamp and v is the metric value. Use period to control the time window (e.g., 1h for last hour) and step for data point resolution (e.g., 60s for one point per minute). Only available for servers that are currently running.\",\"url\":\"https://docs.playflowcloud.com/api-reference/servers/get-server-resource-metrics\",\"mainEntityOfPage\":{\"@id\":\"https://docs.playflowcloud.com/api-reference/servers/get-server-resource-metrics#webpage\"},\"dateModified\":\"2026-07-13T17:20:49.397Z\",\"publisher\":{\"@id\":\"https://docs.playflowcloud.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.playflowcloud.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Documentation - PlayFlow Cloud\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Documentation - PlayFlow Cloud","nav":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/P5w45Vx5Q8"},{"anchor":"Blog","icon":"newspaper","href":"https://playflowcloud.com/"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Overview","icon":"book-open","pages":[{"title":"API Introduction","icon":"book-open","href":"/api-reference/introduction"}]},{"group":"Endpoints","icon":"code","pages":[{"group":"Servers","pages":[{"title":"Get the authoritative match roster","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/servers/{instance_id}/roster","href":"/api-reference/servers/get-the-authoritative-match-roster"},{"title":"Override backfill state (server-authoritative)","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc patch /api/v3/servers/{instance_id}/backfill","href":"/api-reference/servers/override-backfill-state-server-authoritative"},{"title":"Close backfill (server-authoritative)","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/servers/{instance_id}/backfill/lock","href":"/api-reference/servers/close-backfill-server-authoritative"},{"title":"List servers","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/servers","href":"/api-reference/servers/list-servers"},{"title":"Start a new server","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/servers/start","href":"/api-reference/servers/start-a-new-server"},{"title":"Get server details","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/servers/{instance_id}","href":"/api-reference/servers/get-server-details"},{"title":"Stop a server","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc delete /api/v3/servers/{instance_id}","href":"/api-reference/servers/stop-a-server"},{"title":"Update server custom_data","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/servers/{instance_id}/update","href":"/api-reference/servers/update-server-custom_data"},{"title":"Restart a server","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/servers/{instance_id}/restart","href":"/api-reference/servers/restart-a-server"},{"title":"Get server runtime logs","description":"Retrieves runtime logs (stdout/stderr) from a game server, including timestamps, log levels, and region info.\n\n**Pagination:** Use the `next_token` from the response as `start_time` in the next request to fetch subsequent logs. Returns an empty logs array if the server has never launched.","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/servers/{instance_id}/logs","href":"/api-reference/servers/get-server-runtime-logs"},{"title":"Get server resource metrics","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/servers/{instance_id}/metrics","href":"/api-reference/servers/get-server-resource-metrics"},{"title":"Get server log-volume histogram","description":"Returns a stacked info/warn/error log-volume time-series for a single server over the same window as the logs. Use it to correlate a spike in error volume with a freeze: overlay these buckets on the CPU/memory/network charts on a shared time axis.\n\nBins are `step` seconds wide (default 60). Empty bins may be omitted — treat gaps as zero.","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/servers/{instance_id}/log-histogram","href":"/api-reference/servers/get-server-log-volume-histogram"}]},{"group":"Projects","pages":[{"title":"Get project-wide log-volume histogram","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/projects/log-histogram","href":"/api-reference/projects/get-project-wide-log-volume-histogram"},{"title":"Get project-wide server logs","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/projects/logs","href":"/api-reference/projects/get-project-wide-server-logs"},{"title":"Get project settings","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/projects/settings","href":"/api-reference/projects/get-project-settings"},{"title":"Update project settings","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/projects/settings","href":"/api-reference/projects/update-project-settings"}]},{"group":"Builds","pages":[{"title":"List builds","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/builds","href":"/api-reference/builds/list-builds"},{"title":"Get presigned upload URL","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/builds/upload-url","href":"/api-reference/builds/get-presigned-upload-url"},{"title":"Create build from Docker image","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/builds/docker-image","href":"/api-reference/builds/create-build-from-docker-image"},{"title":"Get build details","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/builds/{build_id}","href":"/api-reference/builds/get-build-details"},{"title":"Delete a build","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc delete /api/v3/builds/{build_id}","href":"/api-reference/builds/delete-a-build"},{"title":"Get build processing logs","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/builds/{build_id}/logs","href":"/api-reference/builds/get-build-processing-logs"}]},{"group":"Lobbies","pages":[{"title":"Browse lobbies","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/lobbies/{config}","href":"/api-reference/lobbies/browse-lobbies"},{"title":"Create a lobby","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/lobbies/{config}","href":"/api-reference/lobbies/create-a-lobby"},{"title":"Join a lobby","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/lobbies/{config}/join","href":"/api-reference/lobbies/join-a-lobby"},{"title":"Get my lobby","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/lobbies/{config}/me","href":"/api-reference/lobbies/get-my-lobby"},{"title":"Leave a lobby","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc delete /api/v3/lobbies/{config}/me","href":"/api-reference/lobbies/leave-a-lobby"},{"title":"Update my player state","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc patch /api/v3/lobbies/{config}/me","href":"/api-reference/lobbies/update-my-player-state"},{"title":"Update lobby settings","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc patch /api/v3/lobbies/{config}/me/settings","href":"/api-reference/lobbies/update-lobby-settings"},{"title":"Kick a player","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc delete /api/v3/lobbies/{config}/me/players/{playerId}","href":"/api-reference/lobbies/kick-a-player"},{"title":"Start the game","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/lobbies/{config}/me/start","href":"/api-reference/lobbies/start-the-game"},{"title":"Start matchmaking","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/lobbies/{config}/me/matchmaking","href":"/api-reference/lobbies/start-matchmaking"},{"title":"Cancel matchmaking","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc delete /api/v3/lobbies/{config}/me/matchmaking","href":"/api-reference/lobbies/cancel-matchmaking"},{"title":"End the current match","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/lobbies/{config}/me/end-match","href":"/api-reference/lobbies/end-the-current-match"},{"title":"Confirm a found match","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/lobbies/{config}/me/confirm-match","href":"/api-reference/lobbies/confirm-a-found-match"},{"title":"Decline a found match","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc delete /api/v3/lobbies/{config}/me/confirm-match","href":"/api-reference/lobbies/decline-a-found-match"},{"title":"Send a player heartbeat","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc post /api/v3/lobbies/{config}/me/heartbeat","href":"/api-reference/lobbies/send-a-player-heartbeat"},{"title":"Subscribe to lobby events (SSE)","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/lobbies/{config}/me/events","href":"/api-reference/lobbies/subscribe-to-lobby-events-sse"},{"title":"Get lobby by ID","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc get /api/v3/lobbies/{config}/{id}","href":"/api-reference/lobbies/get-lobby-by-id"},{"title":"Delete a lobby by ID (admin)","deprecated":null,"version":null,"openapi":"https://api.computeflow.cloud/api/doc delete /api/v3/lobbies/{config}/{id}","href":"/api-reference/lobbies/delete-a-lobby-by-id-admin"}]}]}]}]},"title":"PlayFlow Cloud Documentation","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}