Join us Sept 17 at .local NYC! Use code WEB50 to save 50% on tickets. Learn more >
MongoDB Event
Docs Menu
Docs Home
/ /
Atlas CLI
/ / / /

atlas api monitoringAndLogs getDatabaseMeasurements

パブリック プレビュー:フィードバックを提供してください : 指定されたプロジェクトの指定されたホストの 1 つのデータベースの測定値を返します。

パブリック プレビュー: MongoDB Atlas Admin APIから自動的に生成される Atlas APIサブコマンドは、Admin APIの完全なフィードバックを提供し、現在パブリック プレビュー段階です(フィードバック 930808-Atlas-cli )。管理API機能には独自のリリース ライフサイクルがあり、提供されているAPIエンドポイントのドキュメント リンクから確認できます。

MongoDB dbStats コマンド出力に基づいて、データベースのディスク上のストレージ容量を返します。何らかのメトリック系列を計算するために、Atlas は隣接する 2 つのポイントごとに のレートを取得します。これらのメトリック系列では、Atlas はクエリの時間範囲を指定して最初のデータ点のレートを計算できないため、最初のデータ点はNULL 値になります。Atlas は 20 分ごとにデータベースメトリクスを検索しますが、データベースのパフォーマンスを最適化するために必要に応じて頻度を減らします。このリソースを使用するには、リクエスト元のサービスアカウントまたはAPIキーにプロジェクトの読み取り専用ロールが必要です。

このコマンドは自動生成され、1:1 と Atlas APIエンドポイント https://www.mongodb.com/ja-jp/docs/api/doc/atlas-admin-api-v2/operation/operation-getdatabasemeasurements

詳細と例については、上記のリンクで参照されているAPIドキュメントを参照してください。

コマンド構文
atlas api monitoringAndLogs getDatabaseMeasurements [options]
名前
タイプ
必須
説明

--databaseName

string

true

指定された MongoDB プロセスが提供するデータベースを識別する、人間が判読可能なラベル。

--end

string

false

MongoDB Cloud がメトリクスのレポートを停止する日時。このパラメーターは、UTC の ISO 8601 タイムスタンプ形式で値を表します。period を設定しない場合は、このパラメーターを含めます。

-- envelope

envelope

false

アプリケーションが応答をエンベロープJSONオブジェクトでラップするかどうかを示すフラグ。一部のAPIクライアントは、 HTTPレスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで envelope=true を設定します。結果のリストを返すエンドポイントは、結果オブジェクトをエンベロープとして使用します。アプリケーションは、レスポンス本体にステータス パラメータを追加します。

--granularity

string

true

Atlas がメトリクスをレポートする間隔を指定する期間。このパラメーターは、UTC の ISO 8601 期間形式で値を表します。

--groupId

string

true

プロジェクトを識別する一意の 24 桁の 16 進数文字列。 [/groups](# tags/プロジェクト/操作/listProjects) エンドポイントを使用して、認証されたユーザーがアクセスできるすべてのプロジェクトを取得します。

: グループとプロジェクトは同義語です。そのため、グループ ID はプロジェクト ID と同じです。既存のグループの場合、グループ/プロジェクト ID は同じままです。リソースおよび対応するエンドポイントでは、グループという用語が使用されます。

-h, --help

false

getDatabasemeasurements のヘルプ

--m

m

false

このMongoDBプロセスにリクエスト1 つ以上の測定タイプ。省略すると、リソースはすべての測定値を返します。m に複数の値を指定するには、値ごとに m パラメーターを繰り返します。指定されたホストに適用する測定値を指定します。無効な測定値を指定した場合、 MongoDB Cloud はエラーを返します。

-o, --output

string

false

優先API形式 は、 ["JSON", go-template] にすることができます。この値のデフォルトは "JSON" です。

-- outputFile

string

false

API 出力を書き込むファイル。このフラグは、エンドポイントの出力がバイナリ(例: gzip)で、コマンドがパイプライン化されていない場合(例: Atlas コマンド >out.zip)に必要です。

--period

string

false

Atlas がメトリクスをレポートする期間。このパラメーターは、UTC の ISO 8601 期間形式で値を表します。startend を設定しない場合は、このパラメーターを含めます。

--pretty

false

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

--processId

mongod

true

MongoDBプロセスを提供するホスト名と IANA(Internet Assigned Numbers Authority、インターネット番号割当機関)ポートの組み合わせ。ホストはMongoDBプロセス(mongodまたは mongos)を実行するホストのホスト名、完全修飾ドメイン名(FQDN)、またはインターネット プロトコル アドレス(IPv4 または IPv6)である必要があります。ポートはMongoDBプロセスがリクエストをリッスンする IANA ポートである必要があります。

--start

string

false

MongoDB Cloud がメトリクスのレポートを開始する日時。このパラメーターは、UTC の ISO 8601 タイムスタンプ形式で値を表します。period を設定しない場合は、このパラメーターを含めます。

--version

string

false

API 呼び出し [options: "2023-01-01"] を呼び出すときに使用する API バージョンは、最新バージョンにデフォルト設定されているか、設定されている場合は api_version 構成値 をプロファイルします。この値のデフォルトは "2023-01-01"

名前
タイプ
必須
説明

-P, --profile

string

false

atlas api monitoringAndLogs getDatabaseMeasurements --version 2023-01-01 --databaseName [databaseName] --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --period PT10H --processId mongodb.example.com:27017

項目一覧