/ /

/ /

測定タイプを取得する

大きなドキュメントを返さずに特定の測定に適用される測定タイプを取得するには、 granularityとperiodの両方に対してPT5Mの値を指定して、次の GETコマンドを発行します。これにより、各測定値に対して 1 つのデータポイントのみを含むドキュメントが返されます。

ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

Resource

GET /groups/{PROJECT-ID}/hosts/{HOST-ID}/measurements

リクエストパスパラメーター

名前	タイプ	説明
プロジェクトID	string	ホストを所有するプロジェクトの一意の識別子。
ホスト ID	string	MongoDB プロセスを提供するホストの一意の識別子です。

リクエストクエリパラメータ

一意のクエリパラメーター

このエンドポイントは、返された測定値をフィルタリングするために次のクエリパラメーターを受け入れます。

名前

タイプ

説明

granularity

Required

string

測定データポイント間の間隔を指定する ISO 8601 表記の期間。

測定の粒度は、次の表記を使用して、日数、時間、分、秒、ミリ秒として表できます。

P （期間）、その後は次の結果が続きます。

D 日間（必要な場合）
T 期間（日後）
H 時間時間
M のために
S 秒

以下に例を挙げます。

表記	duration
`PT30S`	30 秒
`P1T12H`	1日、12時間
`PT0.5S`	500 ミリ秒

period

string

過去の測定値を取得する方法を指定する ISO 表記の期間。8601

たとえば、過去の36時間をリクエストするには、次のクエリパラメータを含めます: period=P1DT12H 。

始める

string

測定値を取得する期間の開始の、ISO8601 日付と時刻形式のタイムスタンプ（ UTC）。start を指定する場合は、end も指定する必要があります。

end

string

測定値を取得する期間の終了の ISO 日付と時刻形式のタイムスタンプ（UTC）。8601end を指定する場合は、start も指定する必要があります。

string

返す測定値。 mが指定されていない場合は、すべての測定値が返されます。

mに複数の値を指定するには、 mパラメータを繰り返す必要があります。

以下に例を挙げます。

../measurements?m=CONNECTIONS&m=OPCOUNTER_CMD&m=OPCOUNTER_QUERY

ホストに対して有効な測定値を指定する必要があります。 MongoDB Ops Manager は、指定された測定値が無効な場合はエラーを返します。利用可能な測定値については、「測定タイプ」を参照してください。

注意

各測定リクエストには、 periodクエリパラメータまたはstartクエリパラメータとendクエリパラメータの両方を含める必要があります。

一般的なクエリパラメーター

このエンドポイントは、単一の応答を返すすべてのエンドポイントに共通のクエリパラメーターも受け入れます。

名前

タイプ

説明

default

pageNum

integer

ページ番号（1 インデックスベース）。

1

itemsPerPage

integer

1 ページあたりに返す項目の数は最大 500 です。

100

pretty

ブール値

レスポンス本体を pretty-print 形式にするかどうかを示します。

false

envelope

ブール値

応答をエンベロープでラップするかどうかを示します。

一部のAPIクライアントは、 HTTPレスポンスヘッダーまたはステータスコードにアクセスできません。これを修正するには、クエリで"envelope" : trueを設定します。

1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。

状態	HTTPレスポンスコード
envelope	期待される応答本体

結果のリストを返すエンドポイントの場合、 resultsオブジェクトはエンベロープです。 MongoDB Ops Manager は、レスポンス本体にstatusフィールドを追加します。

なし

リクエストボディパラメータ

このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。

応答

名前	タイプ	説明
databaseName	string	測定が適用されるデータベース。データベース測定を取得するためにのみ入力されます。
end	string	返された測定値がカバーする期間の終了の ISO 8601 の日付と時刻形式のタイムスタンプ（UTC）。
粒度	string	各データ点がカバーする間隔のサイズを指定する ISO 表記の期間。8601 たとえば、 `PT5M`は5分の粒度を指定します。
グループ ID	string	ホストを所有するプロジェクトの一意の識別子。
hostId	string	測定値が含まれるホストの一意の識別子。
測定値	オブジェクト配列	この配列内の各オブジェクトは、測定値とその測定値のデータポイントを表します。
operations.dataPoints	オブジェクト配列	各オブジェクトは 1 つのデータポイントを表します。特定の時点で利用可能なデータポイントがない場合、この`value`は`null`に設定されます。
operations.dataPoints.timestamp	string	このデータ点が表す時間間隔の開始の ISO8601 日付と時刻形式（UTC）のタイムスタンプ。
operations.dataPoints.value	float	このデータポイントの値。
operations.name	string	測定値の名前。許容値は [測定タイプ]ページに記載されています。
operations.units	string	この測定値がどのように定量化されるか。指定できる単位は以下のとおりです。 `PERCENT` `MILLISECONDS` `BYTES` `GIGABYTES` `BYTES_PER_SECOND` `MEGABYTES_PER_SECOND` `GIGABYTES_PER_HOUR` `SCALAR_PER_SECOND` `SCALAR`
partitionName	string	MongoDB プロセスデータベースを保存するディスクパーティションの名前。ディスクパーティション測定の取得にのみ入力されます。
processId	string	MongoDB プロセスのFQDNとポート。
始める	string	返された測定値がカバーする期間の開始の ISO の日付と時刻形式のタイムスタンプ（UTC）。8601

リクエストの例

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
 --header "Accept: application/json" \
 --include \
 --request GET "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/measurements?granularity=PT5M&period=PT5M"

応答例

応答ヘッダー

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

レスポンス本体

{
  "end": "2018-07-31T14:55:24Z",
  "granularity": "PT5M",
  "groupId": "{PROJECT-ID}",
  "hostId": "{HOST-ID}",
  "links": [
  ],
  "measurements": [
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": 0
        }
      ],
      "name": "CONNECTIONS",
      "units": "SCALAR"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "NETWORK_BYTES_IN",
      "units": "BYTES_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "NETWORK_BYTES_OUT",
      "units": "BYTES_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "NETWORK_NUM_REQUESTS",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "OPCOUNTER_CMD",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "OPCOUNTER_QUERY",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "OPCOUNTER_UPDATE",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "OPCOUNTER_DELETE",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "OPCOUNTER_GETMORE",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "OPCOUNTER_INSERT",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": 0
        }
      ],
      "name": "LOGICAL_SIZE",
      "units": "BYTES"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_CPU_USER",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_CPU_KERNEL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_CPU_CHILDREN_USER",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_CPU_CHILDREN_KERNEL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_NORMALIZED_CPU_USER",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_NORMALIZED_CPU_KERNEL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_NORMALIZED_CPU_CHILDREN_USER",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_NORMALIZED_CPU_CHILDREN_KERNEL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_USER",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_KERNEL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_NICE",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_IOWAIT",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_IRQ",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_SOFTIRQ",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_GUEST",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_STEAL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_USER",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_KERNEL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_NICE",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_IOWAIT",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_IRQ",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_SOFTIRQ",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_GUEST",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_STEAL",
      "units": "PERCENT"
    }
  ],
  "processId": "{MONGODB-PROCESS-FQDN}:{PORT}",
  "start": "2018-07-31T14:55:24Z"
}

戻る

タイプ

アラート

Resource

リクエスト パス パラメーター

リクエスト クエリ パラメータ

一意のクエリ パラメーター

注意

一般的なクエリ パラメーター

リクエスト ボディ パラメータ

応答

リクエストの例

応答例

応答ヘッダー

レスポンス本体

リクエストパスパラメーター

リクエストクエリパラメータ

一意のクエリパラメーター

一般的なクエリパラメーター

リクエストボディパラメータ