> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取实例监控数据

## 请求头

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
</ParamField>

## 查询参数

<ParamField query="instanceId" type="string" required={true}>
  实例 ID。
</ParamField>

<ParamField query="startTime" type="integer" required={false}>
  查询监控数据起始时间，取值范围：(0, endTime - 60]，默认值：当前时间戳 - 60。
</ParamField>

<ParamField query="endTime" type="integer" required={false}>
  查询监控数据结束时间，取值范围：(0, 当前时间戳]，默认值：当前时间戳。
</ParamField>

<ParamField query="interval" type="integer" required={false}>
  查询监控数据时间粒度，单位(s)，取值范围：> 15，默认值：15。

  注意：endTime、startTime、interval 传参不符合要求会重置为默认值。获取实时的监控数据可能有一分钟左右延迟。
</ParamField>

## 响应参数

<ResponseField name="cpuUtilization" type="array" required={true}>
  CPU 使用率数据。

  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="timestamp" type="string" required={true}>
      时间戳。
    </ResponseField>

    <ResponseField name="value" type="number" required={true}>
      CPU 使用率。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="memUtilization" type="array" required={true}>
  内存使用率数据。

  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="timestamp" type="string" required={true}>
      时间戳。
    </ResponseField>

    <ResponseField name="value" type="number" required={true}>
      内存使用率。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="rootDiskUtilization" type="array" required={true}>
  系统盘使用率数据。

  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="timestamp" type="string" required={true}>
      时间戳。
    </ResponseField>

    <ResponseField name="value" type="number" required={true}>
      系统盘使用率。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="gpuUtilization" type="object" required={true}>
  GPU 使用率数据。

  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="avg" type="array" required={true}>
      所有 GPU 平均使用率。

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="timestamp" type="string" required={true}>
          时间戳。
        </ResponseField>

        <ResponseField name="value" type="number" required={true}>
          使用率。
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="gpuIds" type="array" required={true}>
      每个 GPU 使用率。

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="gpuId" type="string" required={true}>
          实际使用的 GPU 编号。
        </ResponseField>

        <ResponseField name="items" type="array" required={true}>
          GPU 使用率数据。

          <Expandable title="properties" defaultOpen={false}>
            <ResponseField name="timestamp" type="string" required={true}>
              时间戳。
            </ResponseField>

            <ResponseField name="value" type="number" required={true}>
              使用率。
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="gpuMemUtilization" type="object" required={true}>
  GPU 显存使用率数据。

  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="avg" type="array" required={true}>
      所有 GPU 显存平均使用率。

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="timestamp" type="string" required={true}>
          时间戳。
        </ResponseField>

        <ResponseField name="value" type="number" required={true}>
          使用率。
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="gpuIds" type="array" required={true}>
      每个 GPU 显存使用率。

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="gpuId" type="string" required={true}>
          实际使用的 GPU 编号。
        </ResponseField>

        <ResponseField name="items" type="array" required={true}>
          GPU 显存使用率数据。

          <Expandable title="properties" defaultOpen={false}>
            <ResponseField name="timestamp" type="string" required={true}>
              时间戳。
            </ResponseField>

            <ResponseField name="value" type="number" required={true}>
              使用率。
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>
