構成

構成ファイル

ほとんどのmongosyncコマンドライン オプションを YAML ファイルに書込み (write) できます。 構成ファイルでは、YAML 形式を使用して各設定の値を指定します。

以下に例を挙げます。

cluster0: "mongodb://192.0.2.10:27017"
cluster1: "mongodb://192.0.2.20:27017"
logPath: "/var/log/mongosync"
verbosity: "WARN"

構成ファイルを使用するには、 --configオプションを使用してmongosyncを起動し、ファイルへのパスを設定します。

$ mongosync --config mongosync.conf

オプション

acceptDisclaimer

タイプ : ブール値

埋め込み検証演算子と、 ベータを使用する場合は、mongosync ベータ機能に弁別子を受け入れます。

この設定なしで mongosync プロセスが開始されると、ユーザーは各ディスククレームを受け入れるように求められます。

この設定により、すでにディスク クレームを読み取って承認したユーザーは、ディスク クレームを受け入れ、mongosync プロセスを開始できます。

コマンドラインからacceptDisclaimer設定を行うには、 --acceptDisclaimerオプションを参照してください。

バージョン 1.9 の新機能。

cluster0

型: string

最初のクラスターの接続 URIを設定します。 最初のクラスターは、同期プロセスのソースまたは宛先として機能できます。 start API エンドポイントの呼び出しでソースクラスターと宛先クラスターを指定します。

mongosync の接続の詳細については、「 接続」を参照してください。

コマンドラインからcluster0設定を行うには、 --cluster0オプションを参照してください。

cluster1

型: string

2 番目のクラスターの接続 URI を設定します。2 番目のクラスターは、同期プロセスのソースまたは宛先のいずれかとして機能します。start API エンドポイントの呼び出しでソースクラスターと宛先クラスターを指定します。

mongosync の接続の詳細については、「 接続」を参照してください。

コマンドラインからcluster1設定を行うには、 --cluster1オプションを参照してください。

disableTelemetry

タイプ: ブール値

バージョン 1.4.0 の新機能。

mongosync の テレメトリー データの収集を無効にします。

デフォルトでは、mongosync　MongoDB 製品を改善するために匿名の集約された使用状況データを収集します。mongosync を実行すると、このテレメトリー データのコレクションを無効にできます。

コマンドラインからdisableTelemetry設定を行うには、 --disableTelemetryオプションを参照してください。

詳しくは、「 ユーザー データの収集」を参照してください。

id

型: string

mongosync インスタンスの識別子を設定します。

シャーディングされたクラスターでmongosyncの複数のインスタンスを実行中の場合は、この設定を使用して、シャードを個別に同期します。

この設定の識別子の値は、同期するシャードのシャード ID に対応していなければなりません。 シャード ID を見つけるには、 listShardsコマンドを使用します。

コマンドラインからid設定を行うには、 --idオプションを参照してください。

loadLevel

タイプ: 整数

デフォルト: 3

ソースクラスターと宛先クラスター間でデータを同期するためのクラスターワークロードレベルを設定します。

• 4これは最上位の設定で、クラスターのワークロードが最大化され、データが最速で同期されます。

• 1これは最下位の設定で、クラスタのワークロードが最小限に抑えられ、データの同期は最も遅くなります。

コマンドラインからloadLevel設定を行うには、 --loadLevelオプションを参照してください。

警告

loadLevel をデフォルトの 3 よりも高く設定すると、宛先クラスターのパフォーマンスに悪影響を及ぼす可能性があります。

ソースクラスターに読み取りボトルネックが存在する場合、または宛先クラスターに書込みボトルネックが存在する場合、loadLevel を減らすとパフォーマンスが向上する可能性があります。

バージョン 1.4 で追加。

logPath

型: string

ログディレクトリへのパスを設定します。Cluster-to-Cluster Sync は、このディレクトリ内のファイルにログを書き込みます。

詳しくは、「ログ記録」を参照してください。

コマンドラインからlogPath設定を行うには、 --logPathオプションを参照してください。

migrationName

型: string

重要

Cluster-to-Cluster Sync betaプログラム

この機能は mongosync betaでのみ使用できます。 詳しくは、「 Cluster-to-Cluster Sync betaプログラム 」を参照してください。

mongosync-beta 1.8以降、 は同期操作の移行名を設定します。 たとえば、移行名を設定して、複数のソースクラスターから 1 つの宛先クラスターへの各同期操作を識別できます。

migrationName string には、最大44個の英数字とアンダースコアの文字を含めることができます。 移行メタデータデータベース名を設定するために、string "mongosync_internal_"にmigrationNameが追加されます。

たとえば、 migrationNameを"cluster_27000_to_cluster_35000_sync"に設定すると、結果のmongosyncメタデータ データベース名は"mongosync_internal_cluster_27000_to_cluster_35000_sync"になります。

完全な例については、「多対 1 の移行」または 「 A->B->C の移行 」を参照してください。

コマンドラインからmigrationName設定を行うには、 --migrationNameオプションを参照してください。

port

タイプ: 整数

デフォルト: 27182

Cluster-to-Cluster Sync HTTP API の HTTP サーバーが使用するポートを設定します。

コマンドラインからport設定を行うには、 --portオプションを参照してください。

verbosity

型: string

デフォルト: DEBUG

ログ メッセージの冗長性レベルを設定します。Cluster-to-Cluster Syncでは、指定されたレベルのすべてのメッセージと、それより低いレベルのすべてのメッセージがログに記録されます。

verbosity設定では次の値がサポートされています。

• TRACE

• DEBUG

• INFO

• WARN

• ERROR

• FATAL

• PANIC

コマンドラインからverbosity設定を行うには、 --verbosityオプションを参照してください。