AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

atlas api performanceAdvisor listSlowQueryLogs

Performance AdvisorとQuery Profilerが特定した低速クエリのログ行を返します。

atlas api サブコマンドはMongoDB Atlas Admin APIから自動的に生成され、Admin APIの完全なカバレッジを提供します。管理API機能には独自のリリース ライフサイクルがあり、提供されているAPIエンドポイントとなる接続されたデバイスのドキュメント リンクから確認できます。

Performance Advisor はMongoDBが遅いと判断したクエリをモニターし、クエリ パフォーマンスを改善するための新しいインデックスを提案します。MongoDB Cloud では、クラスターでの平均操作時間に基づいて低速クエリのしきい値が決定されます。これにより、ワークロードに適した推奨が可能になります。このリソースを使用するには、リクエスト元の サービス アカウント またはAPIキーにプロジェクト データ アクセス ロールまたは プロジェクト Observable ビューア ロールが必要です。

このコマンドは自動生成され、Atlas APIエンドポイント https://www.mongodb.com/ja-jp/docs/api/doc/atlas-admin-api-v2/操作/操作-listgroupprocessperformanceadvisorslowquerylogs. に 1:1 で対応しています。

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

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

--duration

整数

false

クラスター内の管理対象名前空間内で、クエリが低速クエリと判断されるまでの時間の長さ。このパラメータは、その値をミリ秒単位で表します。

  • sinceパラメーターを指定しない場合、エンドポイントは現在の時刻より前の期間に該当するデータを返します。

  • durationパラメーターもsinceパラメーターも指定しない場合、エンドポイントは過去 24 時間のデータを返します。

-- envelope

envelope

false

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

--groupId

string

true

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

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

-h, --help

false

listSlowQueryLogs のヘルプ

--includeMetrics

false

低速クエリログから抽出されたメトリクスを別のフィールドとして含めるかどうか。

--includeOpType

false

低速クエリログから抽出された操作タイプ(読み取り/書込み/コマンド)を別のフィールドとして含めるかどうか。

--includeReplicaState

false

低速クエリログが別のフィールドとして生成されたときのホストのレプリカ状態を含めるかどうか。

--nLogs

整数

false

ログから返される最大行数。

--namespaces

.

false

低速クエリを取得する名前空間。名前空間は 1 件のデータベースと 1 件のコレクションリソースで構成され、.: <database>.<collection> と記述されます。複数の名前空間を含めるには、各名前空間の間をアンパサンド (&) で区切って、パラメーターを複数回渡します。このパラメーターを省略すると、すべての名前空間の結果が返されます。

-o, --output

string

false

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

-- outputFile

string

false

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

--pretty

false

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

--processId

mongod

true

MongoDBプロセスを提供するホストとポートの組み合わせ。ホストはMongoDBプロセス(mongodまたは mongos)を実行するホストのホスト名、FQDN、IPv4 アドレス、または IPv6 アドレスである必要があります。ポートはMongoDBプロセスがリクエストをリッスンする IANA ポートである必要があります。

--since

整数

false

クエリが低速クエリを検索する日時。このパラメーターは、[UNIX エポック]( https://en.wiki.org/wiki/Unix_time )から経過したミリ秒数で値を表します。

  • durationパラメーターを指定しない場合、エンドポイントはsince値から現在の時刻までのデータを返します。

  • durationパラメーターもsinceパラメーターも指定しない場合、エンドポイントは過去 24 時間のデータを返します。

--version

string

false

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

名前
タイプ
必須
説明

-P, --profile

string

false

構成ファイルから使用するプロファイルの名前。Atlas CLI のプロファイルの詳細については、 https://docub.mongodb.org/core/atlas-cli-save- connection-settings を参照してください。

atlas api performanceAdvisor listSlowQueryLogs --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId [processId]