/ /

mongotop の例

このページでは mongotopの例を示します。

mongo shell ではなく、システムコマンドラインから mongotop を実行します。

例

デフォルトでは、 mongotopはローカルホストポート27017で実行されている MongoDB インスタンスに接続します。ただし、 mongotopは任意でリモートmongodインスタンスに接続できます。詳細については、 mongotop オプションを参照してください。

mongotopが返す頻度を低くするには、コマンドの最後に数値（秒単位）を指定します。この例では、 mongotopは15秒ごとにを返します。

mongotop 15

このコマンドでは、次の出力が生成されます。

2019-04-29T15:35:27.785-0400 connected to: 127.0.0.1
                    ns    total    read    write    2019-04-29T15:35:57-04:00
    admin.system.roles      0ms     0ms      0ms
    admin.system.users      0ms     0ms      0ms
  admin.system.version      0ms     0ms      0ms
config.system.sessions      0ms     0ms      0ms
     local.startup_log      0ms     0ms      0ms
  local.system.replset      0ms     0ms      0ms

5分ごとにmongotopレポートを返すには、次のコマンドを使用します。

mongotop 300

AWS IAM 認証情報を使用して MongoDB Atlas クラスターに接続

バージョン 100.1.0 の新機能。

Amazon Web Services IAM 認証情報 connection stringによる認証をサポートするように構成されたMongoDBmongotop Atlasクラスターに接続するには、次のようなからを提供します。

mongotop 'mongodb+srv://<aws access key id>:<aws secret access key>@cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS' <other options>

AtlasAmazon Web Servicesこの方法で IAM 認証情報を使用してMONGODB-AWSauthentication mechanism $externalauthSourceに接続するには、この例に示すように、とが使用されます。

Amazon Web Servicesセッショントークンを使用する場合同様に、AWS_SESSION_TOKENauthMechanismProperties 値を次のとおり指定します。

mongotop 'mongodb+srv://<aws access key id>:<aws secret access key>@cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS&authMechanismProperties=AWS_SESSION_TOKEN:<aws session token>' <other options>

注意

AWS アクセスキー ID、シークレットアクセスキー、またはセッショントークンに次の文字が含まれている場合。

: / ? # [ ] @

これらの文字はパーセントエンコーディングを使用して変換する必要があります。

あるいは、次のように、、、 --usernameオプションを使用して、Amazon Web Services IDstring--passwordアクセスキー--awsSessionToken 、シークレットアクセスキー、およびオプションのセッショントークンをそれぞれ接続の外部で提供することもできます。

mongotop 'mongodb+srv://cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS' --username <aws access key id> --password <aws secret access key> --awsSessionToken <aws session token> <other options>

コマンドラインパラメーターとして指定する場合、これら 3 つのオプションにパーセントエンコーディングは必要ありません。

これらの認証情報は、標準のAmazon Web Services IAM 環境変数を使用してプラットフォーム上で設定することもできます。MONGODB-AWS authentication mechanism: を使用すると、mongotop は次の環境変数をチェックします。

AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
AWS_SESSION_TOKEN

設定されている場合、これらの認証情報を接続文字列や明示的なオプションで指定する必要はありません。

注意

Amazon Web Services の環境変数を使用してこれらの値を指定する場合、これらの認証情報に対応する明示的オプションまたは接続文字列オプションと混在させることはできません。アクセスキー ID とシークレットアクセスキー（および使用する場合はセッショントークンも）の環境変数を使用、または代わりに明示的オプションもしくは接続文字列オプションをそれぞれを指定します。

次の例では、bash shell でこれらの環境変数を設定しています。

export AWS_ACCESS_KEY_ID='<aws access key id>'
export AWS_SECRET_ACCESS_KEY='<aws secret access key>'
export AWS_SESSION_TOKEN='<aws session token>'

他の shell で環境変数を設定する構文は異なります。詳細については、ご使用のプラットフォームのドキュメントを参照してください。

次のコマンドで、これらの環境変数が設定されているかどうかを確認できます。

env | grep AWS

設定が完了すると、次の例では、これらの環境変数を使用して MongoDB Atlas クラスターに接続します。

mongotop 'mongodb+srv://cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS'  <other options>

詳細

戻る

動作

mongofiles